Findstack API-Dokumentation

Das Findstack Der Katalog ist sowohl für Maschinen als auch für Menschen lesbar. Produkte, Kategorien, Preise, Funktionen und Integrationen sind über eine öffentliche REST-API, einen MCP-Server und Markdown-Darstellungen jeder Katalogseite verfügbar. Zum Lesen ist keine Authentifizierung erforderlich.

Findstack REST API

Basis-URL https://findstack.com/api/v1Die Antworten erfolgen im JSON-Format. Durch Abrufen der Basis-URL wird ein Index aller unten aufgeführten Endpunkte, Limits und Richtlinien zurückgegeben – beginnen Sie dort, wenn Sie ein Programm sind.

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

GET /products — Produkte suchen und filtern
GET /products/{slug} — vollständige Produktdetails einschließlich Preisplänen
GET /products/{slug}/integrations — womit ein Produkt verbunden ist
GET /categories — Kategorien durchsuchen oder suchen
GET /categories/{slug} — Kategoriedetails mit Unterkategorien
GET /categories/{slug}/products — Produkte innerhalb einer Kategorie

Produkte können gefiltert werden nach q, category, tech_stack, segment, free_plan, has_api, has_ai und open_sourceund sortiert nach rating, reviews, popularity, newest or name.

Der vollständige Vertrag ist in OpenAPI 3.1 unter /openapi.json beschrieben und gemäß RFC 9727 unter /.well-known/api-catalog katalogisiert.

Ratenlimits

120 Anfragen pro 60 Sekunden pro IP-Adresse, verteilt auf alle Endpunkte. Jede Antwort zeigt Ihnen den aktuellen Stand an, sodass Sie die Anfragen steuern können, anstatt das Limit erst durch Anstoßen zu entdecken:

RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
RateLimit-Policy: "catalog";q=120;w=60
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — die gleichen Zahlen als separate Felder, gespiegelt als X-RateLimit-*
Retry-After — Sekunden Wartezeit, wird nur auf einem gesendet 429

Fehler

Jeder Fehler unter /api ist JSON, niemals eine HTML-Seite – einschließlich unbekannter Pfade und unerwarteter Serverfehler. Weiter zu Branch on code, das stabil ist; message und hint sind für Baumstämme und Menschen.

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

Verwendete Codes: not_found, rate_limited, internal_error. Seiten außerhalb /api Eine 404-Fehlermeldung in Markdown beantworten, wenn der Client kein HTML anfordert, mit Links zur Sitemap, llms.txt und dieser Seite.

Versions- und Veraltungsrichtlinie

Die Version befindet sich im Pfad, und v1 ist aktuell. Jede Antwort beinhaltet auch X-API-VersionAdditive Änderungen – ein neues Feld, ein neuer Endpunkt, ein neuer Filter – werden ohne Vorankündigung in die aktuelle Version eingespielt. Analysieren Sie daher defensiv und ignorieren Sie Felder, die Sie nicht erkennen.

Änderungen, die den Spielfluss stören, werden als neue Pfadversion veröffentlicht. In diesem Fall antwortet die abgelöste Version mindestens 180 Tage lang und kündigt bei jeder Antwort ihre Außerbetriebnahme an:

Deprecation — das Datum, an dem die Version als veraltet eingestuft wurde (RFC 9745)
Sunset — das Datum, an dem es nicht mehr antwortet (RFC 8594), frühestens 180 Tage nach dem Deprecation Datum
Link: <https://findstack.com/developers#versioning>; rel="deprecation" — wurde bei jeder Antwort gesendet und verweist hierher

Nein Deprecation or Sunset Der Header bedeutet, dass nichts geplant ist. Die maschinenlesbare Form dieser Richtlinie ist die versioning Objekt in /api/v1.

Findstack MCP-Server

KI-Agenten können sich verbinden mit https://findstack.com/mcp über das Model Context Protocol (Streamable HTTP-Transport, keine Authentifizierung). Verfügbare Tools: search_products, get_product, compare_products, find_alternatives, list_categories und get_category.

Der Server veröffentlicht außerdem Ressourcen – den Kategorienindex des Katalogs mit Slugs, die OpenAPI-Beschreibung dieser API, llms.txtund die beiden unten aufgeführten Agentenfähigkeiten – sowie Ressourcenvorlagen, die jede Produkt- oder Kategorieseite anhand ihres Slugs ansprechen. Lesen Sie diese, bevor Sie die Tools aufrufen; das erspart Ihnen unnötiges Rätselraten.

Die Serverkarte befindet sich bei /.well-known/mcp (wird auch serviert bei /.well-known/mcp/server-card.json).

Markdown-Darstellungen

Jede Produkt-, Kategorie-, Vergleichs-, Ratgeber- und Artikelseite liefert bei Anfrage Markdown anstelle von HTML zurück. Accept: text/markdown, oder durch Anhängen .md Zum Pfad. Markdown ist derselbe Inhalt ohne Navigation, Werbung oder Skripte – einfacher zu zitieren und kostengünstiger zu lesen.

Agentenfähigkeiten

Zwei veröffentlichte Anleitungen zeigen, wie man den Katalog optimal nutzt – Software entdecken und eine Auswahlliste vergleichen. Sie sind unter /.well-known/agent-skills/index.json indexiert.

Nutzung der Daten

Katalogdaten können verwendet werden, um Fragen zu beantworten und KI-Antworten zu begründen, wobei die Urheberschaft anerkannt wird. Findstack und ein Link zur Originalseite. Massenhafte Wiederverwendung für das Modelltraining ist nicht gestattet – unsere Inhaltssignale werden veröffentlicht in robots.txt.

Die Einträge sind redaktionell unabhängig, und einige beinhalten Affiliate-Beziehungen – siehe unsere Bekanntgabe und MethodikFragen: Hallo@findstack.com €XNUMX.