{"slug":"developers","title":"Developer and agent access","description":"Read Search for Agents through its public content API, Markdown pages, OpenAPI specification, and agent-readable site index.","updatedAt":"2026-09-25","body":"Search for Agents publishes an open encyclopedia of search systems. Agents can read the public site and its content API without an account or API key. Editorial changes, private intelligence tools, and webhook subscriptions are separate, permissioned workflows.\n\n## When to use this site\n\nUse the [encyclopedia](/encyclopedia) to explain the steps between finding a source and producing a cited answer. Use [Lay of the Land](/market-map) to discover search APIs, source collections, retrieval systems, and models by their documented capabilities. Use [articles](/blog) for worked examples of checking whether a result supports a claim. The provider directory records cited capabilities; it does not benchmark or rank providers. Follow the evidence links to verify a provider's current offering.\n\n## Read public content\n\n1. Fetch [llms.txt](/llms.txt) to discover the site index, or [sitemap.xml](/sitemap.xml) for canonical pages.\n2. Search public articles with `GET /api/v1/search?q=web%20search&limit=5`. Results include stable content IDs and canonical URLs.\n3. Retrieve a complete article with `GET /api/v1/content/{id}`. Open the cited sources before treating a result as evidence.\n4. Request a page's advertised `.md` URL, such as [the homepage Markdown](/index.md), for a plain-text version. The same pages remain available as HTML for readers.\n\nFor example, an anonymous request to the public search endpoint:\n\n```bash\ncurl -sS 'https://www.searchforagents.com/api/v1/search?q=web%20search&limit=5'\n```\n\nThe public [OpenAPI specification](/openapi.json) lists methods, parameters, response shapes, and access requirements. The [full agent index](/llms-full.txt) and [versioned change feed](/api/v1/changes) provide additional read-only access. Use the API's JSON error code and HTTP status when handling a failed request; a `429` response means the client should back off.\n\n## Scope and updates\n\nPublic content is available without a credential. Protected editorial and subscription endpoints require scoped access and are not part of the anonymous read API. Version 1 endpoints use the `/api/v1/` prefix; breaking changes will use a new version, and retiring endpoints will be announced here before removal. The [methodology](/methodology) explains how directory entries and evidence are maintained.","url":"https://www.searchforagents.com/developers","representations":{"html":"https://www.searchforagents.com/developers","markdown":"https://www.searchforagents.com/developers.md","json":"https://www.searchforagents.com/developers.json"}}