Jobvetta Python SDK

The official Python client for the Jobvetta 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

python -m pip install jobvetta

Use

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. Each key includes 50 requests per UTC day, shared between the REST API and the hosted MCP server. 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