Public API · no key

A directory that agents can read.

Search the catalog, filter it, or keep a local copy continuously in sync. Returns JSON, needs no key, allows cross-origin requests, and is cached at the edge. 55 specs across 13 categories and 32 systems, each one carrying its own constraints.

Base endpoint

GET https://plaintiffbots.com/api/bots

Browse and search

Newest first

qSearches names, summaries, spec text, categories, systems, and contributors—

categoryExact category slug, case-insensitive—

integrationExact system name, case-insensitive. system also works—

pagePage number1

limitResults per request, maximum 10025

sortnewest or namenewest

Example

GET https://plaintiffbots.com/api/bots?q=filevine&category=agency-oversight&limit=25&sort=name

Continuous sync

Append-safe

Cursor mode returns specs oldest to newest, so a client can store each page and append later additions without page numbers shifting underneath it. Start with cursor=start, keep sync.nextCursor, then call links.next later. Keep the same filters when reusing a cursor.

Cursor mode

GET https://plaintiffbots.com/api/bots?cursor=start&limit=100

{
  "bots": [ ... ],
  "sync": { "returned": 100, "hasMore": true, "nextCursor": "NDI=" },
  "links": { "next": "https://plaintiffbots.com/api/bots?cursor=NDI=&limit=100" }
}

Every endpoint

32 systems · 13 categories

/api/botsSearch, filter, paginate, or cursor-sync the catalogJSON

/api/bots/{slug}One spec in full, including its prompt and constraintsJSON

/api/bots.jsonComplete catalog in one request, no paginationJSON

/api/categoriesAll categories with their standing rulesJSON

/api/systemsEvery system, ranked by spec countJSON

What a spec returns

Fields

promptThe full spec text, ready to pastestring

neverWhat the spec must never do without approvalarray

untrusted_inputWhich inputs the spec did not author, and the rule it applies to themobject

cautionThe confidentiality, advertising, or supervision exposure it touchesstring

integrationsSystems it connects toarray

verified_atWhen the spec was last revieweddate

attributionContributor name, handle, and linkobject

Send this page to an agent

This page is the whole contract.

Everything an agent needs to consume the directory is on this page, in HTML, without JavaScript. Hand it https://plaintiffbots.com/api/ and ask it to browse the catalog or maintain a cursor-based local mirror. No key to provision, no docs to hunt for.

Terms, such as they are

The specs are free to copy, adapt, run, and redistribute. Attribution is appreciated and each record carries its contributor. Mirror the catalog if it is useful to you. What you cannot do is strip the never, caution, and untrusted_input fields and republish the prompts alone — those constraints are the reason the specs are safe to run, and a spec without them is a different and worse artifact.

Building something on it?

Tell me what you are making and I will keep the shape stable for you.

Get in touch