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 Sumblejob_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 savedorganization_list_id, and/or an advancedquery(technologies, technology categories, job functions, countries, hiring period, and more). A query on its own searches the whole corpus. Covers the previousfindflow.
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 entitiestechnologies(with ausedflag distinguishing technologies the team uses from ones merely mentioned),teams,job_functions,job_levels, andprojects.job_idandsumble_urlare 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-joblimit(default 5, max 25). Available in both modes, for up to 25 jobs per request.
File output
Set file_name, such as jobs.csv, to get the results as a file instead of inline jobs. The formats and the response shape are in File downloads.
A .json file contains one object per job in the same structure as the inline jobs results, so the organization stays an object and technologies, teams, job functions, job levels, projects, and related people stay arrays.
A .csv or .xlsx file contains one row per job. In list mode, unmatched inputs stay as rows with their input_job_id column populated. Job and organization scalar values get their own columns. Repeated values (technologies, teams, job functions, job levels, projects, and related people) are compact JSON in one cell.
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 (
titleis free), plus1 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.
Maximum number of jobs to return (filter mode only; ignored when jobs is provided).
10Number of results to skip (filter mode only; ignored when jobs is provided).
0Successful Response
List mode only: how many input entries matched a Sumble job.
Validation Error
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": {}
}{
"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"
}
]
}
}
]
}Last updated