Jobs Data API

Authentication & scopes

Base URL: https://data.exende.dev. Send Authorization: Bearer $EXENDE_API_KEY. Keys belong to your organization, are shown once, and can be revoked in the dashboard. Keep them out of browser code, URLs, and logs.

Only the documented customer routes are supported. Jobs Data keys and credits are separate from the x402 infrastructure payment model.

Search jobs

GET /v1/jobs/search

q is required. Search uses bounded, safely quoted FTS prefix terms. Keyset pagination: default 50, max 100. Ordered by last_seen_at DESC, id DESC. Pass nextCursor as cursor with unchanged filters. Concurrent catalogue updates mean this is not a frozen snapshot. Credit cost: 1 per returned record. Required scope: jobs:read.

curl "https://data.exende.dev/v1/jobs/search?q=software%20engineer&limit=5" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. Returns data: [] when there are no matching records.

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "company_id": "00000000-0000-4000-8000-000000000000",
      "company": "Company name",
      "canonical_domain": null,
      "title": "Job title from the source",
      "location": null,
      "country_code": null,
      "department": null,
      "employment_type": "full_time",
      "workplace_type": "remote",
      "status": "active",
      "source_url": "https://company.example/careers/job",
      "first_seen_at": "2000-01-01T00:00:00.000Z",
      "last_seen_at": "2000-01-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

List jobs

GET /v1/jobs

Filter current normalized job records. Keyset pagination: default 50, max 100. Ordered by last_seen_at DESC, id DESC. Pass nextCursor as cursor with unchanged filters. Concurrent catalogue updates mean this is not a frozen snapshot. Credit cost: 1 per returned record. Required scope: jobs:read.

curl "https://data.exende.dev/v1/jobs?limit=5" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. Returns data: [] when there are no matching records.

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "company_id": "00000000-0000-4000-8000-000000000000",
      "company": "Company name",
      "canonical_domain": null,
      "title": "Job title from the source",
      "location": null,
      "country_code": null,
      "department": null,
      "employment_type": "full_time",
      "workplace_type": "remote",
      "status": "active",
      "source_url": "https://company.example/careers/job",
      "first_seen_at": "2000-01-01T00:00:00.000Z",
      "last_seen_at": "2000-01-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Job detail

GET /v1/jobs/{id}

Retrieve one canonical job and its normalized skills. Not paginated. Credit cost: 1. Required scope: jobs:read.

curl "https://data.exende.dev/v1/jobs/$JOB_ID" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. Unknown job returns 404.

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "company_id": "00000000-0000-4000-8000-000000000000",
    "company": "Company name",
    "canonical_domain": null,
    "title": "Job title from the source",
    "location": null,
    "country_code": null,
    "department": null,
    "employment_type": "full_time",
    "workplace_type": "remote",
    "status": "active",
    "source_url": "https://company.example/careers/job",
    "first_seen_at": "2000-01-01T00:00:00.000Z",
    "last_seen_at": "2000-01-01T00:00:00.000Z",
    "website_url": null,
    "description_text": null,
    "posted_at": null,
    "closed_at": null,
    "skills": [
      {
        "slug": "skill-slug",
        "canonical_name": "Canonical name",
        "category": "category"
      }
    ],
    "description_enrichment_status": null
  }
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Job history

GET /v1/jobs/{id}/history

Newest observed versions first, ordered by observed_at DESC, id DESC. Historical snapshot fields use camelCase. Not paginated. Credit cost: 1 per returned record. Required scope: jobs:read.

curl "https://data.exende.dev/v1/jobs/$JOB_ID/history?limit=5" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. An unknown job or a job without versions returns data: [].

{
  "data": [
    {
      "id": "00000000000000000000000000000000",
      "observedAt": "2000-01-01T00:00:00.000Z",
      "changeType": "created",
      "contentHash": "0000000000000000000000000000000000000000000000000000000000000000",
      "snapshot": null
    }
  ]
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

History feed

GET /v1/history

Latest 100 immutable version events, ordered by observed_at DESC, id DESC. Query limit and cursor are not supported. Not paginated. Credit cost: 1 per returned record. Required scope: jobs:read.

curl "https://data.exende.dev/v1/history" -H "Authorization: Bearer $EXENDE_API_KEY"

No query parameters.

200 response: Successful JSON response. Returns data: [] when there are no matching records.

{
  "data": [
    {
      "id": "00000000000000000000000000000000",
      "observed_at": "2000-01-01T00:00:00.000Z",
      "change_type": "created",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "title": "Job title from the source",
      "company": "Company name"
    }
  ]
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Company detail

GET /v1/companies/{domain}

Canonical identity with current active count and observation bounds. Not paginated. Credit cost: 2. Required scope: companies:read.

curl "https://data.exende.dev/v1/companies/$COMPANY_DOMAIN" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. A known company with no active jobs returns active_jobs: 0. Unknown company returns 404.

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "canonical_name": "Canonical name",
    "canonical_domain": null,
    "website_url": null,
    "active_jobs": 0,
    "first_seen_at": null,
    "last_seen_at": null
  }
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Company jobs

GET /v1/companies/{domain}/jobs

Filters are combined with the company in the path. Keyset pagination: default 50, max 100. Ordered by last_seen_at DESC, id DESC. Pass nextCursor as cursor with unchanged filters. Concurrent catalogue updates mean this is not a frozen snapshot. Credit cost: 1 per returned record. Required scope: companies:read.

curl "https://data.exende.dev/v1/companies/$COMPANY_DOMAIN/jobs?limit=5" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. A valid but unmatched company domain or filter returns data: [], nextCursor: null.

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "company_id": "00000000-0000-4000-8000-000000000000",
      "company": "Company name",
      "canonical_domain": null,
      "title": "Job title from the source",
      "location": null,
      "country_code": null,
      "department": null,
      "employment_type": "full_time",
      "workplace_type": "remote",
      "status": "active",
      "source_url": "https://company.example/careers/job",
      "first_seen_at": "2000-01-01T00:00:00.000Z",
      "last_seen_at": "2000-01-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Company hiring

GET /v1/companies/{domain}/hiring

Deterministic role mix, history readiness and a daily timeline. Current summary and historical events have distinct meanings. Not paginated. Credit cost: 5. Required scope: companies:read.

curl "https://data.exende.dev/v1/companies/$COMPANY_DOMAIN/hiring" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. Unknown company returns 404. A known company can return zero counts and null acceleration.

{
  "data": {
    "company": {
      "id": "00000000-0000-4000-8000-000000000000",
      "canonical_name": "Canonical name",
      "canonical_domain": null,
      "website_url": null
    },
    "period_days": 7,
    "summary": {
      "active_jobs": 0,
      "created_jobs": 0,
      "updated_jobs": 0,
      "closed_jobs": 0,
      "remote_jobs": 0,
      "engineering_jobs": 0,
      "sales_jobs": 0,
      "ai_jobs": 0,
      "countries_hiring": 0,
      "country_classified_jobs": 0,
      "country_unclassified_jobs": 0,
      "hiring_velocity": 0,
      "hiring_acceleration": null,
      "history_complete": false
    },
    "timeline": [
      {
        "day": "2000-01-01",
        "created_jobs": 0,
        "updated_jobs": 0,
        "closed_jobs": 0,
        "active_jobs": 0
      }
    ]
  }
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Skills

GET /v1/skills

Up to 100 skills with active jobs, ordered by active_jobs DESC, canonical_name ASC. No query parameters supported. Not paginated. Credit cost: 1 per returned record. Required scope: jobs:read.

curl "https://data.exende.dev/v1/skills" -H "Authorization: Bearer $EXENDE_API_KEY"

No query parameters.

200 response: Successful JSON response. Returns data: [] when there are no matching records.

{
  "data": [
    {
      "slug": "skill-slug",
      "canonical_name": "Canonical name",
      "category": "category",
      "active_jobs": 0
    }
  ]
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Overview metrics

GET /v1/metrics/overview

Active counts and daily visibility confirmations in the last 14 calendar days. The legacy failed_runs field is an aggregate, not a freshness guarantee. Not paginated. Credit cost: 2. Required scope: signals:read.

curl "https://data.exende.dev/v1/metrics/overview" -H "Authorization: Bearer $EXENDE_API_KEY"

No query parameters.

200 response: Successful JSON response. A successful aggregate object costs 2 credits even if all counts are zero.

{
  "data": {
    "active_jobs": 0,
    "active_sources": 0,
    "failed_runs": 0,
    "daily": [
      {
        "day": "2000-01-01",
        "observations": 0
      }
    ]
  }
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Hiring metrics

GET /v1/metrics/hiring

Current role mix, version events, readiness-gated acceleration and top-12 groups. Timeline contains days with events; company-hiring timeline instead fills calendar days. Not paginated. Credit cost: 5. Required scope: signals:read.

curl "https://data.exende.dev/v1/metrics/hiring" -H "Authorization: Bearer $EXENDE_API_KEY"

200 response: Successful JSON response. A successful aggregate object costs 5 credits even if counts are zero or grouped arrays are empty.

{
  "data": {
    "period_days": 7,
    "summary": {
      "active_jobs": 0,
      "new_jobs": 0,
      "updated_jobs": 0,
      "closed_jobs": 0,
      "remote_jobs": 0,
      "engineering_jobs": 0,
      "sales_jobs": 0,
      "ai_jobs": 0,
      "countries_hiring": 0,
      "country_classified_jobs": 0,
      "country_unclassified_jobs": 0,
      "hiring_velocity": 0,
      "hiring_acceleration": null,
      "history_complete": false
    },
    "timeline": [
      {
        "day": "2000-01-01",
        "created_jobs": 0,
        "updated_jobs": 0,
        "closed_jobs": 0
      }
    ],
    "companies": [
      {
        "company_id": "00000000-0000-4000-8000-000000000000",
        "company": "Company name",
        "canonical_domain": null,
        "active_jobs": 0,
        "new_jobs": 0,
        "updated_jobs": 0,
        "closed_jobs": 0,
        "remote_jobs": 0,
        "engineering_jobs": 0,
        "sales_jobs": 0,
        "ai_jobs": 0,
        "countries_hiring": 0,
        "hiring_velocity": 0,
        "hiring_acceleration": null,
        "history_complete": false,
        "new_jobs_per_day": 0
      }
    ],
    "locations": [
      {
        "location": "Source location text",
        "active_jobs": 0
      }
    ],
    "countries": [
      {
        "country_code": "GB",
        "active_jobs": 0
      }
    ]
  }
}

Common errors: 400, 401, 402, 403, 404, 429, 500, 503. See Errors & rate limits below for handling.

Public overview

GET /v1/public/overview

Aggregate-only public proof. No key and no credits. No listing, customer, or source-health records. Last updated is the latest canonical job observation.

curl "https://data.exende.dev/v1/public/overview"

No query parameters.

200 response: Current aggregate overview.

{
  "data": {
    "active_jobs": 0,
    "active_companies": 0,
    "active_sources": 0,
    "last_updated_at": null
  }
}

Common errors: 429, 503. See Errors & rate limits below for handling.

Public catalogue preview

GET /v1/public/search

Deterministic AND terms over public title, department, source location, company name/domain and normalized skills; exact country names and supported country codes filter country_code directly; skill aliases are recognized. Only q is accepted. No pagination or export. Sample membership is fixed by migration, with at most 12 enrolled jobs across all queries; responses contain at most 5. Full descriptions, source payloads, customer and operator data are excluded. Aggregates describe matching active canonical jobs, not just samples. Limits: public gateway 20 requests/minute per client IP and Data Plane 60/minute; Cloudflare limits are approximate.

curl "https://data.exende.dev/v1/public/search"

200 response: Real matching aggregates and up to 5 enrolled samples. No matches returns zero counts and empty arrays. Matches can exist without any enrolled sample.

{
  "data": {
    "query": "",
    "summary": {
      "active_jobs": 0,
      "companies": 0,
      "countries": 0,
      "locations": 0,
      "country_unclassified_jobs": 0,
      "first_observed_at": null,
      "last_observed_at": null
    },
    "top_locations": [],
    "top_countries": [],
    "top_roles": [],
    "top_companies": [],
    "sample_jobs": [],
    "preview": {
      "sample_limit": 5,
      "pool_limit": 12,
      "enrolled_samples": 0,
      "pagination": false,
      "projection": "limited_public_fields"
    }
  }
}

Common errors: 400, 429, 503. See Errors & rate limits below for handling.

Pagination & request limits

Jobs list, search, and company jobs use keyset pagination. The default is 50 records and the maximum is 100. Keep filters unchanged and send the returned nextCursor as cursor. Stop when it is null. Records are ordered by last_seen_at DESC, id DESC; ongoing catalogue changes mean pages are not a frozen snapshot.

Job history accepts limit (default 50, max 100) with no cursor. Skills and the history feed return at most 100 records and do not accept pagination parameters. The hiring window is 7–90 days, default 30; grouped companies, locations, and countries are capped at 12.

The current backend falls back to 50 for an invalid numeric limit and 30 for invalid numeric days. Other invalid filters and malformed cursors return 400. Unknown query parameters on customer routes are ignored, so use the parameters documented for each operation. The strict public preview instead rejects every parameter other than q.

Credit metering

Credits are not requests. Per-record operations cost one credit per returned record: 5 results = 5 credits, 50 results = 50 credits. Empty lists and failed requests cost zero. Successful fixed-cost aggregate objects still incur their fixed cost when their numeric counts are zero.

The authoritative credit debit must succeed before customer data is returned. Insufficient balance returns 402 with insufficient_credits. This is a Jobs Data credit error, not an x402 payment challenge.

Errors & rate limits

{
  "error": {
    "code": "insufficient_credits",
    "message": "This account does not have enough credits for this operation."
  }
}

Production has a pre-authentication abuse limiter (240/minute per connection IP) and an authenticated limiter (120/minute per key). Cloudflare limits are location-local and eventually consistent. Shared-IP traffic can share a limit. Store the X-Request-ID response header for support. Unexpected upstream failures may return a non-JSON body; handle HTTP status before parsing.

Freshness, metrics & caching

Public overview cache: max-age=60, s-maxage=300, stale-while-revalidate=600. The latest observation timestamp does not mean every source was checked at that time. Authenticated metrics can reuse a server-side five-minute calculation cache; authentication and metering still occur on each request, and client responses use private, no-store.

Hiring velocity is recorded created versions divided by days. Acceleration compares recent and preceding creation rates and is null until the earliest immutable history spans the requested window. history_complete is that readiness gate; it does not prove uninterrupted or whole-market observation. Company timelines include zero-event days; the overall hiring timeline includes days with events. Country nulls remain unclassified. See Coverage & methodology.