# huggingbay-xyz Catalog API

**Canonical:** https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-catalog-api/  
**Provider:** huggingbay-xyz — https://apis.io/providers/huggingbay-xyz/  
**Base URL:** https://huggingbay.xyz  
**Documentation:** https://huggingbay.xyz/docs/api

huggingbay-xyz Catalog API is one of 109 APIs that [huggingbay-xyz](https://apis.io/providers/huggingbay-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 12 JSON Schema definitions. Tagged areas include Catalog. The published artifact set on APIs.io includes an OpenAPI specification and 12 JSON Schemas.

The Catalog API from huggingbay-xyz — 57 operation(s) for catalog.

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/health` | Cheap process liveness and initialization |
| GET | `/api/version` | Fetch the deployed build marker |
| GET | `/api/decision-verify/{decisionId}` | Read the offline-verifiable Public Decision & Verify packet for a decision id |
| HEAD | `/api/decision-verify/{decisionId}` | Fetch Public Decision & Verify representation headers (no body) |
| GET | `/api/readiness` | Strict service readiness |
| GET | `/api/dumps/manifest.json` | Fetch public data dump manifest |
| GET | `/data/manifest.json` | Alias for public data dump manifest |
| GET | `/api/dumps/catalog.jsonl` | Bounded public catalog dump in NDJSON |
| GET | `/api/dumps/catalog.csv` | Bounded public catalog dump in CSV |
| GET | `/feeds/recent.xml` | RSS feed of recent public Hugging Bay artifacts |
| GET | `/feeds/trending.xml` | RSS feed of trending Hugging Bay artifacts |
| GET | `/feed.xml` | Freshness Atom feed of catalog changes |
| GET | `/atom.xml` | Trending Atom feed |
| GET | `/api/v1/families/{family}` | List sizes and variants for one model family |
| GET | `/api/v1/trending` | Stable v1 trending and demand signals |
| GET | `/api/me` | Resolve the current bearer token to its server-authoritative principal and role |
| GET | `/api/activation` | High-value Hugging Bay activation loops for humans and agents |
| GET | `/api/catalog/sources` | Alias of /api/catalog/coverage: per-source catalog coverage counts |
| GET | `/api/recommendations` | Public catalog totals, mirror signals, and pack summaries |
| GET | `/api/trending` | Return public trending artifacts from aggregate demand, download… |
| GET | `/api/traffic` | Return privacy-safe aggregate Hugging Bay usage and agent/crawler discovery… |
| GET | `/api/stats/pageviews` | Return the exact all-time count of tracked page views since launch |
| GET | `/api/recommender` | Return ranked artifact recommendations for a concrete use case |
| GET | `/api/recommend-specialist` | Recommend a Bay Run specialist or warm direct job for a bounded task |
| GET | `/api/recommend` | Alias for /api/recommender |
| GET | `/api/mirror-packs` | List curated discovery/download packs without row payloads |
| GET | `/api/mirror-packs/{slug}` | Fetch one curated pack with artifact rows |
| GET | `/api/local-kits/{id}` | Fetch tool-specific local-use commands and required file metadata for one… |
| GET | `/api/mirror-demand` | Rank requested and high-download mirror candidates |
| GET | `/api/mirror-readiness` | Rank mirror candidates with readiness scores, blockers, tool compatibility, and… |
| GET | `/api/request-status` | Requested mirror status center for agents and public request tracking |
| GET | `/api/mirror-scale-plan` | Mirror scale planning is unavailable on the public evidence surface |
| HEAD | `/api/mirror-scale-plan` | Inspect mirror scale planning limited availability headers |
| GET | `/api/catalog/coverage` | Public catalog coverage totals and source policies |
| GET | `/api/agents/briefing` | Compact cached briefing for agents and crawlers |
| GET | `/api/answers` | List citation-ready Hugging Bay answer packs for common AI artifact questions |
| GET | `/api/answers/{slug}` | Fetch one citation-ready answer pack with recorded citation URLs and extraction… |
| GET | `/api/citations` | Fetch a one-call AI citation pack for a question or answer-pack slug |
| GET | `/api/answers/{slug}/citations` | Fetch a citation pack scoped to one answer pack |
| GET | `/api/stacks` | List practical open AI stack packs for high-intent use cases |
| GET | `/api/stacks/{slug}` | Fetch one stack pack with bounded ranked artifact rows |
| GET | `/api/radar` | Fetch multi-source open-source AI radar sections |
| GET | `/api/rankings/{slug}` | Fetch one ranking as JSON so agents do not scrape ranking HTML |
| GET | `/api/topics` | List generated catalog topics by task, type, license, framework, and source |
| GET | `/api/topics/{slug}` | Fetch one topic and its ranked artifact rows |
| GET | `/answers` | Server-rendered answer pack index with schema.org JSON-LD |
| GET | `/ai-search` | Server-rendered AI-search guidance page with citation rules, recorded targets… |
| GET | `/ai-citations` | Server-rendered AI citation pack page with safe claims, avoid claims, citation… |
| GET | `/answers/{slug}` | Server-rendered answer pack detail with concise answer, citation URLs, and… |
| GET | `/api/browse-fold` | Browse fold document for the unfiltered catalog honesty view (STATE-A only) |
| GET | `/api/browse-fold/more` | Next page of browse-fold divider or metadata rows |
| GET | `/api/v1/search-reference` | Search reference metadata (redirect target when configured) |
| GET | `/api/data/manifest.json` | Read /api/dumps/manifest.json through its compatible /api/data/manifest.json… |
| GET | `/api/dumps/catalog.ndjson` | Read /api/dumps/catalog.jsonl through its compatible /api/dumps/catalog.ndjson… |
| GET | `/api/packs` | Read /api/mirror-packs through its compatible /api/packs route |
| GET | `/api/packs/{slug}` | Read /api/mirror-packs/{slug} through its compatible /api/packs/{slug} route |
| GET | `/api/public/traffic` | Read /api/traffic through its compatible /api/public/traffic route |
| GET | `/api/traffic/summary` | Read /api/traffic through its compatible /api/traffic/summary route |
| GET | `/api/public/trending` | Read /api/trending through its compatible /api/public/trending route |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/huggingbay-xyz/openapi/huggingbay-xyz-catalog-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-public-dataset-inspection-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-request-intent-submission-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-run-card-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-request-intent-surface-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-public-evidence-surface-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-run-card-discovery-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-task-verification-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-memory-tool-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-bakeoff-tool-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-chat-completions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-route-execution-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-task-execution-response-schema.json

## Other huggingbay-xyz APIs (12)

- [huggingbay-xyz A2a API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-a2a-api/)
- [huggingbay-xyz Account API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-account-api/)
- [huggingbay-xyz Accounts API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-accounts-api/)
- [huggingbay-xyz Agent Directory.json API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agent-directory-json-api/)
- [huggingbay-xyz Agent Docs API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agent-docs-api/)
- [huggingbay-xyz Agents API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-api/)
- [huggingbay-xyz Agents.json API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-json-api/)
- [huggingbay-xyz AGENTS.md API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-md-api/)
- [huggingbay-xyz Agents.txt API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-agents-txt-api/)
- [huggingbay-xyz Analytics API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-analytics-api/)
- [huggingbay-xyz Answers API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-answers-api/)
- [huggingbay-xyz Artifacts API](https://apis.io/apis/huggingbay-xyz/huggingbay-xyz-artifacts-api/)

## Tags

Catalog

---

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