Skip to content
BestAIToolix

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.

EndpointReturns
/api/v1/categoriesLive categories with published-tool counts.Parameters: limit (1–100, default 20), cursor
/api/v1/categories/{slug}One category.
/api/v1/categories/{slug}/toolsPublished tools in a category.Parameters: limit (1–100), cursor, sort=name|rank
/api/v1/categories/{slug}/filtersThe filters available for a category.
/api/v1/categories/{slug}/methodologyThe published ranking methodology for a category.
/api/v1/categories/{slug}/rankingThe latest published ranking snapshot.
/api/v1/tools/{slug}A tool profile with its field values and their verification status.
/api/v1/tools/{slug}/evidence-summaryEvidence counts by verification status and freshness.
/api/v1/tools/{slug}/rankingsA tool's positions across category rankings.
/api/v1/tools/{slug}/alternativesOther tools in the same primary category.
/api/v1/tools/{slug}/reviewsPublished user reviews.Parameters: limit (1–100), cursor
/api/v1/compareSide-by-side comparison of 2–5 tools.Parameters: tools=slug1,slug2,… (required), category
/api/v1/searchFull-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.