API Documentation

REST API for programmatic access to Hiring Signal Indicator data. Available on the Data tier.

Authentication

All API endpoints require a valid API key passed in the X-API-Key header.

Create and manage API keys from your Settings page. Keys use the format hs_<token>. You can have up to 5 active keys.

curl -H "X-API-Key: hs_your_key_here" \
  https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/export/market.json

Rate Limits

Each API key is limited to 1,000 requests per day. The counter resets at midnight UTC.

When the limit is exceeded, the API returns 429 Too Many Requests. Check your current usage without counting against the limit:

curl -H "X-API-Key: hs_your_key_here" \
  https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/api-keys/usage

Base URL

https://hiresignal-api-22520270430.europe-west2.run.app

Market Data

GET/api/v1/export/market.json

All companies with current hiring signals — active postings, week-over-week change, trend signal, top hiring domain, and anomaly flags.

Auth: X-API-Key header (Data tier)

Parameters

is_public(boolean)— Filter by public/private companies

Example

curl -H "X-API-Key: hs_..." \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/export/market.json?is_public=true"

GET/api/v1/export/market.csv

Same data as market.json but as a downloadable CSV file.

Auth: X-API-Key header (Data tier)

Parameters

is_public(boolean)— Filter by public/private companies

Example

curl -H "X-API-Key: hs_..." -o market.csv \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/export/market.csv"

Historical Data

GET/api/v1/historical/companies/{company_id}

Weekly historical posting data for a single company — new postings and active posting count per week.

Auth: X-API-Key header (Data tier)

Parameters

company_id(integer)required— Company ID (path parameter)

start_date(YYYY-MM-DD)— Start date. Defaults to 52 weeks ago

end_date(YYYY-MM-DD)— End date. Defaults to today

Example

curl -H "X-API-Key: hs_..." \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/historical/companies/42"

GET/api/v1/historical/bulk

Weekly historical data for multiple companies. Returns a flat list of rows (company x week).

Auth: X-API-Key header (Data tier)

Parameters

company_ids(string)— Comma-separated company IDs (max 500)

start_date(YYYY-MM-DD)— Start date. Defaults to 52 weeks ago

end_date(YYYY-MM-DD)— End date. Defaults to today

is_public(boolean)— Filter by public/private (when company_ids not specified)

limit(integer)— Max companies, 1-500. Default: 100

Example

curl -H "X-API-Key: hs_..." \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/historical/bulk?company_ids=1,2,3&start_date=2026-03-19"

GET/api/v1/export/historical.csv

Historical data as a downloadable CSV — one row per company per week.

Auth: X-API-Key header (Data tier)

Parameters

company_ids(string)— Comma-separated company IDs

start_date(YYYY-MM-DD)— Start date

end_date(YYYY-MM-DD)— End date

is_public(boolean)— Filter by public/private

limit(integer)— Max companies, 1-500. Default: 100

Example

curl -H "X-API-Key: hs_..." -o historical.csv \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/export/historical.csv?is_public=true"

API Key Management

GET/api/v1/api-keys/usage

Check your current daily usage and rate limit status. Does not count against the limit.

Auth: X-API-Key header

Example

curl -H "X-API-Key: hs_..." \
  "https://hiresignal-api-22520270430.europe-west2.run.app/api/v1/api-keys/usage"

Response Codes

Code	Meaning
`200`	Success
`400`	Bad request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`404`	Not found — company ID doesn't exist
`429`	Rate limited — 1,000 daily requests exceeded
`500`	Server error