Home

API documentation

Base URL: https://remote-jobs-api.tten.no · OpenAPI 3.1 spec

Quickstart

1. Create an account — your API key is issued instantly and shown on your dashboard.

2. Call the API with your key:

curl -H "Authorization: Bearer ***" \
  "https://remote-jobs-api.tten.no/v1/jobs?skills=python,backend&limit=5"

Authentication

Send your key as a Bearer token in the Authorization header. A key is required for job data. A free account gives 100 calls/month; paid plans raise the quota. Without an account, pay per call via /x402/jobs (USDC).

Endpoints

MethodPathDescription
GET/healthStatus + live job count + active sources
GET/v1/jobs/sourcesAvailable job boards
GET/v1/jobsNormalized job listings (JSON or CSV, key required — free or paid, or x402 pay-per-call)
GET/v1/pullsScheduled pull (delta) — new jobs since a cursor, for agents that poll on a cadence

GET /v1/pulls — scheduled pull (delta / cursor)

Purpose-built for agents that wake on a schedule and want only the new work instead of re-fetching the whole catalog every tick. Pass the previous response's next_cursor back as since and you get the jobs published since then, newest first. The client needs no state beyond the cursor and no authentication beyond the same rules as /v1/jobs (an API key; a free one via /register).

ParamTypeNotes
sincecursor / datetimeInclusive lower bound on published. Omit for the newest batch. Accepts epoch seconds or any ISO-8601 / RFC-2822 datetime. Feed back the next_cursor from the last call.
limitint1–2000 (default 200). Requires a key (free or paid); the anonymous no-key tier is no longer available.
source, skills, seniority, employment_type, category, location, min_salary—Same filters as /v1/jobs, applied before the delta.

Because published is second-precision, the boundary second may be re-included on the next poll — dedupe by the stable job id. truncated is true when the batch hit limit (more may exist after the cursor); next_cursor is the exact value to send as since next time (null when the batch is empty).

# first pull
curl -s "https://remote-jobs-api.tten.no/v1/pulls?limit=50"
#   -> { ..., "next_cursor": "2026-10-26T19:42:34+00:00", "truncated": true, ... }

# next tick: resume where you left off
curl -s "https://remote-jobs-api.tten.no/v1/pulls?limit=50&since=2026-10-26T19%3A42%3A34%2B00%3A00"

GET /v1/jobs — query parameters

ParamTypeNotes
skillsstringComma-separated keywords. Adds a fit_score (0–100) to each job and ranks best-first.
sourcestringremotive / remoteok / jobicy / wwr / hn
min_scoreintOnly return jobs with fit_score ≥ N (requires skills).
min_salaryintOnly return jobs whose parsed salary floor (salary_min) is ≥ N. Listings with no parsed salary are dropped. e.g. min_salary=100000.
limitint1–500 (default 50).
formatstringjson (default) or csv.

Response shape

{
  "count": 5,
  "generated_at": 1790573039,
  "query": { "skills": ["python","backend"], "source": null, "min_score": null, "limit": 5 },
  "jobs": [
    {
      "id": "154115",
      "title": "Account Manager, Ada Accelerate",
      "company": "Ada",
      "url": "https://jobicy.com/jobs/154115-...",
      "location": "Canada / Director",
      "salary": "130,000-170,000 / yearly",
      "category": "",
      "tags": ["Customer Support & Success", "Full-Time"],
      "published": "2026-09-27T20:36:28+00:00",
      "source": "jobicy",
      "description": "About Us ...",
      "fit_score": 50
    }
  ]
}

fit_score is only present when skills is supplied. It is a deterministic keyword-overlap score (no LLM) — reproducible and unit-testable.

Rate limits & plans

PlanCalls / monthPrice
Free100$0
Pro10,000$19
Team100,000$49
DataFull dataset$149

Exceeding your monthly quota returns 429 with {"error": "...", "retry": "next month"}.

Error codes

CodeMeaning
400Bad request (unknown source, limit out of range, min_score without skills)
401Missing or invalid API key (when key is required)
429Monthly quota exceeded
5xxUpstream board / server error — retry

Example: CSV export

curl -H "Authorization: Bearer ***" \
  "https://remote-jobs-api.tten.no/v1/jobs?skills=data,ml&limit=100&format=csv" -o jobs.csv

Questions

Reach us at [email protected].