Public API

Endpoint

GET /api/v1/resources?query=&category=&limit=&cursor=

A mirrored, always-unauthenticated copy lives at /api/public/v1/resources — use that one from servers and crawlers.

Parameters

query

Free-text match on name, tagline, description and tags. Max 100 characters.

category

Category slug, for example agent-frameworks.

limit

Page size between 1 and 50. Defaults to 20.

cursor

Pass next_cursor unchanged for the same query and category. Opaque slug cursors preserve timestamp ties. Legacy ISO timestamps are accepted; invalid or stale cursors return 400.

Example response

{
  "api_version": "v1",
  "count": 1,
  "next_cursor": "v1:example-agent-framework",
  "data": [
    {
      "id": "…",
      "slug": "example-agent-framework",
      "name": "Example Agent Framework",
      "url": "https://example.com/",
      "category": "agent-frameworks",
      "tags": ["example", "placeholder"],
      "tier": "free",
      "claim_status": "unclaimed",
      "is_sponsored": false,
      "sponsorship_label": null,
      "premium_ends_at": null,
      "sponsor_starts_at": null,
      "sponsor_ends_at": null,
      "is_example": false,
      "detail_url": "/listing/example-agent-framework"
    }
  ]
}

Honesty guarantees

• is_sponsored is true only during a live Sponsored placement; sponsorship_label is “Sponsored” then and null otherwise. The public API exposes entitlement fields explicitly. Website category pages present Sponsored placements first, then Premium, then Free; Sponsored placements are always labelled.
• is_example marks demonstration records that do not describe real products.
• tier is free, premium or sponsored based on current public entitlement. It is null when entitlement data is unavailable. Premium alone is not Sponsored.
• claim_status is claimed or unclaimed. Owner IDs, email addresses and moderation notes are omitted.
• Unknown categories return 404; an unavailable directory returns 503 without partial results.
• No ratings, reviews or traffic estimates are exposed, because we cannot verify them.

Machine-readable extras

• /api/v1/openapi.json — full OpenAPI 3.1 schema.
• /llms.txt — summary for AI crawlers.
• /sitemap.xml — every public page.
• /api/public/health — service and database status.