Job postings
Search job postings, read one with its history and export the results.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
X-Ken-Workspace-Id | header | integer (int64) | optional | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found. |
Get a job posting
/v1/job-postings/{jobPostingId}job-postings.get- Permission
- Search view
- Rate limit
- 12,000 requests a minute per API key
Get one job posting with the source document Kenso read it from and its earlier revisions.
A posting stays readable after it closes. The call is free and does not use the export allowance.
Errors:
404 not_found: no posting has this id.503 service_unavailable: job postings are not available right now. Try again.504 upstream_timeout: job postings took too long to answer. Try again.
Requires Search view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
jobPostingId | path | string | required | The posting's id from a search result: up to 64 letters, digits, _ or -. |
curl -X GET "https://api.ken.so/v1/job-postings/01JC8Z3K6Q2W4M7N9P5R1T3V5X" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a JobPostingDetail.
Show the 4 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Search job postings
/v1/job-postings/searchjob-postings.search- Permission
- Search view
- Rate limit
- 240 requests a minute per API key
Search job postings with filters and get one page of postings. Use it to find companies that are hiring for a role, in a place or on a date range.
Send at least one filter, for example titles, location, hasRemote, postedWithin (days) or status (open by default, closed or all). limit sets the page size, from 1 to 50, and cursor takes the previous page's pagination.next_cursor. groupBy: "company" returns one row per company. Request fields are camelCase, and the postings come back with snake_case fields such as posted_at.
The search is free and does not use the export allowance.
Errors:
400 validation_failed: a filter orlimitis not valid.413 validation_failed: the body is larger than 1 MB.422 filter_required: the body sets no filter.503 service_unavailable: job postings are not available right now. Try again.504 upstream_timeout: job postings took too long to answer. Try again.
Requires Search view.
curl -X POST "https://api.ken.so/v1/job-postings/search" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a JobPostingSearchPage.
Show the 7 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Export job postings
/v1/job-postings/search/exportjob-postings.export- Permission
- Search view and the
exportpermission - Rate limit
- 30 requests a minute per API key
Export every job posting that matches your filters, as JSON or as a CSV file.
The body takes the same filters as POST /v1/job-postings/search, plus format (json, the default, or csv) and limit (default 100). The export can return at most the smallest of limit, 5,000 rows, and the rows left in this month's allowance. When more postings match, Kenso exports nothing and answers 422, so narrow the filters or raise limit.
Kenso charges one allowance row per returned row, once the whole export is in hand, and sets the X-Ken-Row-Count header. A JSON export answers application/json, the postings in data.signals. A CSV export answers the file, not an envelope: Content-Type: text/csv; charset=utf-8 and Content-Disposition: attachment; filename="job-postings-{yyyyMMdd-HHmmss}.csv", the time in UTC. Errors are JSON either way. A failed export uses nothing. The rows also count against the workspace's monthly jobsExportRows fair-use quota. Check what is left with GET /v1/job-postings/export-allowance.
Errors:
400 validation_failed: the body is not a JSON object,formatis notjsonorcsv, orlimitis not a whole number of at least 1. Alimitabove 5,000 counts as 5,000.402 plan_limit_reached: the workspace has no export rows left this month, or another export used the last of them first.error.refusalcarries the codeJOBS_EXPORT_ROWS_LIMIT_REACHED.413 validation_failed: the body is larger than 1 MB.422 export_limit_exceeded: more postings match than the export may return.details[0].countis the number that matched anddetails[0].limitthe most this export could return.422 export_too_large: the export would be larger than 512 MB. Narrow the filters.422 filter_required: the body sets no filter.422 validation_error: a filter list has more than 100 items.429 quota_exceeded: the workspace used its monthlyjobsExportRowsquota. Wait for the time inRetry-After.503 service_unavailable: too many exports are running, or job postings are not available right now. Try again after the time inRetry-After, when the answer has one.504 upstream_timeout: job postings took too long to answer. Try again.
Requires Search view and the export permission.
curl -X POST "https://api.ken.so/v1/job-postings/search/export" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a JobPostingExportResult.
Show the 2 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Get the job posting export allowance
/v1/job-postings/export-allowancejob-postings.get-export-allowance- Permission
- Search view
- Rate limit
- 12,000 requests a minute per API key
Get how many job posting rows the workspace may still export this calendar month. Check it before a large export.
The allowance equals the workspace's lead limit, in rows per month, and resets on the first of each month, UTC. The answer holds limit, used (rows exported this month, including exports still running), remaining, maxPerExport, isUnlimited, and the month's periodStart and periodEnd. The call is free.
Errors:
503 service_unavailable: job postings are not available right now, or Kenso could not read the allowance. Try again.
Requires Search view.
curl -X GET "https://api.ken.so/v1/job-postings/export-allowance" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a JobPostingsExportAllowance.
Show the 7 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Resolve job filter values
/v1/job-postings/filters/resolvejob-postings.resolve-filters- Permission
- Search view
- Rate limit
- 4,800 requests a minute per API key
Turn partial company, job title or location text into the exact values a job posting filter accepts, for type-ahead filter pickers.
Unlike a search, the call needs no filter. It is free and does not use the export allowance.
Errors:
400 validation_failed: a field is not valid.413 validation_failed: the body is larger than 1 MB.503 service_unavailable: job postings are not available right now. Try again.504 upstream_timeout: job postings took too long to answer. Try again.
Requires Search view.
curl -X POST "https://api.ken.so/v1/job-postings/filters/resolve" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a JobPostingFilterValues.
Show the 3 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Prospecting data:People and company searchSaved searchesSaved listsSaved list membersSaved list invitesEmail finderFunding roundsJob post searchLinkedIn job searchLinkedIn jobsWeb scrapingSocial data lookupsSocial data searchesSocial profile resolutionSocial data recordsSignalsAll resources