Developers

ChatableApps Public API v1

Read-only JSON access to the AI tools directory: 8,000+ tools, categories, full-text search and vector-similar alternatives. Authenticate with a personal access token and start querying in minutes.

Authentication

Every endpoint requires a personal access token sent as a Bearer token in the Authorization header. Create and revoke tokens on the API tokens page of your account — the plaintext value is shown only once at creation.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://chatableapps.com/api/v1/tools?per_page=5

Rate limits

Tokens allow 60 requests per minute. When the limit is exceeded the API answers HTTP 429 with a Retry-After header — back off until then instead of retrying immediately.

GET /api/v1/tools

Paginated directory of live, available tools — the same visibility rules as the website. Sorted by popularity (most visited first).

GET /api/v1/tools/{slug}

One tool by its slug. Tools that are unpublished, delisted or no longer available answer 404.

GET /api/v1/tools/{slug}/alternatives

Up to five vector-similar tools — the same embedding-based matches shown on the website. Tools without an embedding return an empty list.

GET /api/v1/categories

The full category tree with nested subcategories. Cached for six hours.

GET /api/v1/search?q=

Full-text search over the directory through the same search index the website uses. The query is required and must be 2–120 characters.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://chatableapps.com/api/v1/search?q=image+background+remover"

The tool object

Tool and search endpoints return a deliberately narrow JSON shape: editorial fields, internal scores and owner data stay private.

{
  "data": [
    {
      "id": 42,
      "slug": "example-tool",
      "name": "Example Tool",
      "description": "Removes image backgrounds in one click.",
      "website": "https://example.com",
      "price": { "amount": 0.0, "type": "freemium" },
      "verified": true,
      "logo": "https://chatableapps.com/storage/logos/example.png",
      "rating": { "average": 4.5, "count": 128 },
      "subcategories": [
        { "id": 7, "slug": "photo-editing", "name": "Photo Editing" }
      ],
      "created_at": "2026-01-15T09:30:00+00:00",
      "links": {
        "self": ".../api/v1/tools/example-tool",
        "alternatives": ".../api/v1/tools/example-tool/alternatives",
        "web": "https://chatableapps.com/tool/example-tool"
      }
    }
  ],
  "links": { "first": "...", "last": "...", "next": "...", "prev": null },
  "meta": { "current_page": 1, "total": 8412, "per_page": 24 }
}