API Documentation

Build with our REST API to search jobs and prepare truthful, candidate-reviewed applications — for people and agents.

Base URL: https://aidevboard.com/api/v1

Create Candidate Access Employer pilot terms

Rate Limits

API responses include rate limit headers and an X-API-Tier header where applicable:

Anonymous: open public read access with an hourly IP throttle for abuse protection.
Free key: optional keyed identity for recurring agents and keyed hourly throttling.
Employer outcome pilot: /api/v1/catalog exposes one owner-reviewed program. It becomes billable only after an independently confirmed interview.

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-API-Tier. Hourly throttles return 429; monthly billable quota and API Pro paywalling are disabled.

Public Endpoints (No Auth)

GET /api/v1/jobs

Search and list active job postings. Returns paginated results with metadata.

Parameter	Type	Description
q	string	Full-text search (title, description, company, and tags)
tags	string	Comma-separated tags (e.g., llm,pytorch,python)
type	string	full-time, part-time, contract, freelance (alias: job_type)
level	string	junior, mid, senior, lead, principal
location	string	Filter by location (partial match)
workplace	string	remote, hybrid, onsite (also accepts remote=true)
global_remote	boolean	true returns only roles explicitly open worldwide
remote_scope	string	global, restricted, unknown, not_remote
company	string	Company slug (e.g., openai, anthropic) — returns only that company's jobs
salary_min	int	Minimum salary in USD/year (e.g., 200000)
salary_max	int	Maximum salary in USD/year — range overlap
salary_floor_min	int	Strict floor: job's minimum salary must be ≥ this value
page	int	Page number (default: 1)
limit	int	Results per page (default: 20, max: 50)

curl https://aidevboard.com/api/v1/jobs?tags=llm,pytorch&level=senior&workplace=remote

GET /api/v1/jobs/{id-or-slug}

Get a specific job by ID.

curl https://aidevboard.com/api/v1/jobs/research-engineer-performance-rl-2f0da25a

GET /api/v1/jobs/{id-or-slug}/similar

Find jobs similar to a given job, scored by tag overlap, workplace, level, and job type match.

Param	Type	Description
limit	int	Max results (1-20, default 5)

curl https://aidevboard.com/api/v1/jobs/research-engineer-performance-rl-2f0da25a/similar?limit=5

POST /api/v1/jobs/match

Match jobs to a candidate profile. Returns ranked results scored by skill overlap, salary fit, and preferences. Recommended for agentic job search.

Field	Type	Description
skills required	string[]	Candidate skills (e.g., ["python", "llm", "pytorch"])
salary_min	int	Desired minimum salary (USD/year)
salary_max	int	Desired maximum salary (USD/year)
workplace	string	remote, hybrid, onsite
level	string	junior, mid, senior, lead, principal
limit	int	Max results (default: 20, max: 50)

curl -X POST https://aidevboard.com/api/v1/jobs/match \
  -H "Content-Type: application/json" \
  -d '{"skills":["go","backend","payments"],"salary_min":200000,"workplace":"remote"}'

Scoring & Example Response

Scoring: +2 per matching tag, +3 salary overlap, +2 workplace match, +1 level match, +1 per skill in description.

{
  "matches": [
    {
      "job": {
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "title": "Senior Backend Engineer",
        "company_name": "Cursor",
        "salary_min": 250000,
        "salary_max": 380000,
        "tags": ["go", "backend", "llm"],
        "workplace": "remote"
      },
      "match_score": 12,
      "matched_tags": ["go", "backend"],
      "match_reasons": ["2 tag matches", "salary overlap", "workplace match"]
    }
  ],
  "total": 47
}

GET /api/v1/tags

List popular tags with job counts.

curl https://aidevboard.com/api/v1/tags

GET /api/v1/stats

AI developer job market statistics: salary benchmarks, tag trends, company rankings, workplace and experience breakdowns. Updated daily.

curl https://aidevboard.com/api/v1/stats

GET /api/v1/companies

List all companies with active job listings, including job counts and average salaries.

curl https://aidevboard.com/api/v1/companies

Returns: company slug, name, website, job count, average salary, and salary data count for each company. Sorted by job count descending.

GET /api/v1/companies/{slug}

Get a specific company's details and all active job listings.

curl https://aidevboard.com/api/v1/companies/anthropic

GET /api/v1/salary-trends

Historical salary data with daily snapshots. Filter by tag, level, or location.

Parameter	Type	Description
tag	string	Filter by tag (e.g., llm, pytorch)
level	string	Filter by level (senior, mid, lead, etc.)
location	string	Filter by location
days	int	Number of days to return (default: 90)

curl https://aidevboard.com/api/v1/salary-trends?tag=llm&days=30

Example Response

{
  "days": 30,
  "snapshots": [
    {
      "date": "2026-04-16T00:00:00Z",
      "total_active_jobs": 7477,
      "jobs_with_salary": 2896,
      "avg_salary": 225489,
      "median_salary": 213500,
      "p25_salary": 180700,
      "p75_salary": 260050,
      "avg_salary_remote": 218706,
      "avg_salary_onsite": 217433,
      "avg_salary_hybrid": 256480,
      "new_jobs_today": 565
    }
  ]
}

GET /api/v1/pricing

List available pricing tiers and features.

Registration

POST /api/v1/register/company

curl -X POST https://aidevboard.com/api/v1/register/company \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme AI","email":"hire@acme.ai","website":"https://acme.ai"}'

POST /api/v1/register

Public discovery needs no key. For agent actions, the human candidate can use the candidate-controlled setup page, or call this endpoint directly. The raw key is returned once; a 24-hour email link verifies the identity required for applications and interview attestations. Legacy alias: /api/v1/register/developer.

curl -X POST https://aidevboard.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Smith","email":"jane@dev.com"}'

Company API (Requires Company API Key)

Pass your API key via X-API-Key header or Authorization: Bearer {key}.

POST /api/v1/company/jobs

Submit a job for owner review at $0. The role remains private until approved; this does not create a listing payment, ranking boost, or employer outcome-pilot activation.

curl -X POST https://aidevboard.com/api/v1/company/jobs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{
    "title": "Senior LLM Engineer",
    "description": "Build and deploy LLMs...",
    "requirements": "5+ years ML experience...",
    "salary_min": 200000,
    "salary_max": 350000,
    "location": "Remote",
    "job_type": "full-time",
    "experience_level": "senior",
    "tags": ["llm", "pytorch", "python"],
    "tier": "featured"
  }'

POST /api/v1/company/pay

Retired. This endpoint returns an outcome-only retirement response and cannot create a payment.

curl -X POST https://aidevboard.com/api/v1/company/pay \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{"job_id":"abc-123","tier":"featured"}'

GET /api/v1/company/jobs

List all jobs posted by your company.

GET /api/v1/company/jobs/{id}/applications

Get all applications for a specific job.

PATCH /api/v1/company/applications/{id}

Update application status (reviewed, shortlisted, rejected).

curl -X PATCH https://aidevboard.com/api/v1/company/applications/abc-123 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{"status":"shortlisted"}'

Developer API (Requires Developer API Key)

POST /api/v1/developer/apply/{job_id}

Submit only the exact compiled artifact an email-verified candidate has reviewed and approved. First compile and approve through MCP; this endpoint consumes that single-use authorization. Candidate charge: $0.

curl -X POST https://aidevboard.com/api/v1/developer/apply/abc-123 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{
    "compiled_artifact_id": "adb_art_candidate_reviewed",
    "compiled_artifact_hash": "exact_sha256_from_the_visible_artifact",
    "compiled_authorization_id": "adb_auth_single_use",
    "principal_authorized": true
  }'

POST /api/v1/developer/resend-verification

Send a fresh one-time candidate email verification link. Requires the developer API key.

Employer outcome pilot

Read access and candidate application preparation are free. /api/v1/catalog, /api/v1/quote, and /api/v1/checkout expose only the Verified Interview Pilot: an owner activation review, never an automatic charge, candidate action, or ranking change.

Machine-Readable Formats

For AI agents and automated tools:

Resource	URL
OpenAPI 3.0 Spec	/openapi.yaml (also: /openapi.json)
LLM Instructions	/llms.txt
MCP Server	/mcp (Streamable HTTP transport)
MCP Manifest	/.well-known/mcp.json
Agent Discovery	/.well-known/agent.json
AI Plugin Manifest	/.well-known/ai-plugin.json
RSS Feed	/feed.xml · per-tag: `/feed/tag/{tag}.xml` · per-company: `/feed/company/{slug}.xml`
Aggregator Feed	/feed/indeed.xml (Indeed/ZipRecruiter format)
Sitemap	/sitemap.xml
Embed Widget	/widget-docs (drop-in JS — live feed on any site)
Hiring Badges	`/badge/{slug}.svg` (dynamic SVG for README/footer)

MCP Server

AI Dev Jobs is available as an MCP server. AI agents can search jobs, look up companies, and retrieve salary data through the Model Context Protocol.

SETUP One-line install — any MCP client

curl -fsSL https://aidevboard.com/install | sh

Runs claude mcp add if Claude Code is installed, or codex mcp add if Codex CLI is installed. Prints Cursor, Cline, and Continue snippets otherwise.

SETUP Manual — Claude Code / Codex CLI

claude mcp add --transport http aidevjobs https://aidevboard.com/mcp
codex mcp add aidevjobs --url https://aidevboard.com/mcp

Available tools:

Tool	Description
search_jobs	Search and filter AI/ML jobs by keyword, location, workplace, salary, tags, and experience level
get_job	Get full details for a specific job by ID or slug
list_companies	List all companies with active AI job listings
get_company	Detailed company profile: open roles, salary range, workplace distribution, top skills
get_stats	Get market statistics: salary ranges, top tags, hiring trends
match_jobs	Rank jobs against a candidate profile (skills, salary, workplace, level)
get_salary_data	Salary benchmarks by tag, level, workplace, or company (avg, median, p25, p75)
list_tags	All available job tags/skills with active job counts
get_trending_companies	Companies posting the most AI/ML jobs in a trailing window
get_similar_jobs	Near-match active jobs for a specific job ID or slug
list_products	The employer-funded Verified Interview Pilot only
quote_product	Exact pilot terms, cap, and non-binding activation-review contract
start_checkout	Owner activation-review handoff; it cannot create a charge or candidate action

The MCP server uses Streamable HTTP transport at https://aidevboard.com/mcp. No authentication required. Listed in the official MCP registry as com.aidevboard/jobs.