NIEUW
Introductie van aanbiedingen:
Vind exclusieve softwaredeals voor uw favoriete tools →
Findstack

Findstack API-documentatie

De Findstack De catalogus is zowel door machines als door mensen leesbaar. Producten, categorieën, prijzen, functies en integraties zijn beschikbaar via een openbare REST API, een MCP-server en Markdown-weergaven van elke cataloguspagina. Voor het lezen is geen authenticatie vereist.

Findstack REST API

Basis URL https://findstack.com/api/v1De reacties zijn in JSON-formaat. Het ophalen van die basis-URL levert een index op van elk eindpunt, elke limiet en elk beleid hieronder — begin daar als je een programma bent.

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

  • GET /products — Producten zoeken en filteren
  • GET /products/{slug} — volledige productdetails inclusief prijsplannen
  • GET /products/{slug}/integrations — waarmee een product verbonden is
  • GET /categories — Blader door of zoek in categorieën
  • GET /categories/{slug} — categoriedetails met subcategorieën
  • GET /categories/{slug}/products — producten binnen een categorie

Producten kunnen worden gefilterd op q, category, tech_stack, segment, free_plan, has_api, has_ai en open_sourceen gesorteerd op rating, reviews, popularity, newest or name.

Het volledige contract wordt beschreven in OpenAPI 3.1 op /openapi.json en gecatalogiseerd volgens RFC 9727 op /.well-known/api-catalog.

Tarieflimieten

120 verzoeken per 60 seconden per IP-adres, verdeeld over alle eindpunten. Elk antwoord laat je zien hoe ver je bent, zodat je verzoeken kunt doseren in plaats van de limiet te bereiken wanneer je er pas achter komt:

  • RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
  • RateLimit-Policy: "catalog";q=120;w=60
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — dezelfde getallen als afzonderlijke velden, gespiegeld als X-RateLimit-*
  • Retry-After — seconden wachten, alleen verzonden op een 429

fouten

Elke mislukking onder /api is JSON, nooit een HTML-pagina — inclusief onbekende paden en onverwachte serverfouten. Vertakking op code, wat stabiel is; message en hint zijn voor boomstammen en mensen. 

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

Gebruikte codes: not_found, rate_limited, internal_errorPagina's buiten /api Geef een 404-antwoord in Markdown wanneer de klant niet om HTML vraagt, met links naar de sitemap, llms.txt en deze pagina.

Versiebeheer- en afschrijvingsbeleid

De versie staat in het pad, en v1 is actueel. Elk antwoord bevat ook X-API-VersionAdditieve wijzigingen — een nieuw veld, een nieuw eindpunt, een nieuw filter — worden zonder voorafgaande kennisgeving in de huidige versie opgenomen. Wees daarom voorzichtig bij het parsen en negeer velden die u niet herkent.

Ingrijpende wijzigingen worden als een nieuwe padversie uitgebracht. In dat geval blijft de vervangen versie nog minstens 180 dagen beschikbaar en kondigt deze bij elke reactie aan dat deze niet langer ondersteund wordt.

  • Deprecation — de datum waarop de versie werd afgekeurd (RFC 9745)
  • Sunset — de datum waarop het stopt met reageren (RFC 8594), nooit eerder dan 180 dagen na de Deprecation gegevens
  • Link: <https://findstack.com/developers#versioning>; rel="deprecation" — verzonden bij elk antwoord, met de verwijzing hierheen

Nee Deprecation or Sunset De header betekent dat er niets gepland staat. De machineleesbare vorm van dit beleid is de versioning bezwaar in /api/v1.

Findstack MCP-server

AI-agenten kunnen verbinding maken met https://findstack.com/mcp via het Model Context Protocol (Streamable HTTP-transport, geen authenticatie). Beschikbare tools: search_products, get_product, compare_products, find_alternatives, list_categories en get_category.

De server publiceert ook resources, zoals de categorie-index van de catalogus met slugs en de OpenAPI-beschrijving van deze API. llms.txtEn de twee onderstaande agentvaardigheden, plus resourcesjablonen die elke product- of categoriepagina via de slug aanspreken. Lees ze door voordat u tools aanroept; dat bespaart u een hoop giswerk.

De serverkaart bevindt zich op /.bekend/mcp (ook geserveerd bij /.well-known/mcp/server-card.json).

Markdown-weergaven

Elke product-, categorie-, vergelijkings-, handleiding- en artikelpagina retourneert Markdown in plaats van HTML wanneer hierom wordt gevraagd. Accept: text/markdown, of door toe te voegen .md naar het pad. De Markdown-versie bevat dezelfde inhoud, maar dan zonder navigatie, advertenties of scripts – makkelijker te citeren en goedkoper om te lezen.

Agentvaardigheden

Twee gepubliceerde vaardigheidsdocumenten laten zien hoe je de catalogus goed kunt gebruiken: software ontdekken en een shortlist vergelijken. Ze zijn te vinden op /.well-known/agent-skills/index.json.

Gebruik van de gegevens

Catalogusgegevens kunnen worden gebruikt om vragen te beantwoorden en AI-reacties te onderbouwen, met vermelding van de bron. Findstack en een link naar de canonieke pagina. Hergebruik in bulk voor modeltraining is niet toegestaan ​​— onze inhoudssignalen worden gepubliceerd in robots.txt.

De advertenties zijn onafhankelijk van de redactie en sommige hebben een affiliate-relatie — zie onze onthulling en methodologieVragen: Hallo@findstack.com.