Base URL: https://remote-jobs-api.tten.no · OpenAPI 3.1 spec
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"
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).
| Method | Path | Description |
|---|---|---|
| GET | /health | Status + live job count + active sources |
| GET | /v1/jobs/sources | Available job boards |
| GET | /v1/jobs | Normalized job listings (JSON or CSV, key required — free or paid, or x402 pay-per-call) |
| GET | /v1/pulls | Scheduled pull (delta) — new jobs since a cursor, for agents that poll on a cadence |
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).
| Param | Type | Notes |
|---|---|---|
since | cursor / datetime | Inclusive 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. |
limit | int | 1–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"
| Param | Type | Notes |
|---|---|---|
skills | string | Comma-separated keywords. Adds a fit_score (0–100) to each job and ranks best-first. |
source | string | remotive / remoteok / jobicy / wwr / hn |
min_score | int | Only return jobs with fit_score ≥ N (requires skills). |
min_salary | int | Only return jobs whose parsed salary floor (salary_min) is ≥ N. Listings with no parsed salary are dropped. e.g. min_salary=100000. |
limit | int | 1–500 (default 50). |
format | string | json (default) or csv. |
{
"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.
| Plan | Calls / month | Price |
|---|---|---|
| Free | 100 | $0 |
| Pro | 10,000 | $19 |
| Team | 100,000 | $49 |
| Data | Full dataset | $149 |
Exceeding your monthly quota returns 429 with {"error": "...", "retry": "next month"}.
| Code | Meaning |
|---|---|
| 400 | Bad request (unknown source, limit out of range, min_score without skills) |
| 401 | Missing or invalid API key (when key is required) |
| 429 | Monthly quota exceeded |
| 5xx | Upstream board / server error — retry |
curl -H "Authorization: Bearer ***" \
"https://remote-jobs-api.tten.no/v1/jobs?skills=data,ml&limit=100&format=csv" -o jobs.csv
Reach us at [email protected].