API documentation
BestAIToolix offers a free, read-only JSON API over the same data you see on the site: categories, tool profiles, rankings, comparisons, search, and evidence summaries. No API key is required.
Quick start
curl https://bestaitoolix.com/api/v1/tools/terraform curl "https://bestaitoolix.com/api/v1/compare?tools=terraform,opentofu"
Endpoints
All endpoints are GET, relative to https://bestaitoolix.com. A {slug} is the identifier in the site URL, for example terraform in /tools/terraform.
| Endpoint | Returns |
|---|---|
| /api/v1/categories | Live categories with published-tool counts.Parameters: limit (1–100, default 20), cursor |
| /api/v1/categories/{slug} | One category. |
| /api/v1/categories/{slug}/tools | Published tools in a category.Parameters: limit (1–100), cursor, sort=name|rank |
| /api/v1/categories/{slug}/filters | The filters available for a category. |
| /api/v1/categories/{slug}/methodology | The published ranking methodology for a category. |
| /api/v1/categories/{slug}/ranking | The latest published ranking snapshot. |
| /api/v1/tools/{slug} | A tool profile with its field values and their verification status. |
| /api/v1/tools/{slug}/evidence-summary | Evidence counts by verification status and freshness. |
| /api/v1/tools/{slug}/rankings | A tool's positions across category rankings. |
| /api/v1/tools/{slug}/alternatives | Other tools in the same primary category. |
| /api/v1/tools/{slug}/reviews | Published user reviews.Parameters: limit (1–100), cursor |
| /api/v1/compare | Side-by-side comparison of 2–5 tools.Parameters: tools=slug1,slug2,… (required), category |
| /api/v1/search | Full-text search across tools.Parameters: q (required), limit (1–50, default 10) |
| /api/v1/articles/{slug} | A published guide. |
Responses
Successful responses wrap results in data, with a request ID in meta:
{
"data": [ … ],
"meta": { "requestId": "a450c331-…", "nextCursor": "eyJzbHVnIjoi…" }
}Errors use one shape and conventional status codes (404 not found, 422 invalid parameters):
{
"error": {
"code": "VALIDATION_ERROR",
"message": "One or more fields are invalid.",
"requestId": "…",
"fields": { "limit": "Must be an integer between 1 and 100." }
}
}Pagination
List endpoints return meta.nextCursor. Pass it back as ?cursor=… to get the next page; it is null on the last page. Cursors are opaque — don’t construct them yourself.
Data semantics
- Every field value carries its verification status. Treat “pending verification” values accordingly.
- An absent value means unknown, never “no” or zero.
- Rankings are category-relative and tied to a versioned methodology.
Caching, limits and fair use
Responses are cacheable for 60 seconds. Requests are rate-limited per IP address at the edge (about 20 requests per second with a short burst allowance); exceeding it returns HTTP 429. Use the API under our acceptable use policy and terms, and please attribute BestAIToolix with a link when you publish the data.
The API is versioned in the path; breaking changes will ship under a new version. Building something larger? Tell us at contact@bestaitoolix.com.