Read API.
Plain JSON.
Static, read-only and free to use. Listings are a snapshot dated ; the data is refreshed twice a week, Monday and Thursday. 8,322 bots in 26 categories.
| Path | Content |
|---|---|
/api/v1/index.json | Endpoint map, asOf date and total bot count. |
/api/v1/categories.json | Every category: slug, label, count, purpose. |
/api/v1/categories/{slug}.json | All bots in one category (compact records). |
/api/v1/trending.json | Popularity order: global list and one list per category. |
/api/v1/recent.json | Categories in refresh order. |
/api/v1/bots/{id}.json | One bot: id, name, author, description, category, code, link, asOf. |
/api/v1/codes.json | Every listed bot code, lowercased. |
/feed.xml | Atom feed of the trending list. |
/feed.json | JSON Feed 1.1 of the trending list. |
/api/health | Worker and database check: {"ok":true,"d1":true}. |
Bot record
{"id":"…","name":"…","author":"…","description":"…","category":{"slug":"…","label":"…"},"code":"…","link":"https://x.ai/bot/…","asOf":"2026-10-28"}Submitting a bot
Writes are same-origin only: use the form on the Submit page, or email submit@grokbot.zone with the bot's name, its link and a one-line description. The form posts JSON to /api/submit; browsers on other origins are blocked, and the endpoint is rate limited.