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. Open mode is currently on, so /v1/jobs also works with no key (unlimited, unattributed). Paid keys carry monthly call quotas and usage tracking.

Endpoints

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)

GET /v1/jobs — query parameters

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`).
`limit`	int	1–500 (default 50).
`format`	string	`json` (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

Plan	Calls / month	Price
Free	100	$0
Pro	10,000	$19
Team	100,000	$49

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

Error codes

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

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].