Hugging Bay API
Find open-model and dataset metadata, then inspect license, upstream provenance, file hashes and hosted-file evidence before choosing a mirror. Catalog inclusion does not establish byte availability, permission to use a model, or runtime quality.
Search catalog rows
Public reads need no token. Search returns rows with artifact ids.
curl -fsS 'https://huggingbay.xyz/api/v1/search?q=embedding&limit=3&sort=best'
Resolve an upstream repo
Resolve an upstream repo URL or owner/name to a catalog record.
curl -fsS 'https://huggingbay.xyz/api/v1/resolve?repo=sentence-transformers/all-MiniLM-L6-v2'
Fetch hosted download plan
Inspect individual hosted files and hashes before downloading. Use an id from search or resolve.
curl -fsS 'https://huggingbay.xyz/api/v1/artifacts/hf-model-sentence-transformers-all-minilm-l6-v2/download-plan'
Get a token
POST /api/account/reader-token needs no prior authentication. The token is shown once; save it securely. Send Authorization: Bearer <token> for account workflows.
curl -fsS -X POST 'https://huggingbay.xyz/api/account/reader-token' -H 'Content-Type: application/json' -d '{"displayName":"My app"}'
Pagination
Use limit=1..200 and a non-negative integer cursor. Pass nextCursor from the previous response as cursor on the same query; stop when nextCursor is null.
curl -fsS 'https://huggingbay.xyz/api/v1/search?q=embedding&limit=3&cursor=3'
Errors and retries
Errors preserve error and add code, message, HTTP status, requestId, and optional details. Invalid queries include field and allowed. Honor Retry-After when present; per-client RateLimit headers appear only on uncached responses.
{
"error": "invalid_query",
"code": "invalid_query",
"message": "Choose a documented search sort order.",
"status": 400,
"requestId": "example",
"field": "sort",
"allowed": [
"best",
"ready",
"mirrorable",
"trust",
"rating",
"updated",
"downloads",
"stars",
"mirrors",
"demand",
"name",
"size",
"license"
]
}
Open interactive page