Access AI displacement data programmatically with our RESTful API.
The displacement.ai API provides programmatic access to AI job displacement risk data for over 500 occupations. Use it to integrate risk scores, detailed job analyses, and aggregate statistics into your applications.
All API requests should be made to the following base URL:
https://displacement.ai/api/v1The API uses HTTPS for all requests. HTTP requests will be redirected.
Make your first API request in seconds. No authentication required for the free tier.
"text-green-600">curl "https://displacement.ai/api/v1/jobs/software-engineer"Start using the API immediately. For higher rate limits, see our pricing plans.
The free tier requires no authentication. Pro and Enterprise users authenticate using API keys.
No authentication required. Just make requests to the API endpoints.
Include your API key in the X-API-Key header:
"text-green-600">curl "text-blue-600">-H "X-API-Key: your_api_key" "https://displacement.ai/api/v1/jobs"Rate limits are applied per IP address (free tier) or per API key (Pro/Enterprise). Exceeding limits returns HTTP 429.
| Tier | Limit | Price | Features |
|---|---|---|---|
| Free | 100 requests/day | $0 | All endpoints, Attribution required |
| Pro | 10,000 requests/day | $49/month | All endpoints, No attribution required |
| Enterprise | Unlimited | Custom | All endpoints, No attribution required |
Every response includes headers with your current rate limit status:
X-RateLimit-Limit: Maximum requests per windowX-RateLimit-Remaining: Requests remaining in current windowX-RateLimit-Reset: Seconds until the window resetsAll responses are returned in JSON format with a consistent structure.
{
"success": true,
"data": { ... },
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}{
"success": false,
"error": "Job not found: invalid-slug",
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/jobsRetrieve a paginated list of all jobs with their AI displacement risk scores. Supports filtering by category and pagination.
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Number of jobs to return (default: 20) |
offset | integer | No | Number of jobs to skip for pagination (default: 0) |
category | string | No | Filter by category slug (e.g., "technology", "healthcare") |
"text-green-600">curl "https://displacement.ai/api/v1/jobs?limit=10&offset=0"{
"success": true,
"data": {
"jobs": [
{
"slug": "software-engineer",
"title": "Software Engineer",
"category": "Technology",
"riskScore": 67,
"updatedAt": "2026-01-30T00:00:00Z"
},
{
"slug": "data-analyst",
"title": "Data Analyst",
"category": "Technology",
"riskScore": 72,
"updatedAt": "2026-01-30T00:00:00Z"
}
],
"pagination": {
"total": 500,
"limit": 20,
"offset": 0,
"hasMore": true
}
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/jobs/{slug}Retrieve detailed AI displacement analysis for a specific job by its slug. Includes risk score, vulnerable tasks, safe tasks, skill recommendations, and career transition paths.
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | The job slug (e.g., "software-engineer", "data-analyst") |
"text-green-600">curl "https://displacement.ai/api/v1/jobs/software-engineer"{
"success": true,
"data": {
"job": {
"slug": "software-engineer",
"title": "Software Engineer",
"category": "Technology",
"riskScore": 67,
"analysis": {
"summary": "Software engineering faces significant transformation as AI coding assistants become more capable. While routine coding tasks are increasingly automated, the need for system architecture, complex problem-solving, and human-AI collaboration creates new opportunities.",
"timeline": "3-5 years for significant task automation",
"tasksAtRisk": [
"Writing boilerplate code",
"Code review for common patterns",
"Bug fixing in straightforward cases",
"Documentation generation"
],
"skillsAtRisk": [
"Basic coding syntax",
"Repetitive debugging",
"Simple CRUD operations"
],
"safeSkills": [
"System architecture design",
"Cross-functional collaboration",
"Complex problem decomposition",
"AI/ML integration expertise"
],
"recommendations": [
"Master AI-assisted development workflows",
"Focus on system design and architecture",
"Develop expertise in AI/ML engineering",
"Build strong communication skills"
],
"alternativeCareers": [
{
"title": "AI/ML Engineer",
"riskScore": 35
},
{
"title": "Technical Architect",
"riskScore": 28
},
{
"title": "DevOps Engineer",
"riskScore": 45
}
],
"industryOutlook": "The software industry continues to grow, but the nature of engineering roles is shifting toward oversight, architecture, and AI collaboration."
},
"createdAt": "2025-06-01T00:00:00Z",
"updatedAt": "2026-01-30T00:00:00Z"
}
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/categoriesRetrieve a list of all job categories with aggregate statistics including job count and average risk score.
"text-green-600">curl "https://displacement.ai/api/v1/categories"{
"success": true,
"data": {
"categories": [
{
"slug": "technology",
"name": "Technology",
"jobCount": 85,
"averageRisk": 58
},
{
"slug": "healthcare",
"name": "Healthcare",
"jobCount": 62,
"averageRisk": 34
},
{
"slug": "finance",
"name": "Finance",
"jobCount": 48,
"averageRisk": 61
}
],
"total": 15
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/indexRetrieve the current Displacement Index with aggregate statistics across all analyzed jobs. Includes risk distribution, highest/lowest risk jobs, and trending data.
"text-green-600">curl "https://displacement.ai/api/v1/index"{
"success": true,
"data": {
"index": {
"date": "2026-01-31",
"overallRiskScore": 47,
"totalJobsAnalyzed": 500,
"totalCategories": 15,
"riskDistribution": {
"low": 125,
"medium": 187,
"high": 124,
"critical": 64
},
"methodology": "displacement.ai Displacement Index v1.0",
"methodologyUrl": "https://displacement.ai/methodology"
},
"categories": [
{
"slug": "technology",
"name": "Technology",
"jobCount": 85,
"averageRisk": 58
}
],
"highestRisk": [
{
"slug": "telemarketer",
"title": "Telemarketer",
"riskScore": 94
},
{
"slug": "data-entry-clerk",
"title": "Data Entry Clerk",
"riskScore": 91
}
],
"lowestRisk": [
{
"slug": "surgeon",
"title": "Surgeon",
"riskScore": 12
},
{
"slug": "psychologist",
"title": "Psychologist",
"riskScore": 15
}
],
"trending": [
{
"slug": "ai-engineer",
"title": "AI Engineer",
"riskScore": 28
}
]
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/export/csvExport all job displacement data as a CSV file. Useful for data analysis, research, and integration with spreadsheet applications. Requires attribution for free tier.
This endpoint returns a CSV file directly instead of JSON. The file includes all job data with headers for analysis and research.
"text-green-600">curl "https://displacement.ai/api/v1/export/csv" "text-blue-600">-o displacement-data.csv{
"note": "Returns a CSV file with headers: title, slug, category, risk_score, summary, timeline, skills_at_risk, safe_skills, recommendations, updated_at",
"contentType": "text/csv",
"filename": "displacement-index-2026-01-31.csv"
}/api/v1/searchSearch for jobs by title. Returns matching jobs ordered by relevance. Minimum query length is 2 characters.
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (minimum 2 characters) |
limit | integer | No | Maximum number of results to return (default: 20) |
mode | string | No | Search mode: "full" (default) or "autocomplete" (default: full) |
"text-green-600">curl "https://displacement.ai/api/v1/search?q=engineer&limit=5"{
"success": true,
"data": {
"query": "engineer",
"mode": "full",
"results": [
{
"slug": "software-engineer",
"title": "Software Engineer",
"category": "Technology",
"riskScore": 67
},
{
"slug": "mechanical-engineer",
"title": "Mechanical Engineer",
"category": "Engineering",
"riskScore": 45
}
],
"count": 2
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/statsGet comprehensive aggregate statistics about all analyzed jobs including risk distribution, top categories, and highest/lowest risk jobs.
"text-green-600">curl "https://displacement.ai/api/v1/stats"{
"success": true,
"data": {
"summary": {
"totalJobs": 94,
"totalCategories": 12,
"averageRiskScore": 52,
"medianRiskScore": 50,
"minRiskScore": 15,
"maxRiskScore": 92,
"lastUpdated": "2026-01-30T10:00:00Z"
},
"riskDistribution": {
"counts": {
"low": 25,
"medium": 35,
"high": 24,
"critical": 10
},
"percentages": {
"low": 27,
"medium": 37,
"high": 26,
"critical": 10
}
},
"topCategories": [
{
"name": "Technology",
"slug": "technology",
"jobCount": 24,
"averageRisk": 58
}
],
"highestRiskJobs": [
{
"slug": "telemarketer",
"title": "Telemarketer",
"riskScore": 92,
"category": "Sales"
}
],
"lowestRiskJobs": [
{
"slug": "surgeon",
"title": "Surgeon",
"riskScore": 15,
"category": "Healthcare"
}
]
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}/api/v1/compareCompare 2-5 jobs side by side. Returns detailed comparison metrics, common risk factors, and ranking. Useful for career transition planning.
| Name | Type | Required | Description |
|---|---|---|---|
jobs | string | Yes | Comma-separated job slugs (2-5 jobs) |
Use this endpoint to help users compare their current job against potential career transitions. The response includes risk rankings and common skill gaps.
"text-green-600">curl "https://displacement.ai/api/v1/compare?jobs=software-engineer,data-scientist,product-manager"{
"success": true,
"data": {
"jobs": [
{
"slug": "software-engineer",
"title": "Software Engineer",
"category": "Technology",
"riskScore": 67,
"analysis": {
"summary": "...",
"timeline": "5-7 years",
"tasksAtRisk": [],
"safeSkills": []
}
},
{
"slug": "data-scientist",
"title": "Data Scientist",
"category": "Technology",
"riskScore": 55,
"analysis": {
"summary": "...",
"timeline": "7-10 years",
"tasksAtRisk": [],
"safeSkills": []
}
}
],
"metrics": {
"averageRiskScore": 61,
"maxRiskScore": 67,
"minRiskScore": 55,
"riskRange": 12,
"safestJob": "data-scientist",
"riskiestJob": "software-engineer"
},
"commonalities": {
"tasksAtRisk": [
"Data analysis"
],
"safeSkills": [
"Problem solving",
"Communication"
]
},
"ranking": [
{
"rank": 1,
"slug": "software-engineer",
"title": "Software Engineer",
"riskScore": 67
},
{
"rank": 2,
"slug": "data-scientist",
"title": "Data Scientist",
"riskScore": 55
}
]
},
"source": "displacement.ai",
"timestamp": "2026-01-31T12:00:00Z"
}The API uses standard HTTP status codes and includes error details in the response body.
| Status | Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Invalid request parameters or malformed request |
| 401 | UNAUTHORIZED | Missing or invalid API key (Pro/Enterprise only) |
| 403 | FORBIDDEN | API key does not have access to this resource |
| 404 | NOT_FOUND | Requested resource does not exist |
| 429 | RATE_LIMITED | Rate limit exceeded. Check X-RateLimit-Reset header for reset time |
| 500 | INTERNAL_ERROR | Internal server error. Contact support if this persists |
| 503 | SERVICE_UNAVAILABLE | Service temporarily unavailable. Try again later |
Add AI displacement risk badges to your career site, job board, or HR portal. Free for non-commercial use.
"text-blue-600">class="text-neutral-400"><iframe
"text-blue-600">src="https://displacement.ai/api/embed/software-engineer"
"text-blue-600">width="300"
"text-blue-600">height="150"
"text-blue-600">frameborder="0"
"text-blue-600">title="AI Displacement Risk Badge"
"text-blue-600">class="text-neutral-400">>"text-blue-600">class="text-neutral-400"></iframe"text-blue-600">class="text-neutral-400">>Replace software-engineer with any job slug from our directory.
Official SDKs for Python, JavaScript/TypeScript, and Go are in development. Contact us to sign up for updates.
Need help? We are here for you.