# JobPostings API (https://jobpostingsapi.com)

> 9.9M+ Verified ATS & Corporate Career-Site Jobs (Redistributable), plus 9.9M+ Attributed Global Listings across 434 Sources.
> Unified JSON schema across Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Rippling, BambooHR, Personio, and enterprise career sites.
> Base API Gateway: https://api.jobpostingsapi.com
> Full Machine-Readable Reference for LLMs: https://jobpostingsapi.com/llms-full.txt
> OpenAPI 3.0 Spec: https://jobpostingsapi.com/openapi.json (and https://api.jobpostingsapi.com/openapi.json)

## Pricing & Record-Based Credit System (1 Credit = 1 Job Record)

- Unit Rule: **1 Credit = 1 Job Record Returned** (up to 50 jobs per call)
- Empty searches returning 0 jobs: **0 Credits ($0.00)**
- `GET /v1/jobs/count`: **1 Credit flat per call**
- `GET /v1/sources` & `GET /v1/tools/ats-detector`: **0 Credits (Free)**
- Free Trial: **500 Credits free** on sign-up (no credit card required, 12 RPM)
- Starter Plan: **$19/mo** -> 25,000 Credits/mo ($0.76 / 1K jobs, 60 RPM)
- Growth Plan: **$49/mo** -> 100,000 Credits/mo ($0.49 / 1K jobs, 180 RPM)
- Pro Plan: **$99/mo** -> 300,000 Credits/mo ($0.33 / 1K jobs, 300 RPM)
- Scale Plan: **$199/mo** -> 1,000,000 Credits/mo ($0.199 / 1K jobs, 600 RPM)
- Never-Expiring PAYG Packs: $25 (25k Credits), $50 (55k Credits), $100 (125k Credits), $300 (450k Credits)
- Refunds: payments from the last 14 days, up to the unused balance

## Latency SLA & Redistribution Licensing

- **Cached & Indexed ATS Queries**: `< 300 ms p50`
- **Live Uncached Long-Tail Pass-Through**: `2–8 s`
- **Redistribution Tagging**: Every record includes `source_type` (`ats_direct` | `career_site` | `job_board`) and `license_class` (`redistributable` | `attribution_required`).

## AI Agent & MCP Integration

- Complete Single-File LLM Reference: [llms-full.txt](https://jobpostingsapi.com/llms-full.txt)
- OpenAPI 3.0 JSON Specification: [openapi.json](https://jobpostingsapi.com/openapi.json)
- Free Company ATS & Board Token Detector: [ATS Detector](https://jobpostingsapi.com/tools/ats-detector)
- 434 Supported ATS & Career-Site Sources Directory: [Sources Directory](https://jobpostingsapi.com/sources)
- MCP Server for Claude Desktop, Cursor & Windsurf: `npx -y @jobpostingsapi/mcp-server` ([MCP Guide](https://jobpostingsapi.com/mcp))

## Use-Case Blueprints (/use-cases)

- [All Use-Case Blueprints](https://jobpostingsapi.com/use-cases)
- [B2B GTM Hiring Signals API: Detect Buying Intent from Live ATS Job Postings](https://jobpostingsapi.com/use-cases/gtm-hiring-signals-api): Trigger high-converting B2B outbound campaigns when target accounts open roles mentioning your tech stack, compliance tools, or executive initiatives across 434 ATS sources.
- [AI Recruiting Agent Data Feed: Structured ATS Jobs, Salaries & MCP Tools](https://jobpostingsapi.com/use-cases/ai-recruiting-agent-data-feed): Power AI career copilots, automated job-matching agents, and RAG pipelines with 9.9M+ structured ATS job postings, normalized salaries, full descriptions, and native MCP support.
- [Job Board Backfill API: Populate Niche Job Boards with 9.9M+ Direct ATS Postings](https://jobpostingsapi.com/use-cases/job-board-backfill-api): Launch and backfill vertical, remote, or regional job boards with 9.9M+ redistributable ATS job postings (Greenhouse, Lever, Ashby, Workday) and automatic closed-job cleanup.

## Competitor Comparisons (/compare)

- [All Provider Comparisons](https://jobpostingsapi.com/compare)
- [JobPostings API vs TheirStack](https://jobpostingsapi.com/compare/theirstack-alternative): Compare JobPostings API against TheirStack: start at $19/mo (or $25 non-expiring PAYG) instead of $200/mo. Access 9.9M+ verified ATS jobs + 9.9M+ attributed listings across 434 sources.
- [JobPostings API vs Coresignal](https://jobpostingsapi.com/compare/coresignal-jobs-api-alternative): Looking for a Coresignal Jobs API alternative? Get instant self-serve API keys, 500 free trial credits, 9.9M+ redistributable ATS jobs, and real-time /v1/feeds/* starting at $19/mo.
- [JobPostings API vs Fantastic.jobs](https://jobpostingsapi.com/compare/fantastic-jobs-api-alternative): Compare JobPostings API vs Fantastic.jobs: 434 ATS & global job sources, 9.9M+ redistributable ATS postings, real-time /v1/feeds/closed, and $19/mo or $25 PAYG pricing.
- [JobPostings API vs Apify Job Scrapers](https://jobpostingsapi.com/compare/apify-job-scrapers-alternative): Stop maintaining 20 separate Apify actors for Greenhouse, Lever, Workday, and Indeed. Query 434 normalized ATS & job sources in < 300ms via a single REST endpoint.
- [JobPostings API vs Indeed & LinkedIn Scrapers](https://jobpostingsapi.com/compare/indeed-linkedin-scraper-alternative): Why scrape Indeed or LinkedIn when you can get 9.9M+ job postings directly from employer ATS boards (Greenhouse, Lever, Ashby, Workday) with clean redistribution rights?
- [JobPostings API vs DIY Multi-ATS Integrations](https://jobpostingsapi.com/compare/greenhouse-lever-ashby-unified-api): Query Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Rippling, BambooHR, and 427 more ATS platforms through a single normalized JSON API with live ETag refresh.

## Top Supported ATS & Career Sources (/sources)

- [Browse All 434 Sources](https://jobpostingsapi.com/sources)
- [Greenhouse Job Feed API](https://jobpostingsapi.com/sources/greenhouse-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 9,655 Greenhouse employer boards via a single unified REST API.
- [Lever Job Feed API](https://jobpostingsapi.com/sources/lever-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 2,753 Lever employer boards via a single unified REST API.
- [Ashby Job Feed API](https://jobpostingsapi.com/sources/ashby-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 4,988 Ashby employer boards via a single unified REST API.
- [Workday Job Feed API](https://jobpostingsapi.com/sources/workday-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 9,744 Workday employer boards via a single unified REST API.
- [SmartRecruiters Job Feed API](https://jobpostingsapi.com/sources/smartrecruiters-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 12,667 SmartRecruiters employer boards via a single unified REST API.
- [Workable Job Feed API](https://jobpostingsapi.com/sources/workable-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 21,711 Workable employer boards via a single unified REST API.
- [BambooHR Job Feed API](https://jobpostingsapi.com/sources/bamboohr-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 19,055 BambooHR employer boards via a single unified REST API.
- [Rippling Job Feed API](https://jobpostingsapi.com/sources/rippling-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 3,375 Rippling employer boards via a single unified REST API.
- [Recruitee Job Feed API](https://jobpostingsapi.com/sources/recruitee-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 4,856 Recruitee employer boards via a single unified REST API.
- [Personio Job Feed API](https://jobpostingsapi.com/sources/personio-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 7,729 Personio employer boards via a single unified REST API.
- [Teamtailor Job Feed API](https://jobpostingsapi.com/sources/teamtailor-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 6,854 Teamtailor employer boards via a single unified REST API.
- [Pinpoint Job Feed API](https://jobpostingsapi.com/sources/pinpoint-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 2,637 Pinpoint employer boards via a single unified REST API.
- [iCIMS Job Feed API](https://jobpostingsapi.com/sources/icims-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 5,679 iCIMS employer boards via a single unified REST API.
- [Oracle Taleo Job Feed API](https://jobpostingsapi.com/sources/taleo-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 2,585 Oracle Taleo employer boards via a single unified REST API.
- [SAP SuccessFactors Job Feed API](https://jobpostingsapi.com/sources/successfactors-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 2,978 SAP SuccessFactors employer boards via a single unified REST API.
- [UKG Pro Job Feed API](https://jobpostingsapi.com/sources/ukg-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 9,105 UKG Pro employer boards via a single unified REST API.
- [ADP Workforce Now Job Feed API](https://jobpostingsapi.com/sources/adp-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 26,542 ADP Workforce Now employer boards via a single unified REST API.
- [ADP Recruiting Management Job Feed API](https://jobpostingsapi.com/sources/adprecruiting-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 869 ADP Recruiting Management employer boards via a single unified REST API.
- [Dayforce Job Feed API](https://jobpostingsapi.com/sources/dayforce-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 3,882 Dayforce employer boards via a single unified REST API.
- [Paylocity Job Feed API](https://jobpostingsapi.com/sources/paylocity-jobs-api): Fetch structured job listings, full HTML/plain-text descriptions, salary bands, skills, and closed-job events across 14,828 Paylocity employer boards via a single unified REST API.

## Endpoints

### Other

- [Search & filter active job postings across 434 ATS & career sources](https://jobpostingsapi.com/docs/searchjobs): `GET /v1/jobs/search` (1 Credit / Job)
- [Get full job posting details & HTML/text description by ID](https://jobpostingsapi.com/docs/getjobbyid): `GET /v1/jobs/{id}` (1 Credit / Job)
- [Count matching active jobs (Free — 0 Credits)](https://jobpostingsapi.com/docs/countjobs): `GET /v1/jobs/count` (1 Credit / Job)
- [Real-time stream of newly discovered job postings](https://jobpostingsapi.com/docs/getnewjobsfeed): `GET /v1/feeds/new` (1 Credit / Job)
- [Real-time stream of updated job postings](https://jobpostingsapi.com/docs/getupdatedjobsfeed): `GET /v1/feeds/updated` (1 Credit / Job)
- [Stream of recently closed / filled / expired job postings](https://jobpostingsapi.com/docs/getclosedjobsfeed): `GET /v1/feeds/closed` (1 Credit / Job)
- [Get all open jobs for a company (supports live ETag ATS refresh)](https://jobpostingsapi.com/docs/getcompanyjobs): `GET /v1/companies/{slug}/jobs` (1 Credit / Job)
- [List all 434 ATS platforms & career sources (Free — 0 Credits)](https://jobpostingsapi.com/docs/listsources): `GET /v1/sources` (1 Credit / Job)
- [Normalized skills taxonomy with active job counts (Free — 0 Credits)](https://jobpostingsapi.com/docs/listskillstaxonomy): `GET /v1/taxonomy/skills` (1 Credit / Job)
- [Normalized countries & regions taxonomy with active job counts (Free — 0 Credits)](https://jobpostingsapi.com/docs/listlocationstaxonomy): `GET /v1/taxonomy/locations` (1 Credit / Job)
- [Detect a company's ATS platform, board token & open job count (Free — 0 Credits)](https://jobpostingsapi.com/docs/detectcompanyats): `GET /v1/tools/ats-detector` (1 Credit / Job)
- [Gateway health & live index coverage stats (Free — 0 Credits)](https://jobpostingsapi.com/docs/gethealth): `GET /v1/health` (1 Credit / Job)

## FAQ

### How does the 1 Credit = 1 Job Record pricing model work?

Unlike legacy B2B data providers that charge per HTTP request regardless of whether 0 or 100 jobs are returned, JobPostings API charges strictly per returned job record: 1 Credit = 1 Job Record returned on /v1/jobs/search, /v1/feeds/*, and /v1/companies/{slug}/jobs. If a search query returns 0 matching jobs, you pay 0 Credits. Metadata endpoints (/v1/sources, /v1/taxonomy/skills, /v1/taxonomy/locations, /v1/tools/ats-detector) are 100% free (0 Credits).

### What is the difference between Verified ATS Jobs (9.9M+) and Attributed Global Listings (9.9M+)?

By default, /v1/jobs/search returns 9.9M+ Verified ATS & Corporate Career-Site Jobs (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Rippling, BambooHR, Personio, and direct employer portals) where redistribution_allowed is true — safe to display on public job boards, recruiting platforms, and commercial SaaS products. Passing include_attributed=true expands coverage across all 434 sources (19.8M+ total active listings), adding 9.9M+ attributed global listings with structured source attribution templates.

### What is the response latency for hot cached queries vs. cold long-tail searches?

Hot ATS & pre-indexed queries (covering US/EU/Remote tech, finance, healthcare, and Fortune 1000 boards) are served directly from our local PostgreSQL 16 full-text & trigram index in < 300 ms (typically 15–80 ms). Cold long-tail queries or live ATS board refreshes (?refresh=true) execute a real-time pass-through and write-through sync in 2–8 seconds, then serve all subsequent requests in < 300 ms.

### How do I detect when a job posting is closed or filled so my job board has zero dead links?

Poll GET /v1/feeds/closed?since=1h (unlocked on Growth $49/mo and PAYG $50+) or register a Webhook on /v1/webhooks for the job.closed event. Our worker verifies job closures across 434 ATS & career portals and emits structured closure timestamps so you can delist expired postings within minutes.

### Can I trigger a real-time check against a company's Greenhouse, Lever, or Ashby board?

Yes. Call GET /v1/companies/{slug}/jobs?refresh=true (for example, /v1/companies/stripe/jobs?refresh=true or /v1/companies/openai/jobs?refresh=true). Our gateway performs a conditional ETag (If-None-Match + gzip) check against the official Greenhouse, Lever, or Ashby board API, upserts any newly posted roles into the index, and returns the updated open job list.

### Am I charged when a search returns 0 results or when an API request fails?

Never. Searches that return 0 matching job postings cost 0 Credits. Invalid parameters (HTTP 400), rate-limited requests (HTTP 429), and gateway errors (HTTP 5xx) also cost 0 Credits.

### Should I choose a Monthly Subscription or a Pay-As-You-Go (PAYG) Credit Pack?

Monthly subscriptions ($19 Starter / 25k credits, $49 Growth / 100k credits, $99 Pro / 300k credits, $199 Scale / 1M credits) offer the lowest cost per 1,000 jobs ($0.199–$0.76 / 1K jobs) for continuous ingestion and GTM signal monitoring. PAYG Credit Packs ($25 / 30k, $50 / 75k, $100 / 200k, $300 / 800k) have zero recurring charges and your purchased credits never expire.

### What are the RPM rate limits and pagination rules?

Free Trial accounts include 500 Credits, 12 RPM (1 RPS), and up to 2 pages per search query. Upgrading to any paid plan or PAYG pack unlocks unlimited cursor pagination and scales throughput to 60 RPM (Starter), 180 RPM (Growth), 300 RPM (Pro), and 600 RPM / 25 RPS (Scale).

### What payment methods are accepted, and do you provide corporate VAT/Tax invoices?

You can pay via Credit/Debit Card, Apple Pay, or Google Pay through Stripe (with automatic corporate PDF invoices and EU/UK/AU/CA/SG VAT & Tax ID support), or top up with Cryptocurrency (USDT, USDC, BTC, ETH, SOL via NOWPayments with 0% gateway fee and an automatic +5% Bonus Credits reward).

### How does JobPostings API compare to TheirStack ($200/mo) and Coresignal ($800/mo)?

TheirStack starts at $200/month ($2,400/yr) and Coresignal starts at $800/month. JobPostings API starts at $19/month (Starter) or $49/month (Growth with real-time /v1/feeds/*), covers 434 ATS & corporate career-site sources (9.9M+ redistributable ATS jobs + 9.9M+ attributed global listings), and supports both monthly subscriptions and non-expiring Pay-As-You-Go credit packs.

### What is your refund policy?

Payments made within the last 14 days are eligible for a pro-rated refund of unused purchased credits. Promotional signup credits have no cash value.