Metadata-Version: 2.4
Name: jobvetta
Version: 1.0.0
Summary: Official Python client for searching live, vetted India jobs with the Jobvetta API.
Project-URL: Homepage, https://www.jobvetta.com/
Project-URL: Documentation, https://www.jobvetta.com/api
Project-URL: MCP Server, https://www.jobvetta.com/mcp
Project-URL: Source, https://github.com/jobvetta/jobvetta-packages
Project-URL: Issues, https://github.com/jobvetta/jobvetta-packages/issues
Author-email: Jobvetta <support@jobvetta.com>
License-Expression: MIT
License-File: LICENSE
Keywords: api-client,india-jobs,job-search,jobs,mcp,model-context-protocol
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Jobvetta Python SDK

The official Python client for the [Jobvetta API](https://www.jobvetta.com/api).
Search live India jobs gathered from official employer career pages and retrieve
full structured job details. The client uses only the Python standard library.

## Install

```sh
python -m pip install jobvetta
```

## Use

```python
import os

from jobvetta import Jobvetta

client = Jobvetta(api_key=os.environ["JOBVETTA_API_KEY"])

results = client.search_jobs(
    q="react developer",
    location="Bengaluru",
    days=7,
    limit=10,
)

for job in results["jobs"]:
    print(f'{job["title"]} — {job["company"]}: {job["url"]}')

if results["jobs"]:
    detail = client.get_job(results["jobs"][0]["job_id"])
    print(detail.get("description"))
```

## Authentication and limits

Create a free API key in the [Jobvetta dashboard](https://www.jobvetta.com/dashboard#/mcp).
Each key includes 50 requests per UTC day, shared between the REST API and the
[hosted MCP server](https://www.jobvetta.com/mcp). Search returns at most 10
jobs per call and covers India only.

## API

### `Jobvetta(api_key, *, base_url=..., timeout=30)`

Creates an authenticated client. Keep the key server-side and do not commit it
to source control.

### `search_jobs(*, q=None, location=None, days=None, limit=None)`

- `q` — role, skill, or company keywords
- `location` — Indian city, town, or state
- `days` — jobs posted within 1–365 days
- `limit` — 1–10 results

### `get_job(job_id)`

Retrieves full details for a `job_id` returned by `search_jobs`.

Failed requests raise `JobvettaError`, which exposes `status` and the parsed
response `body` when available.

## License

MIT

