API ExplorerLabour Market Insights
Occupation snapshot
Interactive reference and playground for GET /v1/insights/occupations/{code}.
Authorization
apiKey AuthorizationBearer <token>
API key issued from the JobsPipe dashboard, prefixed jp_live_, sent as a bearer token in the Authorization header. Keys are read-only and scoped: jobs:read grants POST /v1/jobs/search, stack:read grants POST /v1/stack/scan. No scope grants write access to JobsPipe data.
In: header
Path Parameters
code*string
ISCO-08 occupation code: 4 digits exact, or 1-3 digits to roll up a group.
Query Parameters
window_days?integer
Look-back window over posting dates, in days.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/insights/occupations/string"{ "occupation_code": "string", "occupation_label": "string", "window_days": 0, "count": 0, "remote_share": 0, "top_companies": [ { "value": "string", "label": "string", "count": 0, "share": 0 } ], "top_titles": [ { "value": "string", "label": "string", "count": 0, "share": 0 } ], "countries": [ { "value": "string", "label": "string", "count": 0, "share": 0 } ]}{ "error": "string", "message": "string"}{ "error": "string", "message": "string"}{ "error": "string", "message": "string"}{ "error": "rate_limited", "limit": 0, "count": 0}