# YubHub API

**Canonical:** https://apis.io/apis/yubhub/yubhub-api/  
**Provider:** YubHub — https://apis.io/providers/yubhub/  
**Base URL:** https://api.yubhub.co  
**Documentation:** https://yubhub.co/api

YubHub API is one of 2 APIs that [YubHub](https://apis.io/providers/yubhub/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

YubHub API as documented publicly: 57 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

## Operations (57)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/account` | Delete account permanently: cancels the Stripe subscription, deletes the Clerk user, soft-expires your jobs (rows are kept, never hard-deleted), then deletes... |
| GET | `/api/account` | Account profile + usage |
| DELETE | `/api/account/api-key` | Revoke current API key |
| POST | `/api/account/api-key` | Generate a new yh_ API key |
| POST | `/api/account/checkout` | Create a Stripe Checkout session to subscribe or upgrade (an existing subscriber gets a Billing Portal session instead) |
| POST | `/api/account/portal` | Create a Stripe Billing Portal session (manage or cancel a subscription) |
| GET | `/api/account/usage` | Current plan usage and monthly quota |
| GET | `/api/feeds` | List your feeds |
| POST | `/api/feeds` | Create a feed |
| DELETE | `/api/feeds/{id}` | Delete feed (its enriched jobs are soft‑expired; unenriched jobs are deleted) |
| GET | `/api/feeds/{id}` | Feed detail |
| PATCH | `/api/feeds/{id}` | Update feed |
| DELETE | `/api/feeds/{id}/jobs` | Delete all jobs for a feed |
| POST | `/api/feeds/{id}/jobs/reset-enrichment` | Reset this feed's jobs to re-run enrichment |
| POST | `/api/feeds/{id}/jobs/retry-failed` | Re-queue this feed's stuck jobs (failed / quota_blocked / scraped; re-enrich when content survives) |
| PATCH | `/api/feeds/{id}/schedule` | Update the feed auto‑refresh schedule |
| GET | `/api/feeds/{id}/xml` | The public XML feed URL for this feed |
| GET | `/api/jobs/{jobid}` | Authenticated full-data job fetch |
| POST | `/api/jobs/{jobid}/reset-enrichment` | Reset one of your jobs and re-run enrichment (re-scrape if its raw content was cleared) |
| GET | `/feed/{feedid}` | XML feed for one employer feed (the URL shown in the dashboard) |
| GET | `/health` | Service health |
| GET | `/search` | GET /search |
| GET | `/stats/by-facet/{type}/{value}` | Detailed data for a single facet value (paginated job list + aggregations) |
| GET | `/stats/by-title/{title}` | Deep stats for a single title (companies, locations, work arrangement, experience level, salary) |
| GET | `/stats/categories` | Jobs by category with experience-level breakdown |
| GET | `/stats/companies` | Company directory (list of companies with N+ live roles) |
| GET | `/stats/companies/leaderboard` | Cross-company rankings (accelerating, AI-exposed, hiring-velocity, exec-hires) |
| GET | `/stats/company/{slug}` | Full company intelligence profile + hiring aggregates + 11 benchmarking sections |
| GET | `/stats/company/{slug}/peers` | Same-industry peer ranking with momentum classification |
| GET | `/stats/company/{slug}/profile` | Company profile only (the `data.company` block of /stats/company/{slug}) |
| GET | `/stats/company/{slug}/timeseries` | Per-company time series (velocity / categories / titles / geo) |
| GET | `/stats/early-careers/{track}` | Live graduate / entry-level jobs or internships, with specialism and country breakdowns |
| GET | `/stats/employer-showcase` | Rotating employer showcase for the homepage |
| GET | `/stats/experience-levels` | Entry/mid/senior/executive distribution |
| GET | `/stats/facets/{type}` | List facet values with counts (for directory index pages) |
| GET | `/stats/hiring-intensity` | Open-jobs-per-employee ratio for top employers |
| GET | `/stats/hiring-velocity` | 30-day hiring trend timeseries |
| GET | `/stats/industry-momentum` | Industry hiring momentum with accelerating/stable/decelerating signal |
| GET | `/stats/job/{id}` | Full data for a single job including linked-data (Wikidata sameAs) |
| GET | `/stats/market-concentration` | Top-company share of total jobs per category |
| GET | `/stats/market-pulse` | Category growth |
| GET | `/stats/occupation-ai-exposure` | SOC occupation AI exposure scores (from Anthropic telemetry) |
| GET | `/stats/overview` | Site-wide totals |
| GET | `/stats/recent-jobs` | Recent enriched job IDs (for sitemap consumers) |
| GET | `/stats/related/{type}/{value}` | Related facets (cross-link suggestions for archive sidebars) |
| GET | `/stats/salaries` | Pay by job category for live US jobs (in USD) or UK jobs (in GBP) |
| GET | `/stats/salary-by-sector` | Annual pay distribution by job category, in one currency |
| GET | `/stats/salary-transparency` | Percentage of jobs disclosing salary per category |
| GET | `/stats/skill-ai-exposure` | Skill-level AI exposure scores |
| GET | `/stats/skills-matrix` | Top skills with category split |
| GET | `/stats/skills-split` | Required vs preferred skill counts |
| GET | `/stats/title-salaries` | Annual pay per job title (top titles by live jobs) |
| GET | `/stats/title-trends` | Week-over-week title demand changes |
| GET | `/stats/titles-list` | All titles with ≥3 jobs (programmatic SEO feed) |
| GET | `/stats/top-companies` | Top companies by job count |
| GET | `/stats/top-titles` | Most common job titles (top 30) |
| GET | `/stats/work-arrangements` | Remote/hybrid/on-site distribution |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/yubhub/openapi/_ae-authored/yubhub-openapi-generated.yml

## Other YubHub APIs (1)

- [YubHub API](https://apis.io/apis/yubhub/yubhub-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/yubhub/yubhub-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/yubhub/.