NY
Introduktion af tilbud:
Find eksklusive softwaretilbud på dine yndlingsværktøjer →
Findstack

Findstack API dokumentation

Findstack Kataloget kan læses af både maskiner og mennesker. Produkter, kategorier, priser, funktioner og integrationer er tilgængelige via en offentlig REST API, en MCP-server og Markdown-repræsentationer af hver katalogside. Læsninger kræver ingen godkendelse.

Findstack REST-API

Basis-URL https://findstack.com/api/v1Svarene er JSON. Hentning af den basis-URL returnerer et indeks over alle endpoints, limits og policys nedenfor – start der, hvis du er et program.

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

  • GET /products — søg og filtrer produkter
  • GET /products/{slug} — komplette produktdetaljer inklusive prisplaner
  • GET /products/{slug}/integrations — hvad et produkt forbinder til
  • GET /categories — gennemse eller søg i kategorier
  • GET /categories/{slug} — kategoridetaljer med underkategorier
  • GET /categories/{slug}/products — produkter inden for en kategori

Produkter kan filtreres efter q, category, tech_stack, segment, free_plan, has_api, has_ai og open_sourceog sorteret efter rating, reviews, popularity, newest or name.

Den fulde kontrakt er beskrevet i OpenAPI 3.1 på /openapi.json og katalogiseret i henhold til RFC 9727 på /.well-known/api-catalog.

Satsgrænser

120 anmodninger pr. 60 sekunder pr. IP, delt på tværs af alle endpoints. Hvert svar fortæller dig, hvor du står, så du kan sætte tempoet for anmodninger i stedet for at opdage grænsen ved at nå den:

  • RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
  • RateLimit-Policy: "catalog";q=120;w=60
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — de samme tal som separate felter, spejlvendt som X-RateLimit-*
  • Retry-After — sekunder at vente, sendes kun på en 429

fejl

Enhver fiasko under /api er JSON, aldrig en HTML-side — inklusive ukendte stier og uventede serverfejl. Forgrening på code, som er stabil; message og hint er til træstammer og mennesker. 

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

Koder i brug: not_found, rate_limited, internal_errorSider udenfor /api besvare en 404-fejl i Markdown, når klienten ikke beder om HTML, med links til sitemap, llms.txt og denne side.

Versions- og udfasningspolitik

Versionen er i stien, og v1 er aktuel. Hvert svar indeholder også X-API-VersionAdditive ændringer — et nyt felt, et nyt slutpunkt, et nyt filter — indføres i den aktuelle version uden varsel, så pars defensivt og ignorer felter, du ikke genkender.

Ændringer, der ikke overholder reglerne, sendes som en ny version. Når det sker, fortsætter den erstattede version med at svare i mindst 180 dage og annoncerer sin tilbagetrækning ved hvert svar:

  • Deprecation — datoen, hvor versionen blev udfaset (RFC 9745)
  • Sunset — den dato, hvor den stopper med at svare (RFC 8594), aldrig tidligere end 180 dage efter Deprecation dato
  • Link: <https://findstack.com/developers#versioning>; rel="deprecation" — sendt på hvert svar, peger her

Ingen Deprecation or Sunset header betyder, at intet er planlagt. Den maskinlæsbare form af denne politik er versioning objekt i /api/v1.

Findstack MCP-server

AI-agenter kan oprette forbindelse til https://findstack.com/mcp over Model Context Protocol (streambar HTTP-transport, ingen godkendelse). Tilgængelige værktøjer: search_products, get_product, compare_products, find_alternatives, list_categories og get_category.

Serveren udgiver også ressourcer — katalogets kategoriindeks med slugs, denne API's OpenAPI-beskrivelse, llms.txtog de to agentfærdigheder nedenfor — plus ressourceskabeloner, der adresserer enhver produkt- eller kategoriside efter slug. Læs dem, før du kalder værktøjer; de sparer dig en runde med gætteri.

Serverkortet er på /.velkendt/mcp (serveres også kl. /.well-known/mcp/server-card.json).

Markdown-repræsentationer

Alle produkt-, kategori-, sammenlignings-, guide- og artikelsider returnerer Markdown i stedet for HTML, når der anmodes om det med Accept: text/markdowneller ved at tilføje .md til stien. Markdown er det samme indhold uden navigation, annoncer eller scripts – lettere at citere og billigere at læse.

Agentfærdigheder

To publicerede færdigheder dokumenterer, hvordan man bruger kataloget godt – at opdage software og sammenligne en liste over udvalgte. De er indekseret på /.well-known/agent-skills/index.json.

Brug af data

Katalogdata kan bruges til at besvare spørgsmål og AI-baserede svar, med henvisning til Findstack og et link til den kanoniske side. Massegenbrug til modeltræning er ikke tilladt — vores indholdssignaler offentliggøres i robots.txt.

Opslag er redaktionelt uafhængige, og nogle har affilierede relationer – se vores videregivelse og metodologiSpørgsmål: Hej@findstack.com .