{"schemaVersion":"hugging-bay.api-plans.v1","summary":"Public reads work without a key. A free key raises your limit and keeps it separate from your IP. Higher plans are on request.","window":"Limits are requests per minute, per key, per server instance.","anonymous":{"limitPerMinute":300,"per":"IP address"},"plans":[{"id":"free","label":"Free key","limitPerMinute":1200,"concurrentRequests":8,"howToGet":"self-serve"},{"id":"builder","label":"Builder","limitPerMinute":3000,"concurrentRequests":16,"howToGet":"on request"},{"id":"scale","label":"Scale","limitPerMinute":6000,"concurrentRequests":32,"howToGet":"on request"},{"id":"partner","label":"Data partner","limitPerMinute":20000,"concurrentRequests":64,"howToGet":"on request"},{"id":"data_feed","label":"Data feed","limitPerMinute":20000,"concurrentRequests":64,"howToGet":"contract"}],"getKey":{"method":"POST","url":"https://huggingbay.xyz/api/account/reader-token","body":{"displayName":"optional","contactEmail":"optional","purpose":"optional"},"response":"201 with apiKey.token, shown once. We store only a hash.","page":"https://huggingbay.xyz/api-keys"},"useKey":["Authorization: Bearer <key>","X-Api-Key: <key>"],"useKeyNote":"X-Api-Key is for server-side clients. From a browser, send Authorization: Bearer <key>.","namedCrawlers":"A free key does not lift a named crawler's shared user-agent budget. Ask for a higher plan or bulk data.","checkUsage":"https://huggingbay.xyz/api/v1/key","higherLimits":{"page":"https://huggingbay.xyz/crawl-access?option=higher_limits","api":{"method":"POST","url":"https://huggingbay.xyz/api/v1/crawl-access/requests","body":{"contact_email":"required","intended_use":"required (include your key prefix)","option":"higher_limits"}}},"dataFeed":{"title":"Data feed for AI companies","summary":"Daily full catalog with checksums, licenses and where models run, change feed, higher limits, uptime promise, a direct contact.","free":"Free for research and open source.","includes":["The daily full catalog: every public model with file lists, sizes, SHA-256 checksums and license labels.","Where models run: download readiness and the files you can fetch today.","A change feed, so you pull only what changed since your last copy.","Higher limits for live lookups with your own data feed key.","An uptime promise for the feed.","A direct contact for questions and fixes."],"freeForEveryone":["Fair-pace crawling that follows robots.txt.","The public API, MCP tools, sitemaps and the bounded catalog dump.","A free API key with a higher limit of its own."],"howToGet":"Ask us. We set up a data feed key and reply by email with terms.","contact":"https://huggingbay.xyz/contact?topic=data-feed","identify":["Send one stable User-Agent with your crawler name and a page about it, for example ExampleBot/1.0 (+https://example.com/bot).","Use the same User-Agent from every IP address. We count named crawlers by User-Agent, not by IP.","Follow robots.txt, including Crawl-delay.","On the data feed, send your key as Authorization: Bearer <key> or X-Api-Key: <key>. Keyed requests get the key's limits, not the shared crawler budget."]},"bulkData":{"page":"https://huggingbay.xyz/bulk-data","api":{"method":"POST","url":"https://huggingbay.xyz/api/v1/crawl-access/requests","body":{"contact_email":"required","intended_use":"required","option":"data_partnership"}}},"on429":"Every 429 has Retry-After, Link and X-Upgrade-Url headers and an `upgrade` object in JSON bodies.","privacy":"If you give an email, we use it only to contact you about your key.","note":{"summary":"Downloadable doesn't mean tested: this record says whether the exact file can be downloaded now, not that the model is complete or that it runs."}}