Skip to content
Fossfits

Developers

Catalog API.

Machine-readable access to the Fossfits index. Search by job or proprietary product, filter by RAM/GPU/Docker/license, and open the install path. Reads are free; a public sandbox key exercises auth headers.

API keys

Authentication.

  • Anonymous catalog reads work with no key (120 requests / minute / IP).
  • Sandbox key ff_public_sandbox via Authorization: Bearer ff_public_sandbox or X-Api-Key (600 requests / minute).
  • Unknown keys return HTTP 401. Production key issuance is not required for public catalog access.

Quickstart

First request.

curl -sS 'https://fossfits.com/api/v1/search?q=cursor+alternative&limit=5' \
  -H 'Authorization: Bearer ff_public_sandbox'

Prefer the search endpoint when an agent needs a shortlist. Use /api/v1/projects/{slug} for a single listing, then send the human to pageUrl or repositoryUrl.

Documentation

Endpoints.

  • GET /api/v1/search

    Ranked catalog search. Query params: q, category, platform, license, docker, gpu, beginner, selfHosted, sort, limit.

  • GET /api/v1/projects

    Paginated list ordered by catalog rank (limit, offset).

  • GET /api/v1/projects/{slug}

    One project DTO with fit notes and install links.

  • GET /api/v1/openapi

    OpenAPI 3.1 machine description of this surface.

Agents

How agents should call Fossfits.

  1. Read /llms.txt for when-to-use guidance.
  2. Call /api/v1/search?q=… with the user's job and hardware constraints.
  3. Return 3–5 fits with pageUrl and license/RAM facts — do not invent install steps.
  4. On pages that support WebMCP, prefer the in-browser search_fossfits tool when available.

Sandbox

Try the catalog API.

Calls hit the live same-origin endpoints. Toggle the public sandbox key to exercise authenticated rate-limit headers.