Skip to Content
Prospecting data

Job postings

Search job postings, read one with its history and export the results.

Prospecting data5 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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-Idheaderinteger (int64)optionalThe 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

GET/v1/job-postings/{jobPostingId}job-postings.get
Permission
Search view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

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

NameInTypeRequiredDescription
jobPostingIdpathstringrequiredThe posting's id from a search result: up to 64 letters, digits, _ or -.
Request
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

POST/v1/job-postings/searchjob-postings.search
Permission
Search view
Rate limit
240 requests a minute per API key

Try it on developer.ken.so

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 or limit is 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.

Request
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

POST/v1/job-postings/search/exportjob-postings.export
Permission
Search view and the export permission
Rate limit
30 requests a minute per API key

Try it on developer.ken.so

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, format is not json or csv, or limit is not a whole number of at least 1. A limit above 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.refusal carries the code JOBS_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].count is the number that matched and details[0].limit the 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 monthly jobsExportRows quota. Wait for the time in Retry-After.
  • 503 service_unavailable: too many exports are running, or job postings are not available right now. Try again after the time in Retry-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.

Request
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

GET/v1/job-postings/export-allowancejob-postings.get-export-allowance
Permission
Search view
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

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.

Request
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

POST/v1/job-postings/filters/resolvejob-postings.resolve-filters
Permission
Search view
Rate limit
4,800 requests a minute per API key

Try it on developer.ken.so

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.

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


On this page