Desarrolladores

API pública de ChatableApps v1

Acceso JSON de solo lectura al directorio de herramientas de IA: más de 8,000 herramientas, categorías, búsqueda de texto completo y alternativas por similitud de vectores. Autentíquese con un token de acceso personal y comience a consultar en minutos.

Autenticación

Cada endpoint requiere un token de acceso personal enviado como token Bearer en el encabezado Authorization. Crea y revoca tokens en la página de tokens de API de tu cuenta — el valor en texto plano solo se muestra una vez en la creación.

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

Límites de velocidad

Tokens permiten 60 solicitudes por minuto. Cuando se excede el límite la API responde HTTP 429 con una cabecera Retry-After — retrocede hasta entonces en lugar de reintentar de inmediato.

GET /api/v1/tools

Directorio paginado de herramientas en vivo y disponibles — las mismas reglas de visibilidad que el sitio web. Ordenado por popularidad (el más visitado primero)

GET /api/v1/tools/{slug}

Una herramienta por su slug. Las herramientas que no están publicadas, deslistadas o ya no disponibles responden 404.

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

Hasta cinco herramientas similares por vector: las mismas coincidencias basadas en embeddings que se muestran en el sitio web. Las herramientas sin embedding devuelven una lista vacía

GET /api/v1/categories

La estructura completa de categorías con subcategorías anidadas. Cached for six hours.

GET /api/v1/search?q=

Búsqueda de texto completo a través del directorio mediante el mismo índice de búsqueda que utiliza el sitio web. La consulta es obligatoria y debe tener entre 2 y 120 caracteres.

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

El objeto de la herramienta

Herramientas y puntos finales de búsqueda devuelven una forma JSON deliberadamente estrecha: los campos editoriales, las puntuaciones internas y los datos del propietario permanecen 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 }
}