Hiring Cafe Jobs API
Read-only, live access to Hiring Cafe's public job listings. Search uses the site's classic results surface and preserves its declared totals, filters, sort values, and zero-based page navigation. Search results intentionally do not fetch per-job details; use the returned job id with the detail operation. Company results use Hiring Cafe's company-name filter and return the company profile data that the source attaches to jobs.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Hiring Cafe Jobs API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/69ffe921-0c4c-4c0f-a65d-d5b3d278e8b0/jobs/search' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETJobs search/jobs/search
Searches Hiring Cafe live. `keyword` is matched through the site's job-title query. `location` is resolved through Hiring Cafe's location search before being sent upstream; the source applies its own geographic radius/meaning. Set `remote=true` for the source's Remote workplace filter. `filters_json` accepts additional source filter keys when a site filter is not represented by a named parameter. Pages are zero-based; request the next page by incrementing `page`. Each item includes a stable source id and application URL.
Input
keywordOptionalQuery · string | nullOptional free-text role/title query. Omit to browse the source's current job index.
Example: software engineer
locationOptionalQuery · string | nullOptional location text resolved by Hiring Cafe's public location search.
Example: New York City
remoteOptionalQuery · boolean, default: falseWhen true, apply Hiring Cafe's `Remote` workplace-type filter.
Example: true
commitment_typesOptionalQuery · string | nullOptional comma-separated source values such as Full Time, Part Time, or Contract.
Example: Full Time
seniorityOptionalQuery · string | nullOptional comma-separated Hiring Cafe seniority values.
Example: Entry Level
sort_byOptionalQuery · string, default: defaultHiring Cafe sort value: default, resume_match_desc, personalization_desc, date, date_asc, compensation_desc, compensation_asc, experience_asc, or experience_desc.
Example: default
pageOptionalQuery · integer, min: 0, default: 0Zero-based source result page. The source controls page size and terminal behavior.
Example: 0
filters_jsonOptionalQuery · string | nullOptional JSON object merged into the source search state for other available Hiring Cafe filters.
Example: {"industries":["Technology"],"companyPublicOrPrivate":"public"}
Response
pageintegeritemsobject[]items[].idstringitems[].title?string | nullitems[].source?string | nullitems[].company?objectitems[].company.hq?object | nullitems[].company.name?string | nullitems[].company.funding?unknown | nullitems[].company.tagline?string | nullitems[].company.website?string | nullitems[].company.industries?unknown[]items[].company.stable_ids?objectitems[].company.match_scope?string | nullitems[].company.subsidiaries?unknown[]items[].company.direct_source?objectitems[].company.employee_count?integer | number | string | nullitems[].company.parent_company?unknown | nullitems[].company.profile_source?objectitems[].company.enriched_source?objectitems[].company.organization_type?string | nullitems[].location?string | nullitems[].apply_url?string | nullitems[].role_type?string | nullitems[].commitment?string[]items[].is_expired?boolean | nullitems[].source_url?string | nullitems[].compensation?objectitems[].compensation.currency?string | nullitems[].compensation.frequency?string | nullitems[].compensation.compensation_period?string | nullitems[].compensation.compensation_currency?string | nullitems[].compensation.hourly_max_compensation?integer | number | nullitems[].compensation.hourly_min_compensation?integer | number | nullitems[].compensation.weekly_max_compensation?integer | number | nullitems[].compensation.weekly_min_compensation?integer | number | nullitems[].compensation.yearly_max_compensation?integer | number | nullitems[].compensation.yearly_min_compensation?integer | number | nullitems[].compensation.monthly_max_compensation?integer | number | nullitems[].compensation.monthly_min_compensation?integer | number | nullitems[].compensation.listed_compensation_currency?string | nullitems[].compensation.listed_compensation_frequency?string | nullitems[].source_record?objectitems[].requisition_id?string | nullitems[].workplace_type?string | nullitems[].seniority_level?string | nullitems[].source_and_board_token?string | nullpage_sizeintegersource_urlstringtotal_countinteger | nullis_last_pagebooleanretrieved_atstring (date-time)applied_stateobjectcompany_count?integer | nullreturned_countintegersource_page_size?integer | nullsource_latency_msintegerFields marked ? are optional.
GETJobs by job id/jobs/{job_id}
Fetches the selected public job by its Hiring Cafe object id, then follows the source's requisition permalink to return the full posting, normalized plain text, source HTML, company fields, compensation fields, and the application URL. Pass the `id` returned by search_jobs unchanged; a display title is not an identifier.
Input
job_idRequiredPath · stringHiring Cafe `objectID` returned in a search item.
Example: saashr___lids___503689872
Response
idstringtitle?string | nullsource?string | nullcompany?objectcompany.hq?object | nullcompany.name?string | nullcompany.funding?unknown | nullcompany.tagline?string | nullcompany.website?string | nullcompany.industries?unknown[]company.stable_ids?objectcompany.match_scope?string | nullcompany.subsidiaries?unknown[]company.direct_source?objectcompany.employee_count?integer | number | string | nullcompany.parent_company?unknown | nullcompany.profile_source?objectcompany.enriched_source?objectcompany.organization_type?string | nulllocation?string | nullapply_url?string | nullrole_type?string | nullcommitment?string[]is_expired?boolean | nullsource_url?string | nullcompensation?objectcompensation.currency?string | nullcompensation.frequency?string | nullcompensation.compensation_period?string | nullcompensation.compensation_currency?string | nullcompensation.hourly_max_compensation?integer | number | nullcompensation.hourly_min_compensation?integer | number | nullcompensation.weekly_max_compensation?integer | number | nullcompensation.weekly_min_compensation?integer | number | nullcompensation.yearly_max_compensation?integer | number | nullcompensation.yearly_min_compensation?integer | number | nullcompensation.monthly_max_compensation?integer | number | nullcompensation.monthly_min_compensation?integer | number | nullcompensation.listed_compensation_currency?string | nullcompensation.listed_compensation_frequency?string | nullsource_record?objectrequisition_id?string | nullworkplace_type?string | nullseniority_level?string | nulldescription_html?string | nulldescription_text?string | nullsource_and_board_token?string | nullFields marked ? are optional.
GETCompanies by company name/companies/{company_name}
Uses Hiring Cafe's public company-name filter and returns the profile fields attached to matching source records plus that page of open jobs. Company names are source text, not an invented slug; URL-encode spaces and punctuation. The source may include related or parent-company records according to its own matching semantics. Use each returned job id with the job detail operation for the full posting.
Input
company_nameRequiredPath · stringCompany name as shown by Hiring Cafe in a result's company profile.
Example: Lids
pageOptionalQuery · integer, min: 0, default: 0Zero-based page of the source company-filter results.
Example: 0
sort_byOptionalQuery · string, default: defaultHiring Cafe sort value for the company's openings.
Example: default
Response
pageintegeritemsobject[]items[].idstringitems[].title?string | nullitems[].source?string | nullitems[].company?objectitems[].company.hq?object | nullitems[].company.name?string | nullitems[].company.funding?unknown | nullitems[].company.tagline?string | nullitems[].company.website?string | nullitems[].company.industries?unknown[]items[].company.stable_ids?objectitems[].company.match_scope?string | nullitems[].company.subsidiaries?unknown[]items[].company.direct_source?objectitems[].company.employee_count?integer | number | string | nullitems[].company.parent_company?unknown | nullitems[].company.profile_source?objectitems[].company.enriched_source?objectitems[].company.organization_type?string | nullitems[].location?string | nullitems[].apply_url?string | nullitems[].role_type?string | nullitems[].commitment?string[]items[].is_expired?boolean | nullitems[].source_url?string | nullitems[].compensation?objectitems[].compensation.currency?string | nullitems[].compensation.frequency?string | nullitems[].compensation.compensation_period?string | nullitems[].compensation.compensation_currency?string | nullitems[].compensation.hourly_max_compensation?integer | number | nullitems[].compensation.hourly_min_compensation?integer | number | nullitems[].compensation.weekly_max_compensation?integer | number | nullitems[].compensation.weekly_min_compensation?integer | number | nullitems[].compensation.yearly_max_compensation?integer | number | nullitems[].compensation.yearly_min_compensation?integer | number | nullitems[].compensation.monthly_max_compensation?integer | number | nullitems[].compensation.monthly_min_compensation?integer | number | nullitems[].compensation.listed_compensation_currency?string | nullitems[].compensation.listed_compensation_frequency?string | nullitems[].source_record?objectitems[].requisition_id?string | nullitems[].workplace_type?string | nullitems[].seniority_level?string | nullitems[].source_and_board_token?string | nullcompanyobjectcompany.hq?object | nullcompany.name?string | nullcompany.funding?unknown | nullcompany.tagline?string | nullcompany.website?string | nullcompany.industries?unknown[]company.stable_ids?objectcompany.match_scope?string | nullcompany.subsidiaries?unknown[]company.direct_source?objectcompany.employee_count?integer | number | string | nullcompany.parent_company?unknown | nullcompany.profile_source?objectcompany.enriched_source?objectcompany.organization_type?string | nullpage_sizeintegersource_urlstringtotal_countinteger | nullis_last_pagebooleanretrieved_atstring (date-time)applied_stateobjectcompany_countinteger | nullreturned_countintegersource_page_size?integer | nullsource_latency_msintegerFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.