Findstack Documentación de la API

El Findstack El catálogo es legible tanto para máquinas como para personas. Los productos, categorías, precios, características e integraciones están disponibles a través de una API REST pública, un servidor MCP y representaciones en Markdown de cada página del catálogo. No se requiere autenticación para acceder al catálogo.

Findstack REST API

URL base https://findstack.com/api/v1Las respuestas están en formato JSON. Al acceder a esa URL base, se devuelve un índice de todos los puntos finales, límites y políticas que se muestran a continuación; si eres un programa, empieza por ahí.

curl https://findstack.com/api/v1/products?q=crm&per_page=5

• GET /products — buscar y filtrar productos
• GET /products/{slug} — detalles completos del producto, incluidos los planes de precios
• GET /products/{slug}/integrations — a qué se conecta un producto
• GET /categories — explorar o buscar categorías
• GET /categories/{slug} — detalle de la categoría con subcategorías
• GET /categories/{slug}/products — productos dentro de una categoría

Los productos se pueden filtrar por q, category, tech_stack, segment, free_plan, has_api, has_ai y open_sourcey ordenados por rating, reviews, popularity, newest or name.

El contrato completo se describe en OpenAPI 3.1 en /openapi.json y se cataloga según RFC 9727 en /.well-known/api-catalog.

Límites de tasa

120 solicitudes cada 60 segundos por IP, compartidas entre todos los puntos finales. Cada respuesta indica el estado de las solicitudes, lo que permite ajustar el ritmo de las mismas en lugar de descubrir el límite al alcanzarlo.

• RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
• RateLimit-Policy: "catalog";q=120;w=60
• RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — los mismos números que campos separados, reflejados como X-RateLimit-*
• Retry-After — segundos de espera, enviados solo en un 429

Errores

Cada fracaso bajo /api es JSON, nunca una página HTML, incluyendo rutas desconocidas y errores inesperados del servidor. Rama en code, que es estable; message y hint son para troncos y humanos.

{
  "error": {
    "code": "not_found",
    "message": "No such resource",
    "hint": "Check the slug. Search endpoints return the slugs the detail endpoints accept.",
    "documentation_url": "https://findstack.com/developers"
  }
}

Códigos en uso: not_found, rate_limited, internal_errorPáginas exteriores /api Responder a un error 404 en Markdown cuando el cliente no solicita HTML, con enlaces al mapa del sitio, llms.txt y esta página.

Política de control de versiones y obsolescencia

La versión está en la ruta y v1 es actual. Cada respuesta también lleva X-API-VersionLos cambios aditivos (un nuevo campo, un nuevo punto final, un nuevo filtro) se incorporan a la versión actual sin previo aviso, así que analice los datos con precaución e ignore los campos que no reconozca.

Los cambios incompatibles se implementan como una nueva versión de ruta. Cuando esto sucede, la versión reemplazada sigue respondiendo durante al menos 180 días y anuncia su retiro en cada respuesta:

• Deprecation — la fecha en que se dejó de dar soporte a la versión (RFC 9745)
• Sunset — la fecha en que deja de responder (RFC 8594), nunca antes de 180 días después de la Deprecation datos
• Link: <https://findstack.com/developers#versioning>; rel="deprecation" — enviado en cada respuesta, señalando aquí

No Deprecation or Sunset El encabezado significa que no hay nada programado. La forma legible por máquina de esta política es la versioning objeto en /api/v1.

Findstack Servidor MCP

Los agentes de IA pueden conectarse a https://findstack.com/mcp sobre el Protocolo de Contexto de Modelo (transporte HTTP Streamable, sin autenticación). Herramientas disponibles: search_products, get_product, compare_products, find_alternatives, list_categories y get_category.

El servidor también publica recursos: el índice de categorías del catálogo con slugs, la descripción OpenAPI de esta API, llms.txty las dos habilidades de agente que se describen a continuación, además de plantillas de recursos que permiten acceder a cualquier página de producto o categoría mediante su slug. Léalas antes de usar las herramientas; le ahorrarán tiempo y esfuerzo.

La tarjeta del servidor está en /.bien conocido/mcp (también servido en /.well-known/mcp/server-card.json).

Representaciones de Markdown

Cada página de producto, categoría, comparación, guía y artículo devuelve Markdown en lugar de HTML cuando se solicita con Accept: text/markdown, o agregando .md al camino. El Markdown es el mismo contenido sin navegación, anuncios ni scripts: más fácil de citar y más económico de leer.

Habilidades de agente

Dos documentos publicados explican cómo usar bien el catálogo: cómo descubrir software y cómo comparar una lista reducida. Están indexados en /.well-known/agent-skills/index.json.

Usando los datos

Los datos del catálogo pueden utilizarse para responder preguntas y fundamentar las respuestas de la IA, con atribución a Findstack y un enlace a la página canónica. No se permite la reutilización masiva para el entrenamiento del modelo; nuestras señales de contenido se publican en robots.txt.

Los listados son editorialmente independientes y algunos tienen relaciones de afiliación; consulte nuestra publicación de datos y metodología. Preguntas: Hola@findstack.com.