Findstack API dokumentation

Ocuco-landskapet Findstack Katalogen är läsbar av både maskiner och människor. Produkter, kategorier, priser, funktioner och integrationer är tillgängliga via ett publikt REST API, en MCP-server och Markdown-representationer av varje katalogsida. Läsningar kräver ingen autentisering.

Findstack REST API

Grundadress https://findstack.com/api/v1Svaren är i JSON. Hämtning av bas-URL:en returnerar ett index för varje slutpunkt, gräns och policy nedan – börja där om du är ett program.

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

• GET /products — sök och filtrera produkter
• GET /products/{slug} — fullständig produktinformation inklusive prisplaner
• GET /products/{slug}/integrations — vad en produkt ansluter till
• GET /categories — bläddra bland eller sök i kategorier
• GET /categories/{slug} — kategoridetaljer med underkategorier
• GET /categories/{slug}/products — produkter inom en kategori

Produkter kan filtreras efter q, category, tech_stack, segment, free_plan, has_api, has_ai och open_sourceoch sorterat efter rating, reviews, popularity, newest or name.

Det fullständiga kontraktet beskrivs i OpenAPI 3.1 på /openapi.json och katalogiseras enligt RFC 9727 på /.well-known/api-catalog.

Prisgränser

120 förfrågningar per 60 sekunder per IP, delat över varje slutpunkt. Varje svar visar var du står, så att du kan tempot för förfrågningar istället för att upptäcka gränsen genom att nå den:

• RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
• RateLimit-Policy: "catalog";q=120;w=60
• RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — samma siffror som separata fält, speglade som X-RateLimit-*
• Retry-After — sekunder att vänta, skickas endast på en 429

fel

Varje misslyckande under /api är JSON, aldrig en HTML-sida — inklusive okända sökvägar och oväntade serverfel. Förgrena sig på code, vilket är stabilt; message och hint är för stockar och människor.

{
  "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 som används: not_found, rate_limited, internal_errorSidor utanför /api svara på ett 404-fel i Markdown när klienten inte frågar efter HTML, med länkar till webbplatskartan, llms.txt och den här sidan.

Versionshantering och avskrivningspolicy

Versionen finns i sökvägen, och v1 är aktuellt. Varje svar bär också med sig X-API-VersionAdditiva ändringar – ett nytt fält, en ny slutpunkt, ett nytt filter – läggs till i den aktuella versionen utan föregående meddelande, så analysera defensivt och ignorera fält du inte känner igen.

Brytande ändringar skickas som en ny version av sökvägen. När det händer fortsätter den ersatta versionen att svara i minst 180 dagar och meddelar att den tas bort vid varje svar:

• Deprecation — datumet då versionen föråldrades (RFC 9745)
• Sunset — det datum då det slutar svara (RFC 8594), aldrig tidigare än 180 dagar efter Deprecation datum
• Link: <https://findstack.com/developers#versioning>; rel="deprecation" — skickas på varje svar, pekar hit

Nej Deprecation or Sunset rubriken betyder att ingenting är schemalagt. Den maskinläsbara formen av denna policy är versioning objekt i /api/v1.

Findstack MCP-server

AI-agenter kan ansluta till https://findstack.com/mcp över Model Context Protocol (strömningsbar HTTP-transport, ingen autentisering). Tillgängliga verktyg: search_products, get_product, compare_products, find_alternatives, list_categories och get_category.

Servern publicerar även resurser — katalogens kategoriindex med slugs, detta API:s OpenAPI-beskrivning, llms.txtoch de två agentfärdigheterna nedan – plus resursmallar som adresserar valfri produkt- eller kategorisida per slug. Läs dem innan du anropar verktyg; de sparar en omgång gissningar.

Serverkortet är på /.välkänd/mcp (serveras även kl. /.well-known/mcp/server-card.json).

Markdown-representationer

Varje produkt-, kategori-, jämförelse-, guide- och artikelsida returnerar Markdown istället för HTML när den begärs med Accept: text/markdown, eller genom att lägga till .md till sökvägen. Markdown är samma innehåll utan navigering, annonser eller skript – lättare att citera och billigare att läsa.

Agentfärdigheter

Två publicerade färdigheter dokumenterar hur man använder katalogen på ett bra sätt – att upptäcka programvara och jämföra en kortlista. De finns indexerade på /.well-known/agent-skills/index.json.

Använda data

Katalogdata kan användas för att besvara frågor och AI-svar, med hänvisning till Findstack och en länk till den kanoniska sidan. Massåteranvändning för modellträning är inte tillåten — våra innehållssignaler publiceras i robots.txt.

Listorna är redaktionellt oberoende, och vissa har affiliate-relationer – se vår avslöjande och metodikFrågor: Hej@findstack.com.