YubHub Public API
Live job listings from employers' own careers pages, with structured salary, skills, work arrangement and experience level. Read endpoints (/stats/*, /search,…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Live job listings from employers' own careers pages, with structured salary,
skills, work arrangement and experience level. Read endpoints (/stats/*,
/search, /health) are free, need no API key and have open CORS
(Access-Control-Allow-Origin: *). Feed and account endpoints need a yh_
API key from the Pro Publisher plan (api_pro).
/search is limited to 30 requests per minute per IP address and answers
HTTP 429 with a Retry-After header when the limit is reached. The /stats/*
endpoints have no per-client rate limit; their responses are cached at the
edge. Whole-site aggregates (counts, top lists, salary figures, facet lists)
are recomputed once a night, so they describe the market as of the previous
night (up to about 30 hours old); the three /live counters (overview,
hiring-velocity, market-pulse) are hourly. On /stats/by-facet a client can trade freshness for speed with the
X-Accept-Stale request header (seconds): when the cached answer has
expired it gets the previous one at once, marked X-KV-Cache: STALE with its
age in X-KV-Age, while a fresh one is computed in the background. Without
the header you get a freshly computed answer. A known crawler user agent
requesting an uncached key gets the previous answer if there is one,
otherwise HTTP 503 ("Warming up, retry shortly") with Retry-After: 60. Free feeds in XML, JSON and RSS are on feeds.yubhub.co.
Free to reuse and redistribute. Please credit YubHub and link to the source at
https://yubhub.co.
Endpoints 63
Health
- GETService health
/health
Search
- GETFull-text search across job titles and companies
/search?q=stringFTS5-backed (2026-09-06). Each word in q matches as a word prefix ("account" matches "Accountant", "count" does not); all words must match. Only live jobs are…
Stats
- GETSite-wide totals
/stats/overview - GETTop companies by job count
/stats/top-companies - GETJobs by category with experience-level breakdown
/stats/categories - GETMost common job titles (top 30)
/stats/top-titles - GETWeek-over-week title demand changes
/stats/title-trends - GETAnnual pay per job title (top titles by live jobs)
/stats/title-salariesLive jobs only (60-day rule). From the structured salary columns: hourly, daily, weekly and monthly pay annualised, then converted with one fixed table (IRS… - GETRemote/hybrid/on-site distribution
/stats/work-arrangements - GETEntry/mid/senior/executive distribution
/stats/experience-levels - GETAnnual pay distribution by job category, in one currency
/stats/salary-by-sectorLive jobs only (60-day rule). From the structured salary columns: hourly, daily, weekly and monthly pay annualised, then converted with one fixed table (IRS… - GETPay by job category for live US jobs (in USD) or UK jobs (in GBP)
/stats/salariesMedian, 25th and 75th percentile annual pay per job category, from live jobs that list a salary in the country's own currency (hourly, daily, weekly and… - GETTop skills with category split
/stats/skills-matrix - GETRequired vs preferred skill counts
/stats/skills-split - GET30-day hiring trend timeseries
/stats/hiring-velocity - GETOpen-jobs-per-employee ratio for top employers
/stats/hiring-intensity - GETPercentage of jobs disclosing salary per category
/stats/salary-transparency - GETCategory growth
/stats/market-pulse - GETTop-company share of total jobs per category
/stats/market-concentration - GETIndustry hiring momentum with accelerating/stable/decelerating signal
/stats/industry-momentum - GETAll titles with ≥3 jobs (programmatic SEO feed)
/stats/titles-list - GETDeep stats for a single title (companies, locations, work arrangement, experience level, salary)
/stats/by-title/:titleLive jobs only (seen within the last 60 days), matched on the job title by word prefix ("account" matches "Accountant"; "count" does not), newest first. Every… - GETSOC occupation AI exposure scores (from Anthropic telemetry)
/stats/occupation-ai-exposure - GETSkill-level AI exposure scores
/stats/skill-ai-exposure - GETRotating employer showcase for the homepage
/stats/employer-showcase
Facets
- GETList facet values with counts (for directory index pages)
/stats/facets/:typeEnumerate the values of a facet with live job counts. type=city lists canonical cities (value is the city slug, display the city name) — the directory behind… - GETDetailed data for a single facet value (paginated job list + aggregations)
/stats/by-facet/:type/:valueFor type=city, value is the canonical city slug (as returned by /stats/facets/city), e.g. /stats/by-facet/city/london. Every facet response also carries… - GETRelated facets (cross-link suggestions for archive sidebars)
/stats/related/:type/:value - GETLive graduate / entry-level jobs or internships, with specialism and country breakdowns
/stats/early-careers/:trackPowers yubhub.co/jobs/graduate/ and /jobs/internships/. internship = job_type or experience_level "internship", or a title naming an internship (intern,…
Jobs
- GETFull data for a single job including linked-data (Wikidata sameAs)
/stats/job/:id - GETRecent enriched job IDs (for sitemap consumers)
/stats/recent-jobs - GETAuthenticated full-data job fetch
/api/jobs/:jobId - POSTReset one of your jobs and re-run enrichment (re-scrape if its raw content was cleared)
/api/jobs/:jobId/reset-enrichment
Companies
- GETFull company intelligence profile + hiring aggregates + 11 benchmarking sections
/stats/company/:slugReturns the company profile, base hiring aggregates, and 11 additive Phase 1 intelligence sections under data.hiring.*: velocity (26-week), momentum (14d),… - GETCompany profile only (the `data.company` block of /stats/company/{slug})
/stats/company/:slug/profileOne indexed lookup, no hiring aggregates. Use it when you need the employer's identity, links and firmographics without the intelligence sections. - GETPer-company time series (velocity / categories / titles / geo)
/stats/company/:slug/timeseries - GETSame-industry peer ranking with momentum classification
/stats/company/:slug/peers - GETCross-company rankings (accelerating, AI-exposed, hiring-velocity, exec-hires)
/stats/companies/leaderboard - GETCompany directory (list of companies with N+ live roles)
/stats/companies
Public feeds (feeds.yubhub.co)
- GETFree XML job feed for a facet (JBoard/SmartJobBoard-compatible) — on feeds.yubhub.co
https://feeds.yubhub.co/facet/:type/:slug.xmlNo auth. https://feeds.yubhub.co/facet/{type}/{slug}.xml — e.g. /facet/skill/python.xml, /facet/category/sales.xml, /facet/company/anthropic.xml,… - GETFree JSON job feed for a facet — on feeds.yubhub.co
https://feeds.yubhub.co/facet/:type/:slug.jsonSame content and caching as the .xml twin, as JSON (company, x-facet, jobs[] with title, company, location, description HTML, employment type, salary where… - GETFree RSS 2.0 job feed for a facet, for feed readers and email alerts, on feeds.yubhub.co
https://feeds.yubhub.co/facet/:type/:slug.rssSame content and caching as the .xml twin, as RSS 2.0 (one <item> per job, linking to its yubhub.co page). pubDate is the employer's own posting date, falling… - GETXML feed for one employer feed (the URL shown in the dashboard) — on feeds.yubhub.co
https://feeds.yubhub.co/feed/:feedIdJBoard-format XML of the live jobs in a feed (enriched and seen at the source within the last 60 days), newest first, capped by plan. Newly enriched jobs…
Feeds (authenticated)
- GETList your feeds
/api/feeds - POSTCreate a feed
/api/feeds - GETFeed detail
/api/feeds/:id - DELETEDelete feed (its enriched jobs are soft-expired; unenriched jobs are deleted)
/api/feeds/:id - PATCHUpdate feed
/api/feeds/:id - POSTTrigger discovery+scrape+enrich
/api/feeds/:id/run - GETPaginated jobs for a feed
/api/feeds/:id/jobs - DELETEDelete all jobs for a feed
/api/feeds/:id/jobs - GETThe public XML feed URL for this feed (JSON body
/api/feeds/:id/xml - GETGet the feed auto-refresh schedule
/api/feeds/:id/schedule - PATCHUpdate the feed auto-refresh schedule
/api/feeds/:id/schedule - POSTRe-queue this feed's stuck jobs (failed / quota_blocked / scraped; re-enrich when content survives
/api/feeds/:id/jobs/retry-failed - POSTReset this feed's jobs to re-run enrichment
/api/feeds/:id/jobs/reset-enrichment
Account (authenticated)
- GETAccount profile + usage
/api/account - DELETEDelete account permanently: cancels the Stripe subscription, deletes the Clerk user, soft-expires your jobs (rows are kept, never hard-deleted), then deletes your feeds, usage log and user row
/api/account - GETCurrent plan usage and monthly quota
/api/account/usage - POSTGenerate a new yh_ API key
/api/account/api-keyThe full key is returned once, in this response. YubHub stores only a SHA-256 hash and a non-secret prefix, so GET /api/account shows limits.apiKeyPrefix… - DELETERevoke current API key
/api/account/api-key - POSTCreate a Stripe Billing Portal session (manage or cancel a subscription)
/api/account/portal - POSTCreate a Stripe Checkout session to subscribe or upgrade (an existing subscriber gets a Billing Portal session instead)
/api/account/checkout
API details
- Base URL
https://api.yubhub.co- Authentication
- A bearer token in the Authorization header
- Operations
- 63 operations on 56 pathsGET 49POST 8DELETE 4PATCH 2
- Main resources
- Stats 23Feeds (authenticated) 13Account (authenticated) 7Companies 6Facets 4Jobs 4Public feeds (feeds.yubhub.co) 4Health 1Search 1
- Response formats
application/jsonapplication/xmlapplication/rss+xml- Description format
- OpenAPI 3.0.3, API version
2.12.0 - Links
- OpenAPI document · Support
- Listed from
- Yubhub's published OpenAPI description
How to test the YubHub Public API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the YubHub Public API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Service health” (GET /health), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the YubHub Public API?
Live job listings from employers' own careers pages, with structured salary, skills, work arrangement and experience level. Read endpoints (/stats/*, /search,… It is listed under Data & analytics and has 63 endpoints.
Who publishes the YubHub Public API?
It is listed from YubHub's public API description (an OpenAPI document), not published by YubHub on Swastik Codes. Anyone who controls yubhub.co can claim the profile by adding a DNS TXT record.
What is the base URL of the YubHub Public API?
Requests go to https://api.yubhub.co. Endpoint paths are added to this base URL.
How do I authenticate with the YubHub Public API?
With A bearer token in the Authorization header.
How many endpoints does the YubHub Public API have?
63 operations on 56 paths (49 GET, 8 POST, 4 DELETE, 2 PATCH). The largest groups are Stats, Feeds (authenticated), Account (authenticated), Companies.
Is forking the YubHub Public API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.