API Documentation

Access AI displacement data programmatically

Overview

The displacement.ai API provides programmatic access to our AI job displacement risk data. Use it to integrate risk scores, job analyses, and trend data into your applications.

Base URL

https://displacement.ai/api/v1

Authentication

The free tier requires no authentication. Simply make requests to the API endpoints.

No API key required

Start using the API immediately with no signup. For higher rate limits, contact us about Pro and Enterprise tiers.

Rate Limits

Rate limits are applied per IP address. Exceeding limits returns a 429 status code.

Tier	Rate Limit	Price	Features
Free	100 requests/day	$0	All endpoints, attribution required
Pro	10,000 requests/day	Contact us	Priority support, no attribution
Enterprise	Unlimited	Contact us	SLA, dedicated support, custom integrations

For Pro or Enterprise access, contact us

Response Format

All responses are returned in JSON format. Successful responses include the requested data. Error responses include an error message and code.

Success Response

{
  "success": true,
  "data": { ... }
}

Error Response

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Job not found"
  }
}

Endpoints

GET/api/v1/jobs

Retrieve a paginated list of all jobs with their displacement risk scores.

Parameters

Name	Type	Required	Description
`limit`	integer	No	Number of jobs to return (default: 20, max: 100)
`offset`	integer	No	Number of jobs to skip for pagination (default: 0)
`category`	string	No	Filter by category slug (e.g., "technology", "healthcare")
`min_risk`	integer	No	Minimum risk score filter (0-100)
`max_risk`	integer	No	Maximum risk score filter (0-100)

Response

{
  "success": true,
  "data": {
    "jobs": [
      {
        "slug": "software-engineer",
        "title": "Software Engineer",
        "category": "Technology",
        "risk_score": 67,
        "risk_level": "high",
        "summary": "AI coding assistants are transforming...",
        "updated_at": "2026-01-15T00:00:00Z"
      },
      ...
    ],
    "total": 5000,
    "limit": 20,
    "offset": 0
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/jobs?limit=10&offset=0"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/jobs?limit=10&offset=0');
const data = await response.json();
console.log(data.jobs);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/jobs', params={
    'limit': 10,
    'offset': 0
})
data = response.json()
print(data['jobs'])

GET/api/v1/jobs/{slug}

Retrieve detailed analysis for a specific job by its slug.

Parameters

Name	Type	Required	Description
`slug`	string	Yes	The job slug (e.g., "software-engineer", "data-analyst")

Response

{
  "success": true,
  "data": {
    "slug": "software-engineer",
    "title": "Software Engineer",
    "category": "Technology",
    "risk_score": 67,
    "risk_level": "high",
    "timeline": "3-5 years",
    "summary": "Software engineering faces significant...",
    "vulnerable_tasks": [
      "Writing boilerplate code",
      "Code review for common patterns",
      "Bug fixing in straightforward cases"
    ],
    "safe_tasks": [
      "System architecture design",
      "Cross-functional collaboration",
      "Complex problem solving"
    ],
    "skills_to_develop": [
      "AI/ML integration",
      "Prompt engineering",
      "System design"
    ],
    "transition_paths": [
      {
        "title": "AI/ML Engineer",
        "risk_score": 35,
        "transition_difficulty": "medium"
      },
      {
        "title": "Technical Architect",
        "risk_score": 28,
        "transition_difficulty": "medium"
      }
    ],
    "created_at": "2025-06-01T00:00:00Z",
    "updated_at": "2026-01-15T00:00:00Z"
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/jobs/software-engineer"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/jobs/software-engineer');
const job = await response.json();
console.log(job.risk_score);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/jobs/software-engineer')
job = response.json()
print(job['risk_score'])

GET/api/v1/categories

Retrieve a list of all job categories with aggregate statistics.

Response

{
  "success": true,
  "data": {
    "categories": [
      {
        "slug": "technology",
        "name": "Technology",
        "job_count": 450,
        "average_risk": 58,
        "highest_risk_job": "Data Entry Clerk",
        "lowest_risk_job": "AI Ethics Researcher"
      },
      {
        "slug": "healthcare",
        "name": "Healthcare",
        "job_count": 320,
        "average_risk": 34,
        "highest_risk_job": "Medical Transcriptionist",
        "lowest_risk_job": "Surgeon"
      },
      ...
    ],
    "total": 30
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/categories"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/categories');
const data = await response.json();
console.log(data.categories);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/categories')
data = response.json()
print(data['categories'])

GET/api/v1/index

Retrieve the current Displacement Index with aggregate statistics across all jobs.

Response

{
  "success": true,
  "data": {
    "displacement_index": {
      "current_value": 47.3,
      "previous_value": 45.8,
      "change": 1.5,
      "updated_at": "2026-01-31T00:00:00Z"
    },
    "statistics": {
      "total_jobs": 5000,
      "average_risk": 47.3,
      "median_risk": 44,
      "jobs_by_risk_level": {
        "critical": 312,
        "high": 1245,
        "medium": 1876,
        "low": 1567
      }
    },
    "trending": {
      "increasing_risk": [
        { "title": "Paralegal", "change": 8.2 },
        { "title": "Financial Analyst", "change": 6.5 }
      ],
      "decreasing_risk": [
        { "title": "AI Trainer", "change": -4.1 },
        { "title": "Robotics Technician", "change": -2.8 }
      ]
    },
    "methodology_version": "2.1",
    "next_update": "2026-02-28T00:00:00Z"
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/index"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/index');
const index = await response.json();
console.log(index.average_risk);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/index')
index = response.json()
print(index['average_risk'])

Error Codes

HTTP Status	Error Code	Description
400	`BAD_REQUEST`	Invalid request parameters
404	`NOT_FOUND`	Requested resource not found
429	`RATE_LIMITED`	Rate limit exceeded, try again later
500	`INTERNAL_ERROR`	Internal server error

Embeddable Risk Badge

Add AI displacement risk badges to your career site, job board, or HR portal.

Widget Configurator Full Documentation

Live Preview

Embed Code

Copy and paste this code into your website. Replace software-engineer with any job slug.

<iframe
  src="https://displacement.ai/api/embed/software-engineer?theme=dark&size=medium"
  width="300"
  height="150"
  frameborder="0"
  title="AI Displacement Risk Badge"
  style="border-radius: 8px;"
></iframe>

Customization Options

Customize the badge with URL parameters:

theme: dark or light
size: small (200x100), medium (300x150), or large (400x200)

Free for Non-Commercial Use

Embed badges for free on personal sites, educational resources, and non-profits. For commercial use, contact us

Attribution

Free tier usage requires attribution. Include the following in your application or website:

Powered by <a href="https://displacement.ai">displacement.ai</a>

SDKs

Coming Soon

Official SDKs for Python, JavaScript/TypeScript, and Go are in development. Contact us to sign up for updates.

Support

For API support, bug reports, or feature requests:

Contact API Support
Status page: status.displacement.ai

Overview

The displacement.ai API provides programmatic access to our AI job displacement risk data. Use it to integrate risk scores, job analyses, and trend data into your applications.

Base URL

https://displacement.ai/api/v1

Authentication

The free tier requires no authentication. Simply make requests to the API endpoints.

No API key required

Start using the API immediately with no signup. For higher rate limits, contact us about Pro and Enterprise tiers.

Rate Limits

Rate limits are applied per IP address. Exceeding limits returns a 429 status code.

Tier	Rate Limit	Price	Features
Free	100 requests/day	$0	All endpoints, attribution required
Pro	10,000 requests/day	Contact us	Priority support, no attribution
Enterprise	Unlimited	Contact us	SLA, dedicated support, custom integrations

For Pro or Enterprise access, contact us

Response Format

All responses are returned in JSON format. Successful responses include the requested data. Error responses include an error message and code.

Success Response

{
  "success": true,
  "data": { ... }
}

Error Response

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Job not found"
  }
}

Endpoints

GET/api/v1/jobs

Retrieve a paginated list of all jobs with their displacement risk scores.

Parameters

Name	Type	Required	Description
`limit`	integer	No	Number of jobs to return (default: 20, max: 100)
`offset`	integer	No	Number of jobs to skip for pagination (default: 0)
`category`	string	No	Filter by category slug (e.g., "technology", "healthcare")
`min_risk`	integer	No	Minimum risk score filter (0-100)
`max_risk`	integer	No	Maximum risk score filter (0-100)

Response

{
  "success": true,
  "data": {
    "jobs": [
      {
        "slug": "software-engineer",
        "title": "Software Engineer",
        "category": "Technology",
        "risk_score": 67,
        "risk_level": "high",
        "summary": "AI coding assistants are transforming...",
        "updated_at": "2026-01-15T00:00:00Z"
      },
      ...
    ],
    "total": 5000,
    "limit": 20,
    "offset": 0
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/jobs?limit=10&offset=0"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/jobs?limit=10&offset=0');
const data = await response.json();
console.log(data.jobs);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/jobs', params={
    'limit': 10,
    'offset': 0
})
data = response.json()
print(data['jobs'])

GET/api/v1/jobs/{slug}

Retrieve detailed analysis for a specific job by its slug.

Parameters

Name	Type	Required	Description
`slug`	string	Yes	The job slug (e.g., "software-engineer", "data-analyst")

Response

{
  "success": true,
  "data": {
    "slug": "software-engineer",
    "title": "Software Engineer",
    "category": "Technology",
    "risk_score": 67,
    "risk_level": "high",
    "timeline": "3-5 years",
    "summary": "Software engineering faces significant...",
    "vulnerable_tasks": [
      "Writing boilerplate code",
      "Code review for common patterns",
      "Bug fixing in straightforward cases"
    ],
    "safe_tasks": [
      "System architecture design",
      "Cross-functional collaboration",
      "Complex problem solving"
    ],
    "skills_to_develop": [
      "AI/ML integration",
      "Prompt engineering",
      "System design"
    ],
    "transition_paths": [
      {
        "title": "AI/ML Engineer",
        "risk_score": 35,
        "transition_difficulty": "medium"
      },
      {
        "title": "Technical Architect",
        "risk_score": 28,
        "transition_difficulty": "medium"
      }
    ],
    "created_at": "2025-06-01T00:00:00Z",
    "updated_at": "2026-01-15T00:00:00Z"
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/jobs/software-engineer"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/jobs/software-engineer');
const job = await response.json();
console.log(job.risk_score);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/jobs/software-engineer')
job = response.json()
print(job['risk_score'])

GET/api/v1/categories

Retrieve a list of all job categories with aggregate statistics.

Response

{
  "success": true,
  "data": {
    "categories": [
      {
        "slug": "technology",
        "name": "Technology",
        "job_count": 450,
        "average_risk": 58,
        "highest_risk_job": "Data Entry Clerk",
        "lowest_risk_job": "AI Ethics Researcher"
      },
      {
        "slug": "healthcare",
        "name": "Healthcare",
        "job_count": 320,
        "average_risk": 34,
        "highest_risk_job": "Medical Transcriptionist",
        "lowest_risk_job": "Surgeon"
      },
      ...
    ],
    "total": 30
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/categories"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/categories');
const data = await response.json();
console.log(data.categories);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/categories')
data = response.json()
print(data['categories'])

GET/api/v1/index

Retrieve the current Displacement Index with aggregate statistics across all jobs.

Response

{
  "success": true,
  "data": {
    "displacement_index": {
      "current_value": 47.3,
      "previous_value": 45.8,
      "change": 1.5,
      "updated_at": "2026-01-31T00:00:00Z"
    },
    "statistics": {
      "total_jobs": 5000,
      "average_risk": 47.3,
      "median_risk": 44,
      "jobs_by_risk_level": {
        "critical": 312,
        "high": 1245,
        "medium": 1876,
        "low": 1567
      }
    },
    "trending": {
      "increasing_risk": [
        { "title": "Paralegal", "change": 8.2 },
        { "title": "Financial Analyst", "change": 6.5 }
      ],
      "decreasing_risk": [
        { "title": "AI Trainer", "change": -4.1 },
        { "title": "Robotics Technician", "change": -2.8 }
      ]
    },
    "methodology_version": "2.1",
    "next_update": "2026-02-28T00:00:00Z"
  }
}

Examples

curl

curl "https://displacement.ai/api/v1/index"

JavaScript

const response = await fetch('https://displacement.ai/api/v1/index');
const index = await response.json();
console.log(index.average_risk);

Python

import requests

response = requests.get('https://displacement.ai/api/v1/index')
index = response.json()
print(index['average_risk'])

Error Codes

HTTP Status	Error Code	Description
400	`BAD_REQUEST`	Invalid request parameters
404	`NOT_FOUND`	Requested resource not found
429	`RATE_LIMITED`	Rate limit exceeded, try again later
500	`INTERNAL_ERROR`	Internal server error

Embeddable Risk Badge

Add AI displacement risk badges to your career site, job board, or HR portal.

Widget Configurator Full Documentation

Live Preview

Embed Code

Copy and paste this code into your website. Replace software-engineer with any job slug.

<iframe
  src="https://displacement.ai/api/embed/software-engineer?theme=dark&size=medium"
  width="300"
  height="150"
  frameborder="0"
  title="AI Displacement Risk Badge"
  style="border-radius: 8px;"
></iframe>

Customization Options

Customize the badge with URL parameters:

theme: dark or light
size: small (200x100), medium (300x150), or large (400x200)

Free for Non-Commercial Use

Embed badges for free on personal sites, educational resources, and non-profits. For commercial use, contact us

Attribution

Free tier usage requires attribution. Include the following in your application or website:

Powered by <a href="https://displacement.ai">displacement.ai</a>

SDKs

Coming Soon

Official SDKs for Python, JavaScript/TypeScript, and Go are in development. Contact us to sign up for updates.

Support

For API support, bug reports, or feature requests:

Contact API Support
Status page: status.displacement.ai