API Documentation

Free REST API access to all AIJobWatch datasets. No authentication required.

Base URL: https://www.aijobwatch.org/api/v1

GET/api/v1/occupations

Returns AI risk scores and employment data for all occupations.

Name	Type	Default	Description
sort	string	riskScore	Field to sort by (riskScore, employment, medianWage, title)
order	string	desc	Sort order (asc, desc)
limit	number	50	Results per page (1–200)
offset	number	0	Number of results to skip

curl "https://www.aijobwatch.org/api/v1/occupations?sort=riskScore&order=desc&limit=10"

GET/api/v1/industries

Returns sector-level automation risk and employment data for NAICS industries.

Name	Type	Default	Description
sort	string	avgRiskScore	Field to sort by
order	string	desc	Sort order (asc, desc)
limit	number	50	Results per page
offset	number	0	Number of results to skip

curl "https://www.aijobwatch.org/api/v1/industries?sort=avgRiskScore&order=desc"

GET/api/v1/states

Returns state-level workforce vulnerability and employment data.

Name	Type	Default	Description
sort	string	avgRiskScore	Field to sort by
order	string	desc	Sort order (asc, desc)
limit	number	51	Results per page
offset	number	0	Number of results to skip

curl "https://www.aijobwatch.org/api/v1/states?sort=avgRiskScore&order=desc&limit=10"

GET/api/v1/companies

Returns company-level AI layoff and restructuring data.

Name	Type	Default	Description
sort	string	totalLayoffs	Field to sort by
order	string	desc	Sort order (asc, desc)
limit	number	50	Results per page
offset	number	0	Number of results to skip

curl "https://www.aijobwatch.org/api/v1/companies?sort=totalLayoffs&order=desc&limit=5"

GET/api/v1/stats

Returns aggregate statistics: total occupations, average risk score, most/least at-risk occupations.

curl "https://www.aijobwatch.org/api/v1/stats"

Response Format

All endpoints return JSON with a consistent wrapper:

{
  "data": [ ... ],
  "meta": {
    "total": 200,
    "limit": 50,
    "offset": 0,
    "sort": "riskScore",
    "order": "desc"
  }
}

100 requests per minute per IP. If you need higher limits, contact us at info@thedataproject.ai.