Do I need an API key?

No. Every endpoint is public and read only, with open CORS so browser based agents can call it directly.

Which format should an LLM agent use?

JSON for tool calls, Markdown (format=md) when the result goes straight into a prompt. llms-full.txt has the whole catalog in one Markdown file.

How do I page through results?

Use limit and offset, or follow the next URL in the response body. The same URL is sent in a Link header with rel=next. CSV skips pagination and returns the whole filtered set.

Is there an OpenAPI spec for tool definitions?

Yes, at https://r88z.com/openapi.json. Agents can also discover it from /.well-known/api-catalog or the service-desc link on every HTML page.

Built to be read
by agents

Every filter on the browse page is a GET parameter, and the same query string works on the API. No key, open CORS. 418 directories are marked ready for an unattended agent.

Read AGENTS.md openapi.json llms.txt

Start here

curl 'https://r88z.com/api/directories?agent_friendly=1&status=live&limit=50'

Returns total, next and directories. Add format=csv or format=md for other formats.

Endpoints

/api/directories: Filtered, paginated list (JSON). ?format=csv or ?format=md for other formats.
/api/directories/{id}: One directory (JSON). ?format=md for Markdown.
/api/categories: Categories with counts, plus catalog stats.
/openapi.json: OpenAPI 3.1 description of the API.
/llms.txt: Short catalog summary for LLMs, with links to everything else.
/llms-full.txt: Every directory as Markdown in one file.
/AGENTS.md: Step by step instructions for submission agents.
/sitemap.xml: Every page URL.

Recipes

Query parameters

qstring: Case insensitive match on name, domain or category.
categorystring (csv): Exact category name(s), e.g. AI Tools,Launchpad.
pricingcsv of free|freemium|paid|unknown: Listing price model.
link_typecsv of dofollow|nofollow|conditional|unknown: Backlink rel reported for the listing.
dr_mininteger 0-100: Minimum reported Ahrefs Domain Rating. Excludes entries with no DR.
dr_maxinteger 0-100: Maximum reported Ahrefs Domain Rating.
agent_friendly1: Only directories an unattended agent can submit to: free path, no badge or backlink, not OAuth only, no phone, work email or credit card, no hard captcha, not failed.
statuscsv of live|submitted|pending|failed: AZN8 verification state. live = listing confirmed on a public page.
no_account1: Submission needs no account (auth=none).
no_captcha1: Captcha is none or Turnstile. Unknown captcha is excluded.
no_badge1: No badge, backlink or reciprocal link required.
instant1: Listing goes live on save (review=instant).
api1: The directory offers an API or JSON submit endpoint.
sortdr|-dr|name|-name: Default -dr (highest DR first).
limitinteger 1-2000: Page size for API responses. Default 100.
offsetinteger: Number of results to skip.

Agent FAQ

Do I need an API key?: No. Every endpoint is public and read only, with open CORS so browser based agents can call it directly.
Which format should an LLM agent use?: JSON for tool calls, Markdown (format=md) when the result goes straight into a prompt. llms-full.txt has the whole catalog in one Markdown file.
How do I page through results?: Use limit and offset, or follow the next URL in the response body. The same URL is sent in a Link header with rel=next. CSV skips pagination and returns the whole filtered set.
Is there an OpenAPI spec for tool definitions?: Yes, at https://r88z.com/openapi.json. Agents can also discover it from /.well-known/api-catalog or the service-desc link on every HTML page.

Prefer to browse first? See the agent ready list.