Findstack Documentation de l'API

Le Findstack Le catalogue est accessible aussi bien aux machines qu'aux humains. Les produits, les catégories, les prix, les fonctionnalités et les intégrations sont disponibles via une API REST publique, un serveur MCP et des représentations Markdown de chaque page du catalogue. Aucune authentification n'est requise pour la consultation.

Findstack API REST

URL de base https://findstack.com/api/v1Les réponses sont au format JSON. La récupération de cette URL de base renvoie un index de chaque point de terminaison, limite et politique ci-dessous ; commencez par là si vous êtes un programme.

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

GET /products — rechercher et filtrer les produits
GET /products/{slug} — Détails complets du produit, y compris les tarifs
GET /products/{slug}/integrations — à quoi un produit se connecte
GET /categories — Parcourir ou rechercher des catégories
GET /categories/{slug} — détail de la catégorie avec sous-catégories
GET /categories/{slug}/products — produits au sein d'une catégorie

Les produits peuvent être filtrés par q, category, tech_stack, segment, free_plan, has_api, has_ai et open_sourceet triés par rating, reviews, popularity, newest or name.

Le contrat complet est décrit dans OpenAPI 3.1 à l'adresse /openapi.json et catalogué conformément à la RFC 9727 à l'adresse /.well-known/api-catalog.

Limites de taux

120 requêtes toutes les 60 secondes par adresse IP, réparties entre tous les points de terminaison. Chaque réponse vous indique votre position, ce qui vous permet de gérer vos requêtes au lieu de découvrir la limite par vous-même.

RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
RateLimit-Policy: "catalog";q=120;w=60
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — les mêmes nombres sous forme de champs séparés, reflétés comme X-RateLimit-*
Retry-After — quelques secondes à attendre, envoyé uniquement sur un 429

Erreurs

Chaque échec sous /api Il s'agit de JSON, jamais d'une page HTML — y compris les chemins inconnus et les erreurs de serveur inattendues. Branchez sur code, qui est stable ; message et hint sont destinées aux bûches et aux humains.

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

Codes utilisés : not_found, rate_limited, internal_errorPages en dehors /api Répondre à une erreur 404 en Markdown lorsque le client ne demande pas de HTML, avec des liens vers le plan du site, llms.txt et cette page.

Politique de versionnage et de dépréciation

La version se trouve dans le chemin d'accès, et v1 est à jour. Chaque réponse contient également X-API-VersionLes modifications additives (un nouveau champ, un nouveau point de terminaison, un nouveau filtre) sont intégrées à la version actuelle sans préavis ; il est donc conseillé d’analyser le code de manière défensive et d’ignorer les champs que vous ne reconnaissez pas.

Les modifications importantes sont déployées sous forme de nouvelle version. Dans ce cas, la version remplacée continue de répondre pendant au moins 180 jours et annonce sa mise hors service à chaque réponse.

Deprecation — la date à laquelle la version est devenue obsolète (RFC 9745)
Sunset — la date à laquelle il cesse de répondre (RFC 8594), jamais avant 180 jours après la Deprecation données
Link: <https://findstack.com/developers#versioning>; rel="deprecation" — envoyé pour chaque réponse, pointant ici

Non Deprecation or Sunset L'en-tête indique qu'aucune planification n'est prévue. La version lisible par machine de cette politique est la suivante : versioning objet dans /api/v1.

Findstack serveur MCP

Les agents d'IA peuvent se connecter à https://findstack.com/mcp via le protocole MCP (transport HTTP continu, sans authentification). Outils disponibles : search_products, get_product, compare_products, find_alternatives, list_categories et get_category.

Le serveur publie également des ressources : l’index des catégories du catalogue avec leurs identifiants, la description OpenAPI de cette API, llms.txt, ainsi que les deux compétences d'agent ci-dessous — et des modèles de ressources pour chaque page produit ou catégorie grâce à son identifiant. Consultez-les avant d'utiliser les outils ; cela vous évitera de tâtonner.

La carte serveur se trouve à /.bien-connu/mcp (également servi à /.well-known/mcp/server-card.json).

Représentations Markdown

Chaque page produit, catégorie, comparaison, guide et article renvoie du Markdown au lieu du HTML lorsqu'elle est demandée avec Accept: text/markdown, ou en ajoutant .md au chemin. Le Markdown est le même contenu sans navigation, publicités ni scripts — plus facile à citer et moins coûteux à lire.

compétences d'agent

Deux guides de compétences publiés expliquent comment bien utiliser le catalogue : découvrir des logiciels et comparer une sélection. Ils sont indexés à l’adresse /.well-known/agent-skills/index.json.

Utiliser les données

Les données du catalogue peuvent être utilisées pour répondre à des questions et étayer les réponses de l'IA, avec attribution à Findstack et un lien vers la page canonique. La réutilisation en masse pour l'entraînement de modèles n'est pas autorisée ; nos signaux de contenu sont publiés dans robots.txt.

Les annonces sont publiées de manière indépendante sur le plan éditorial, et certaines comportent des liens d'affiliation — consultez notre page dédiée. divulgation et méthodologieQuestions : Bonjour@findstack.com.