Catalog / Hiring Cafe Jobs

Hiring Cafe Jobs API

hiring.cafe

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.

  • Other
  • jobs
  • careers
  • hiring
  • search
  • companies
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

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

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.

Optional parameters 8

Optional free-text role/title query. Omit to browse the source's current job index.

Optional location text resolved by Hiring Cafe's public location search.

When true, apply Hiring Cafe's `Remote` workplace-type filter.

Optional comma-separated source values such as Full Time, Part Time, or Contract.

Optional comma-separated Hiring Cafe seniority values.

Hiring Cafe sort value: default, resume_match_desc, personalization_desc, date, date_asc, compensation_desc, compensation_asc, experience_asc, or experience_desc.

Zero-based source result page. The source controls page size and terminal behavior.

Optional JSON object merged into the source search state for other available Hiring Cafe filters.

View call pricing
cURL · Jobs search
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 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 · string

Hiring Cafe `objectID` returned in a search item.

Example: saashr___lids___503689872

Response

idstring
title?string | null
source?string | null
company?object
company.hq?object | null
company.name?string | null
company.funding?unknown | null
company.tagline?string | null
company.website?string | null
company.industries?unknown[]
company.stable_ids?object
company.match_scope?string | null
company.subsidiaries?unknown[]
company.direct_source?object
company.employee_count?integer | number | string | null
company.parent_company?unknown | null
company.profile_source?object
company.enriched_source?object
company.organization_type?string | null
location?string | null
apply_url?string | null
role_type?string | null
commitment?string[]
is_expired?boolean | null
source_url?string | null
compensation?object
compensation.currency?string | null
compensation.frequency?string | null
compensation.compensation_period?string | null
compensation.compensation_currency?string | null
compensation.hourly_max_compensation?integer | number | null
compensation.hourly_min_compensation?integer | number | null
compensation.weekly_max_compensation?integer | number | null
compensation.weekly_min_compensation?integer | number | null
compensation.yearly_max_compensation?integer | number | null
compensation.yearly_min_compensation?integer | number | null
compensation.monthly_max_compensation?integer | number | null
compensation.monthly_min_compensation?integer | number | null
compensation.listed_compensation_currency?string | null
compensation.listed_compensation_frequency?string | null
source_record?object
requisition_id?string | null
workplace_type?string | null
seniority_level?string | null
description_html?string | null
description_text?string | null
source_and_board_token?string | null

Fields 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 · string

Company name as shown by Hiring Cafe in a result's company profile.

Example: Lids

pageOptionalQuery · integer, min: 0, default: 0

Zero-based page of the source company-filter results.

Example: 0

sort_byOptionalQuery · string, default: default

Hiring Cafe sort value for the company's openings.

Example: default

Response

pageinteger
itemsobject[]
items[].idstring
items[].title?string | null
items[].source?string | null
items[].company?object
items[].company.hq?object | null
items[].company.name?string | null
items[].company.funding?unknown | null
items[].company.tagline?string | null
items[].company.website?string | null
items[].company.industries?unknown[]
items[].company.stable_ids?object
items[].company.match_scope?string | null
items[].company.subsidiaries?unknown[]
items[].company.direct_source?object
items[].company.employee_count?integer | number | string | null
items[].company.parent_company?unknown | null
items[].company.profile_source?object
items[].company.enriched_source?object
items[].company.organization_type?string | null
items[].location?string | null
items[].apply_url?string | null
items[].role_type?string | null
items[].commitment?string[]
items[].is_expired?boolean | null
items[].source_url?string | null
items[].compensation?object
items[].compensation.currency?string | null
items[].compensation.frequency?string | null
items[].compensation.compensation_period?string | null
items[].compensation.compensation_currency?string | null
items[].compensation.hourly_max_compensation?integer | number | null
items[].compensation.hourly_min_compensation?integer | number | null
items[].compensation.weekly_max_compensation?integer | number | null
items[].compensation.weekly_min_compensation?integer | number | null
items[].compensation.yearly_max_compensation?integer | number | null
items[].compensation.yearly_min_compensation?integer | number | null
items[].compensation.monthly_max_compensation?integer | number | null
items[].compensation.monthly_min_compensation?integer | number | null
items[].compensation.listed_compensation_currency?string | null
items[].compensation.listed_compensation_frequency?string | null
items[].source_record?object
items[].requisition_id?string | null
items[].workplace_type?string | null
items[].seniority_level?string | null
items[].source_and_board_token?string | null
companyobject
company.hq?object | null
company.name?string | null
company.funding?unknown | null
company.tagline?string | null
company.website?string | null
company.industries?unknown[]
company.stable_ids?object
company.match_scope?string | null
company.subsidiaries?unknown[]
company.direct_source?object
company.employee_count?integer | number | string | null
company.parent_company?unknown | null
company.profile_source?object
company.enriched_source?object
company.organization_type?string | null
page_sizeinteger
source_urlstring
total_countinteger | null
is_last_pageboolean
retrieved_atstring (date-time)
applied_stateobject
company_countinteger | null
returned_countinteger
source_page_size?integer | null
source_latency_msinteger

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