Remote Jobs API

Live, normalized remote-job data across 5 boards — one clean endpoint, one schema.

Stop scraping Remotive / RemoteOK / We Work Remotely / Jobicy / Hacker News yourself. This API pulls them, normalizes every listing into a single schema, dedupes, and hands you structured JSON (or CSV) — with an optional 0-100 skill fit-score for ranking.

Built for:

• Job boards & aggregator sites

• Recruiter and ATS tooling

• Lead-gen and market research

• AI agents that need structured job data in one call

Why it's different

• One schema, every board. No per-board adapters on your side.

• No session scraping. Reads public job-board endpoints — your data never leaves their servers, no browser, no account.

• Self-hostable. Stdlib-only Python (zero dependencies). Run it on a laptop, a $5 VPS, or containerize it with the included Dockerfile.

• Deterministic fit scoring. No hidden LLM, no black box — reproducible ranking you can reason about and unit-test.

• Structured salary, machine-filterable. Every listing carries parsed salary_min / salary_max / salary_currency / salary_period, and ?min_salary=N filters by the parsed salary floor (salary_min) — no regex on your side.

Related MCP server: JobsPipe MCP Server

Endpoints

GET /v1/jobs

Query params:

Example

curl "https://<your-host>/v1/jobs?skills=python,backend,api&limit=3"

{
  "count": 3,
  "generated_at": 1790433192,
  "jobs": [
    {
      "id": "94516b10164d3c70",
      "title": "Senior Backend Developer (Python)",
      "company": "Proxify AB",
      "url": "https://weworkremotely.com/remote-jobs/proxify-ab-senior-backend-developer-python-10",
      "location": "Anywhere in the World",
      "salary": "USD 170,000-200,000 / yearly",
      "salary_min": 170000,
      "salary_max": 200000,
      "salary_currency": "USD",
      "salary_period": "year",
      "category": "Back-End Programming",
      "source": "wwr",
      "published": "2026-09-15T09:01:36+00:00",
      "fit_score": 80
    }
  ]
}

GET /v1/snapshot

A live, self-updating snapshot of the remote job market — no key required. One call returns how many jobs each board is carrying, the salary distribution across the listings that publish one, and the hottest skills. The numbers below were captured live from the endpoint on 2026-10-03 and shift as the feed refreshes:

curl "https://remote-jobs-api.tten.no/v1/snapshot"

{
  "count_live": 338,
  "demand_by_source": { "jobicy": 120, "remoteok": 99, "wwr": 88, "remotive": 16, "hn": 15 },
  "salary": {
    "count_with_salary": 72,
    "coverage_pct": 21.3,
    "median_min": 110000,
    "p75_min": 170000,
    "max": 317000,
    "distribution": { "<50k": 12, "50-100k": 21, "100-150k": 12, "150-200k": 15, "200-300k": 9, "300k+": 3 }
  },
  "top_skills": [ { "skill": "full-time", "count": 115 }, { "skill": "exec", "count": 66 } ]
}

Built for market-intelligence and white-label job-board use — a ready "what is the remote market doing right now" signal from a single endpoint.

GET /v1/salary-band

What do people actually get paid for a given skill? One call returns, for every skill (a job's tag), the compensation band across all live listings that carry a salary for it — min / p25 / median / p75 / max — no key required. This is the same per-skill salary data the paid scraping/normalization services sell, served live from the normalized cross-board feed.

curl "https://remote-jobs-api.tten.no/v1/salary-band?limit=10"
curl "https://remote-jobs-api.tten.no/v1/salary-band?skills=python,golang"
curl "https://remote-jobs-api.tten.no/v1/salary-band?source=jobicy&skills=engineer"

Response is sorted by how many listings carry a salary for that skill. Currency is USD (parsed salary_min, the bottom of the range). A skill with no listings carrying a salary is omitted.

Try the live API (no key required)

The endpoint is live — no install, no key, no account to test it:

curl "https://remote-jobs-api.tten.no/v1/jobs?skills=python,backend,api&limit=3"

Free tier: 100 calls/month, all 5 boards. When you're ready, self-serve:

• Start free → https://remote-jobs-api.tten.no/register

• Dashboard → https://remote-jobs-api.tten.no/dashboard

• Upgrade to Pro ($19/mo) → https://remote-jobs-api.tten.no/checkout/pro

Self-hosting below gives you the same engine for $0.

MCP server (for AI agents & LLM apps)

Point any MCP client (Claude Desktop, Cursor, Claude Code, or your own agent) at live remote-job data — no key, no scraping:

pip install mcp remote-jobs-api
remote-jobs-api-mcp   # launches the MCP server over stdio

It exposes three tools: search_jobs (skill + salary-floor filter, fit-score ranked), salary_band (live min/median/max per skill set), and market_stats (feed health). See the MCP page for the copy-paste client config.

Run it yourself

Zero runtime dependencies — it's pure Python stdlib.

Option A — CLI (query the feed directly, no server needed):

pip install remote-jobs-api
remote-jobs-api --skills python,api --limit 5
remote-jobs-api --source wwr --format csv
remote-jobs-api --help

Option B — HTTP API server (self-host):

pip install remote-jobs-api
remote-jobs-api --serve --port 8321        # or: python -m remote_jobs_api.server

Or from source / Docker:

git clone https://github.com/earnnova-dev/remote-jobs-api
cd remote-jobs-api
python3 -m remote_jobs_api.server          # listens on :8321

docker build -t remote-jobs-api .
docker run -p 8321:8321 remote-jobs-api

Or the fastest way — one command with the included docker-compose.yml (keys + accounts persist in a named volume):

git clone https://github.com/earnnova-dev/remote-jobs-api && cd remote-jobs-api
export RJA_ADMIN_TOKEN=***            # required: mint keys via /admin/keys
docker compose up -d                     # live on http://localhost:8321

Option C — Kubernetes (Helm chart, self-host):

A production-ready chart ships in the repo (charts/remote-jobs-api/) and is published as a static Helm repository on GitHub Pages. It provisions the API server, a persistent key store (PVC), and an optional ingress, PDB and NetworkPolicy.

helm repo add earnnova https://earnnova-dev.github.io/remote-jobs-api/
helm repo update
helm install rja earnnova/remote-jobs-api --namespace rja --create-namespace --set image.repository=ghcr.io/earnnova-dev/remote-jobs-api --set image.tag=1.1.0

The chart generates an admin token on install; retrieve it:

kubectl -n rja get secret rja-rja -o jsonpath='{.data.token}' | base64 -d

See charts/remote-jobs-api/README.md for the full values reference (ingress, TLS, persistence, NetworkPolicy egress allowlist, resources).

Env vars:

• PORT (default 8321)

• RJA_CACHE_TTL (default 300 s) — how long to cache upstream fetches

Testing

Offline unit tests (no network): python -m pytest.

Pricing (indicative, for a hosted tier)

Self-hosted = free, MIT. The paid tier is the hosted, always-on, high-rate-limit version — the same engine, managed for you.

Related product

Want alerts instead of a data endpoint? GigWatch is a self-hosted gig watcher that monitors the same live feeds, filters by your skills, and pings you (console, email, or Slack) only when a new matching gig appears.

• Repo: https://github.com/earnnova-dev/gigwatch

• Install: pip install gigwatch-nova

License

MIT. See LICENSE.

Data & compliance

This API only reads public, no-auth job-board endpoints and returns data exactly as those boards publish it. It does not store your personal data, does not scrape authenticated sessions, and does not resell any board's proprietary content beyond what is publicly viewable.