NOVAS
Apresentando ofertas:
Encontre ofertas exclusivas de software em suas ferramentas favoritas →
Findstack

Findstack Documentação da API

O Findstack O catálogo pode ser lido tanto por máquinas quanto por pessoas. Produtos, categorias, preços, recursos e integrações estão disponíveis por meio de uma API REST pública, um servidor MCP e representações em Markdown de cada página do catálogo. A leitura não requer autenticação.

Findstack API REST

URL base https://findstack.com/api/v1As respostas são em formato JSON. A obtenção dessa URL base retorna um índice de todos os endpoints, limites e políticas abaixo — comece por aí se você for um programa.

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

  • GET /products — pesquisar e filtrar produtos
  • GET /products/{slug} — Detalhes completos do produto, incluindo planos de preços
  • GET /products/{slug}/integrations — a que um produto se conecta
  • GET /categories — Navegue ou pesquise categorias
  • GET /categories/{slug} — Detalhes da categoria com subcategorias
  • GET /categories/{slug}/products — produtos dentro de uma categoria

Os produtos podem ser filtrados por q, category, tech_stack, segment, free_plan, has_api, has_ai e open_sourcee classificados por rating, reviews, popularity, newest or name.

O contrato completo está descrito no OpenAPI 3.1 em /openapi.json e catalogado de acordo com a RFC 9727 em /.well-known/api-catalog.

Limites de taxa

120 requisições a cada 60 segundos por IP, distribuídas entre todos os endpoints. Cada resposta informa o seu status, permitindo que você controle o ritmo das requisições em vez de descobrir o limite ao atingi-lo:

  • RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
  • RateLimit-Policy: "catalog";q=120;w=60
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — os mesmos números que campos separados, espelhados como X-RateLimit-*
  • Retry-After — segundos para aguardar, enviado apenas em um 429

erros

Todo fracasso sob /api É JSON, nunca uma página HTML — incluindo caminhos desconhecidos e erros inesperados do servidor. Branch on code, que é estável; message e hint são para toras e 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 em uso: not_found, rate_limited, internal_errorPáginas externas /api Responder a um erro 404 em Markdown quando o cliente não solicitar HTML, com links para o mapa do site, llms.txt e esta página.

Política de versionamento e descontinuação

A versão está no caminho, e v1 está em vigor. Cada resposta também carrega X-API-VersionAlterações aditivas — um novo campo, um novo endpoint, um novo filtro — são incorporadas à versão atual sem aviso prévio, portanto, analise de forma defensiva e ignore os campos que você não reconhece.

Alterações que quebram a compatibilidade são lançadas como uma nova versão do caminho. Quando isso acontece, a versão substituída continua respondendo por pelo menos 180 dias e anuncia sua descontinuação em cada resposta.

  • Deprecation — a data em que a versão foi descontinuada (RFC 9745)
  • Sunset — a data em que para de responder (RFC 8594), nunca antes de 180 dias após o Deprecation dados
  • Link: <https://findstack.com/developers#versioning>; rel="deprecation" — enviado em todas as respostas, apontando para cá

Não Deprecation or Sunset O cabeçalho significa que nada está agendado. A forma legível por máquina desta política é o versioning objeto em /api/v1.

Findstack Servidor MCP

Agentes de IA podem se conectar a https://findstack.com/mcp Sobre o Protocolo de Contexto de Modelo (transporte HTTP Streamable, sem autenticação). Ferramentas disponíveis: search_products, get_product, compare_products, find_alternatives, list_categories e get_category.

O servidor também publica recursos — o índice de categorias do catálogo com seus respectivos slugs, a descrição OpenAPI desta API, llms.txte as duas habilidades de agente abaixo — além de modelos de recursos que abordam qualquer página de produto ou categoria pelo slug. Leia-os antes de usar as ferramentas; eles evitam uma rodada de adivinhação.

A placa do servidor está em /.bem-conhecido/mcp (também servido em /.well-known/mcp/server-card.json).

Representações em Markdown

Todas as páginas de produtos, categorias, comparações, guias e artigos retornam Markdown em vez de HTML quando solicitadas com Accept: text/markdown, ou anexando .md para o caminho. O Markdown é o mesmo conteúdo sem navegação, anúncios ou scripts — mais fácil de citar e mais barato de ler.

Habilidades do agente

Dois documentos de habilidades publicados mostram como usar o catálogo de forma eficaz — descobrindo softwares e comparando uma lista restrita. Eles estão indexados em /.well-known/agent-skills/index.json.

Usando os dados

Os dados do catálogo podem ser usados ​​para responder a perguntas e fundamentar as respostas da IA, com atribuição a Findstack e um link para a página canônica. A reutilização em massa para treinamento de modelos não é permitida — nossos sinais de conteúdo são publicados em robots.txt.

Os anúncios são editorialmente independentes e alguns envolvem parcerias de afiliados — consulte nossa política de privacidade. divulgação e metodologia. Questões: Olá@findstack.com.