Jobo for Python SDK
Live job data in Python.
jobo-enterprise is the official Python client for the Jobo API. It wraps search, the bulk feed, expired job IDs, company profiles and geocoding in typed sub-clients, follows cursors and pages for you through its iter_ methods, and retries 429 and 503 responses with the server's Retry-After. A synchronous JoboClient and an AsyncJoboClient share the same method names. It needs Python 3.9 or later.
import os
from jobo_enterprise import JoboClient
with JoboClient(api_key=os.environ["JOBO_API_KEY"]) as client:
results = client.search.search(q="data scientist", location="New York", page_size=10)
for job in results.jobs:
print(f"{job.title} at {job.company.name}")What can you do with the Python SDK integration?
The official Python client: typed models, sync and async, auto-pagination, and retries on 429 and 503.
Sync and async
JoboClient for scripts and notebooks, AsyncJoboClient for services. Both take the same arguments and expose the same methods.
Pagination handled
client.search.iter_jobs walks result pages and client.feed.iter_jobs follows the feed cursor, so a loop is all a backfill needs.
Typed errors
Every failure raises a JoboError subclass carrying the API's problem code, status and detail. JoboRateLimitError also carries retry_after.
Retries that know when to stop
429 and 503 are retried up to three times, honouring Retry-After. Everything else is raised immediately.
How do you connect Python SDK to Jobo?
One-time setup. After this, the data keeps itself current.
- 1
Install the package
The client is published on PyPI as jobo-enterprise.
bashpip install jobo-enterprise - 2
Create a client
Pass your API key from the dashboard. Reading it from an environment variable keeps it out of source control.
pythonimport os from jobo_enterprise import JoboClient client = JoboClient(api_key=os.environ["JOBO_API_KEY"]) - 3
Search
Filters are keyword arguments. Results carry the total match count and a list of typed jobs.
pythonresults = client.search.search(q="data scientist", location="New York", page_size=10) print(results.total) - 4
Stream the feed
For volume, iterate the feed. The client follows the cursor until the scan is complete.
pythonfor job in client.feed.iter_jobs(sources=["greenhouse"], batch_size=1000): save_to_database(job)
What goes wrong with Python SDK, and how do you fix it?
The things people actually hit when running Jobo in Python SDK.
- A filter the API documents is missing from the client
- The 4.0.0 clients do not cover every parameter: sort, languages, the occupation and company-category filters and description_format are sent over plain HTTPS instead. The client library docs list exactly what is not covered.
- Enum values stopped matching after upgrading
- 4.0.0 changed the EmploymentType, ExperienceLevel and CompensationPeriod value sets (full-time rather than full_time, for example). Pin an exact version and read the 4.0.0 upgrade notes before moving from 3.x.
- A date argument raises a type error
- Date arguments take datetime objects, not strings. Build one with datetime.now(timezone.utc) and a timedelta.
How do you get the most out of Python SDK?
- Open the client with a with block (or async with) so its connection pool is closed.
- Use iter_expired_job_ids on a schedule to drop closed jobs from your copy. It is free.
- Pass updated_after to the feed for incremental syncs after the first backfill.
- Pin the version exactly. 4.0.0 was a breaking release.
Which other Jobo integrations work alongside Python SDK?
Start pulling live jobs into Python SDK
One API key covers every integration, and the same job index sits behind all of them.













