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.

PathContent
/api/v1/index.jsonEndpoint map, asOf date and total bot count.
/api/v1/categories.jsonEvery category: slug, label, count, purpose.
/api/v1/categories/{slug}.jsonAll bots in one category (compact records).
/api/v1/trending.jsonPopularity order: global list and one list per category.
/api/v1/recent.jsonCategories in refresh order.
/api/v1/bots/{id}.jsonOne bot: id, name, author, description, category, code, link, asOf.
/api/v1/codes.jsonEvery listed bot code, lowercased.
/feed.xmlAtom feed of the trending list.
/feed.jsonJSON Feed 1.1 of the trending list.
/api/healthWorker 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. The form posts JSON to /api/submit; browsers on other origins are blocked, and the endpoint is rate limited.