Market-wide demand for a role

Market-wide (no single-company scope) active-req demand series for function / geo -- LinkedIn-excluded by construction (ATS tenants plus public job boards and aggregators).

An unresolvable function -- anything that is neither a function name nor a function taxonomy id -- is rejected with 422 instead of returning a silently-empty result.

Requires the read scope.

get/v1/markets/role-demand

Request

  • Base URL: https://api.reqbeat.com
  • URL: https://api.reqbeat.com/v1/markets/role-demand
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

functionstring nullable

Function whose market demand to measure: its name as /v1/jobs/search serves it in function_name, e.g. 'Software & IT', or its taxonomy id as served in function, e.g. '54f81306-3000-5c4a-a088-dca4350b19ff'. A name covers every function id that serves it; an id matches that one id. Anything else is rejected with 422, which lists the names.

geostring nullable

Country name to restrict the demand measurement to, e.g. 'United States'. Matched against the geocoder's pinned list.

sincestring date-time nullable

ISO-8601 timestamp lower bound on the demand window, e.g. '2026-01-01T00:00:00Z'. Omit for no lower bound.

Headers

Idempotency-Keystring nullable

Response

Successful Response

as_ofstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.