pip install jobfeeds

Fetching job postings should not require writing six API clients. jobfeeds gives you Remotive, Arbeitnow, Greenhouse boards, RemoteOK, We Work Remotely, and the Hacker News "Who is hiring" thread through one interface, normalized into one pydantic model, with failures isolated per source.

Extracted from, and used in production by, JobRadar, a live job-market intelligence dashboard.

Quickstart

import asyncio
from jobfeeds import Remotive, Greenhouse, fetch_all

async def main():
    # One source
    jobs = await Remotive().fetch()               # list[Posting]
    print(jobs[0].company, jobs[0].title, jobs[0].url)

    # Configured source
    jobs = await Greenhouse(boards=["stripe", "anthropic"]).fetch()

    # Everything, concurrently, failure-isolated
    results = await fetch_all()                   # list[SourceResult]
    for r in results:
        print(r.source, len(r.postings) if r.ok else f"FAILED: {r.error}")

asyncio.run(main())

The model

Every source normalizes into the same Posting:

Boards syndicate each other's postings; posting_hash() collapses the duplicates without trusting any board-specific id.

Sources and their quirks

All adapters accept timeout= and user_agent=. Public APIs change; every adapter parses defensively and skips malformed entries instead of raising.

Failure isolation

fetch_all() never lets one dead API take down the run:

results = await fetch_all([Remotive(), Greenhouse(boards=["stripe"])])
postings = [p for r in results if r.ok for p in r.postings]
errors = {r.source: r.error for r in results if not r.ok}

Your own adapter joins the party by satisfying the SourceAdapter protocol: anything with a name and an async fetch() -> list[Posting].

Design notes

• httpx + pydantic only. No framework, no ORM, no surprises in your dependency tree.
• Fully typed, ships py.typed.
• No product logic. Filtering, enrichment, and storage belong to your application; this package only does feed access done well. (JobRadar's tech-role filter, LLM enrichment, and database live in its repo, on top of this package.)
• Tests never touch the network. Every adapter is tested against mocked responses (respx) in CI on Python 3.11, 3.12, and 3.13.

License

MIT. Built by Nandor Nagy as part of a public portfolio; the ingestion layer of jobradar.nagysolution.com.