Job posts

Find, match, and enrich job posts

The single endpoint for working with job postings. Provide either a list of job IDs to resolve (list mode) or an advanced query filter (search mode), and compose exactly which attributes you get back. This replaces the previous find, job details, and find-related-people endpoints.

Input

Provide exactly one of:

• jobs — a list of up to 1,000 jobs to resolve, each identified by its Sumble job_id. Covers the previous job details flow. Limited to 200 entries when requesting descriptions and 25 entries when requesting related people.

• filter — the jobs to return: organization_ids (up to 1,000), a saved organization_list_id, and/or an advanced query (technologies, technology categories, job functions, countries, hiring period, and more). A query on its own searches the whole corpus. Covers the previous find flow.

In filter mode, limit (default 10, max 200) and offset page through results.

Composable response

The select block dictates exactly which attributes return — nothing is mandatory:

• attributes — a list of job attributes, or "all". Available: title, description (the full posting text), location, posted_date, organization, and the extracted entities technologies (with a used flag distinguishing technologies the team uses from ones merely mentioned), teams, job_functions, job_levels, and projects. job_id and sumble_url are always included for free.

• related_people — the people most relevant to each job, typically hiring managers and team members at the organization. Choose which person attributes to return and a per-job limit (default 5, max 25). Available in both modes, for up to 25 jobs per request.

Credit cost

Charged per matched job (list mode) or per returned job (search mode). Unmatched inputs are free.

Per job the cost is:

• 1 base credit, plus:

• 1 credit per paid attribute requested (title is free), plus

• 1 credit per related person returned.

For example, returning 5 jobs with 3 paid attributes and 2 related people each costs 5 × (1 + 3 + 2) = 30 credits. The API checks affordability up front and returns HTTP 402 before doing any work you can't pay for.

Unified jobs endpoint

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

limitinteger · min: 1 · max: 200Optional

Maximum number of jobs to return (filter mode only; ignored when jobs is provided).

Default: 10

offsetinteger · max: 10000Optional

Number of results to skip (filter mode only; ignored when jobs is provided).

Default: 0

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

matched_countinteger · nullableOptional

List mode only: how many input entries matched a Sumble job.

totalintegerRequired

source_data_urlstring · uri · min: 1 · max: 2083 · nullableOptional

422

Validation Error

application/json

post/v9/jobs

HTTPcURLJavaScriptPython

POST /v9/jobs HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "filter": {
    "organization_ids": [
      1726684
    ]
  },
  "select": {}
}

Jobs at specific organizations (no attributes requested)Corpus-wide advanced query, some attributesOrg-scoped jobs with extracted entities (+1 credit each per job)Saved organization list + query, all attributes (includes the full description and extracted entities)List mode: enrich specific jobs by id

{
  "id": "019980d2-bc85-7571-9d60-7bc1d3084249",
  "credits_used": 9,
  "credits_remaining": 69156,
  "total": 113,
  "source_data_url": "https://sumble.com/l/org/xhXARFaWtJL/jobs",
  "jobs": [
    {
      "job_id": 95107725,
      "sumble_url": "https://sumble.com/l/job/fdYksIHVnJ",
      "attributes": {
        "title": "gtm engineer",
        "location": "United States",
        "posted_date": "2026-02-20T12:20:03.687777Z",
        "organization": {
          "organization_id": 1726684,
          "name": "Sumble",
          "domain": "sumble.com",
          "sumble_url": "https://sumble.com/l/org/xhXARFaWtJL"
        },
        "technologies": [
          {
            "name": "Kubernetes",
            "slug": "kubernetes",
            "used": true,
            "sumble_url": "https://sumble.com/l/org/aQw2Ee9TrV/jobs"
          },
          {
            "name": "Salesforce",
            "slug": "salesforce",
            "used": false,
            "sumble_url": "https://sumble.com/l/org/bRx3Ff0UsW/jobs"
          }
        ],
        "teams": [
          {
            "team_id": 4242,
            "name": "Platform Engineering",
            "slug": "platform-engineering",
            "sumble_url": "https://sumble.com/l/team/aBcDeF"
          }
        ],
        "job_functions": [
          {
            "name": "Data Engineer",
            "slug": "data-engineer",
            "sumble_url": "https://sumble.com/l/org/cSy4Gg1VtX/jobs"
          }
        ],
        "job_levels": [
          {
            "name": "Senior"
          }
        ],
        "projects": [
          {
            "name": "Cloud Migration",
            "slug": "cloud-migration",
            "goal": "Migrate on-prem workloads to GCP",
            "sumble_url": "https://sumble.com/l/org/dTz5Hh2WuY/jobs"
          }
        ]
      }
    }
  ]
}