Desenvolvedores

ChatableApps API pública v1

Acesso JSON somente leitura ao diretório de ferramentas de IA: mais de 8.000 ferramentas, categorias, busca de texto completo e alternativas com vetores semelhantes. Autentique-se com um token de acesso pessoal e comece a consultar em minutos.

Autenticação

Cada endpoint exige um token de acesso pessoal enviado como token Bearer no cabeçalho Authorization. Crie e revogue tokens na página de tokens da API da sua conta — o valor em texto simples é mostrado apenas uma vez na criação.

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

limites de taxa

Tokens permitem 60 solicitações por minuto. Quando o limite é excedido a API responde com HTTP 429 com o header Retry-After — recue até lá em vez de tentar novamente imediatamente.

GET /api/v1/tools

Diretório com paginação de ferramentas ativas disponíveis — as mesmas regras de visibilidade do site. Ordenado pela popularidade (mais visitadas primeiro)."

GET /api/v1/tools/{slug}

Uma ferramenta pelo seu slug. Ferramentas que não estão publicadas, removidas ou não estão mais disponíveis respondem 404.

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

Até cinco ferramentas similares por vetor — as mesmas correspondências baseadas em embeddings mostradas no site. Ferramentas sem embedding retornam uma lista vazia.

GET /api/v1/categories

A árvore completa de categorias com subcategorias aninhadas. Em cache por seis horas.

GET /api/v1/search?q=

Busca em texto completo no diretório através do mesmo índice de busca que o site utiliza. A consulta é obrigatória e deve ter 2–120 caracteres.

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

A ferramenta objeto

Ferramentas e pontos de busca retornam uma forma JSON deliberadamente estreita: campos editoriais, pontuações internas e dados do proprietário permanecem privados.

{
  "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 }
}