Every public endpoint, generated straight from our OpenAPI 2.5.0 spec.
The 37 data endpoints need no key;
the 19 feed & account endpoints take a
Bearer yh_ key (Pro Publisher plan).
Data endpoints (Health, Search, Stats) are open — no key required. Feed & account endpoints (marked auth) need your key as a Bearer token:
Authorization: Bearer yh_your_api_key /health Service health + deployed version
/search Full-text search across job titles and companies
q (query)*, page (query), perPage (query)
/stats/overview Site-wide totals
/stats/top-companies Top companies by job count
/stats/categories Jobs by category with experience-level breakdown
/stats/top-titles Most common job titles (top 30)
/stats/title-trends Week-over-week title demand changes
/stats/title-salaries Salary percentiles per title
/stats/work-arrangements Remote/hybrid/on-site distribution
/stats/experience-levels Entry/mid/senior/executive distribution
/stats/salary-by-sector Salary min/max/median by category
/stats/skills-matrix Top skills with category split
/stats/skills-split Required vs preferred skill counts
/stats/hiring-velocity 30-day hiring trend timeseries
/stats/hiring-intensity Open-jobs-per-employee ratio for top employers
/stats/salary-transparency Percentage of jobs disclosing salary per category
/stats/market-pulse Category growth
/stats/market-concentration Top-company share of total jobs per category
/stats/industry-momentum Industry hiring momentum with accelerating/stable/decelerating signal
/stats/titles-list All titles with ≥3 jobs (programmatic SEO feed)
/stats/by-title/{title} Deep stats for a single title (companies, skills, salary, locations)
title (path)*
/stats/occupation-ai-exposure SOC occupation AI exposure scores (from Anthropic telemetry)
/stats/skill-ai-exposure Skill-level AI exposure scores
/stats/employer-showcase Rotating employer showcase for the homepage
yh_ key /api/feeds List your feeds
include (query)
/api/feeds Create a feed
/api/feeds/{id} Feed detail
id (path)*
/api/feeds/{id} Update feed
id (path)*
/api/feeds/{id} Delete feed + jobs
id (path)*
/api/feeds/{id}/run Trigger discovery+scrape+enrich
id (path)*
/api/feeds/{id}/jobs Paginated jobs for a feed
id (path)*, status (query), page (query), per_page (query)
/api/feeds/{id}/jobs Delete all jobs for a feed
id (path)*
/api/feeds/{id}/xml Redirect to the public XML feed URL
id (path)*
/api/feeds/{id}/schedule Get the feed auto-refresh schedule
id (path)*
/api/feeds/{id}/schedule Update the feed auto-refresh schedule
id (path)*
/api/feeds/{id}/jobs/retry-failed Re-queue this feed's failed jobs for enrichment
id (path)*
/api/feeds/{id}/jobs/reset-enrichment Reset this feed's jobs to re-run enrichment
id (path)*
yh_ key /stats/job/{id} Full data for a single job including linked-data (Wikidata sameAs)
id (path)*
/stats/recent-jobs Recent enriched job IDs (for sitemap consumers)
limit (query), offset (query)
/api/jobs/{jobId} Authenticated full-data job fetch
jobId (path)*
yh_ key /api/account Account profile + usage
/api/account Delete account
/api/account/usage Current plan usage and monthly quota
/api/account/api-key Generate a new yh_ API key
/api/account/api-key Revoke current API key
/facet/{type}/{slug}.xml Free XML job feed for a facet (JBoard/SmartJobBoard-compatible) — on feeds.yubhub.co
type (path)*, slug (path)*
/facet/{type}/{slug}.json Free JSON job feed for a facet — on feeds.yubhub.co
type (path)*, slug (path)*
/feed/{feedId} XML feed for one employer feed (the URL shown in the dashboard) — on feeds.yubhub.co
feedId (path)*
/stats/facets/{type} List facet values with counts (for directory index pages)
type (path)*, min (query)
/stats/by-facet/{type}/{value} Detailed data for a single facet value (paginated job list + aggregations)
type (path)*, value (path)*, page (query), perPage (query)
/stats/related/{type}/{value} Related facets (cross-link suggestions for archive sidebars)
type (path)*, value (path)*
/stats/company/{slug} Full company intelligence profile + hiring aggregates + 11 benchmarking sections
slug (path)*
/stats/company/{slug}/timeseries Per-company time series (velocity / categories / titles / geo)
slug (path)*, metric (query), weeks (query)
/stats/company/{slug}/peers Same-industry peer ranking with momentum classification
slug (path)*, n (query)
/stats/companies/leaderboard Cross-company rankings (accelerating, AI-exposed, hiring-velocity, exec-hires)
metric (query), limit (query), min_jobs (query)
/stats/companies Company directory (list of companies with N+ live roles)
min (query)
* required parameter. Feed & account endpoints require a Pro Publisher plan.