NEW
Introducing Deals:
Find exclusive software deals on your favorite tools →
Findstack

Findstack API documentation

The Findstack catalog is readable by machines as well as people. Products, categories, pricing, features and integrations are available over a public REST API, an MCP server, and Markdown representations of every catalog page. Reads need no authentication.

Findstack REST API

Base URL https://findstack.com/api/v1. Responses are JSON. Fetching that base URL returns an index of every endpoint, limit and policy below — start there if you are a program.

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

  • GET /products — search and filter products
  • GET /products/{slug} — full product detail including pricing plans
  • GET /products/{slug}/integrations — what a product connects to
  • GET /categories — browse or search categories
  • GET /categories/{slug} — category detail with subcategories
  • GET /categories/{slug}/products — products within a category

Products can be filtered by q, category, tech_stack, segment, free_plan, has_api, has_ai and open_source, and sorted by rating, reviews, popularity, newest or name.

The full contract is described in OpenAPI 3.1 at /openapi.json, and catalogued per RFC 9727 at /.well-known/api-catalog.

Rate limits

120 requests per 60 seconds per IP, shared across every endpoint. Every response tells you where you stand, so you can pace requests instead of discovering the limit by hitting it:

  • RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
  • RateLimit-Policy: "catalog";q=120;w=60
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — the same numbers as separate fields, mirrored as X-RateLimit-*
  • Retry-After — seconds to wait, sent only on a 429

Errors

Every failure under /api is JSON, never an HTML page — including unknown paths and unexpected server errors. Branch on code, which is stable; message and hint are for logs and humans. 

{
  "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 in use: not_found, rate_limited, internal_error. Pages outside /api answer a 404 in Markdown when the client does not ask for HTML, with links to the sitemap, llms.txt and this page.

Versioning and deprecation policy

The version is in the path, and v1 is current. Every response also carries X-API-Version. Additive changes — a new field, a new endpoint, a new filter — ship into the current version without notice, so parse defensively and ignore fields you do not recognise.

Breaking changes ship as a new path version. When that happens, the superseded version keeps answering for at least 180 days and announces its retirement on every response:

  • Deprecation — the date the version was deprecated (RFC 9745)
  • Sunset — the date it stops answering (RFC 8594), never sooner than 180 days after the Deprecation date
  • Link: <https://findstack.com/developers#versioning>; rel="deprecation" — sent on every response, pointing here

No Deprecation or Sunset header means nothing is scheduled. The machine-readable form of this policy is the versioning object in /api/v1.

Findstack MCP server

AI agents can connect to https://findstack.com/mcp over the Model Context Protocol (Streamable HTTP transport, no authentication). Tools available: search_products, get_product, compare_products, find_alternatives, list_categories and get_category.

The server also publishes resources — the catalog's category index with slugs, this API's OpenAPI description, llms.txt, and the two agent skills below — plus resource templates addressing any product or category page by slug. Read them before calling tools; they save a round of guessing.

The server card is at /.well-known/mcp (also served at /.well-known/mcp/server-card.json).

Markdown representations

Every product, category, comparison, guide and article page returns Markdown instead of HTML when requested with Accept: text/markdown, or by appending .md to the path. The Markdown is the same content without navigation, ads or scripts — easier to cite and cheaper to read.

Agent skills

Two published skills document how to use the catalog well — discovering software, and comparing a shortlist. They are indexed at /.well-known/agent-skills/index.json.

Using the data

Catalog data may be used to answer questions and ground AI responses, with attribution to Findstack and a link to the canonical page. Bulk reuse for model training is not granted — our content signals are published in robots.txt.

Listings are editorially independent, and some carry affiliate relationships — see our disclosure and methodology. Questions: hello@findstack.com.