{"name":"Agent Web Map API","version":"0.25.1","description":"The directory of websites publishing llms.txt: search by meaning and words, look any site up, read our validated copy of its file. Reads need no key.","start_here":"https://agentwebmap.com/v1/resolve?q=<domain or task>  (compact sources, matching evidence, terms, freshness and alternatives)","docs":"https://agentwebmap.com/docs","llms_project":"https://agentwebmap.com/llms-txt-project.md","human_workspace":"https://agentwebmap.com/workspace","curated_collections":"https://agentwebmap.com/collections","cli":"https://github.com/AgentWebMap/mcp/blob/main/docs/discovery-cli.md","openapi":"https://agentwebmap.com/openapi.json","mcp":{"endpoint":"https://agentwebmap.com/mcp","transport":"streamable-http","auth":"none for reads; owner tools take api_key as an argument"},"llms_txt":"https://agentwebmap.com/llms.txt","llms_full_txt":"https://agentwebmap.com/llms-full.txt","skill":"https://github.com/AgentWebMap/mcp/tree/main/skills/agentwebmap-docs","consumer_options":{"detail":"compact (default) or full (owner claim and full profile)","max_age":"resolve: acceptable check age in seconds, default 86400, range 0–2592000; inspect health.stale","refresh":"resolve: true for bounded, read-only live source validation","limit":"resolve: 1–5 documentation targets, default 3","per_page":"search/list: default 10, maximum 100"},"content_negotiation":"Every /domain/<domain> page answers with JSON for Accept: application/json and Markdown for Accept: text/markdown.","action_filters":{"parameter":"action","values":["read_docs","search_content","call_api","buy","book","download_data","contact_support"],"meaning":"Actions are inferred from publisher content. They can overlap and do not prove a working integration, authorization or task success. Unclassified sites may be missing useful actions."},"endpoints":{"similar_sites":"GET https://agentwebmap.com/v1/similar/{domain}?country=&action=&limit= (related publishers by meaning; inspect similarity and shared_sections)","sections":"GET https://agentwebmap.com/v1/sections?q=&sort=common|alphabetical|newest|emerging&page=&per_page= (publisher headings, unique-site counts and coverage)","section_graph":"GET https://agentwebmap.com/v1/section-graph?sections=&section_match=all|any&include_sites=false (connections; omit include_sites=false to page through matching publishers)","section_explorer":"GET https://agentwebmap.com/explore (interactive content map; labels emerge from the indexed corpus)","categories":"GET https://agentwebmap.com/v1/categories (taxonomy, counts, publisher-declared capabilities, and counts by agentic label)","countries":"GET https://agentwebmap.com/v1/countries (available country codes, listed-site counts and unknown count; country=FR or country=unknown filters list, search, resolve and publisher sections)","adoption_statistics":"GET https://agentwebmap.com/stats.json (how many sites publish llms.txt, by category, country, language, agentic label; growth over 30 days; file facts)","agentic":"Every listing carries agentic = interface (API or MCP endpoint an agent can call) | transactional (buy or book) | documentation (docs to read) | informational (for people). Filter search, list and resolve with agentic=<value>.","semantic_search":"resolve and search rank by meaning as well as words (query embeddings; sites and documentation links are embedded once per file version)","llms_txt_content":"GET https://agentwebmap.com/v1/domain/{domain}/llms.txt (our validated copy of the file as text/plain, with X-Source-URL, X-Checked-At and X-Content-Hash headers; no second fetch needed)","resolve":"GET https://agentwebmap.com/v1/resolve?q=&country=&detail=&max_age=&refresh=&limit=","stats":"GET https://agentwebmap.com/v1/stats","domains":"GET https://agentwebmap.com/v1/domains?country=&page=&per_page=&verified=&include_unlisted=","search":"GET https://agentwebmap.com/v1/search?q=&country=","domain":"GET https://agentwebmap.com/v1/domain/{domain}","check":"GET https://agentwebmap.com/v1/check/{domain}","validate_draft":"POST https://agentwebmap.com/v1/validate {\"text\":\"# My website\"}","website_audit":"GET https://agentwebmap.com/v1/audit/{domain}","mcp_check":"POST https://agentwebmap.com/v1/mcp-check {\"endpoint\":\"https://example.com/mcp\"}","generate":"GET https://agentwebmap.com/v1/generate/{domain}","map":"GET https://agentwebmap.com/v1/map","register":"POST https://agentwebmap.com/v1/sites {\"domain\"}","verification":"GET https://agentwebmap.com/v1/sites/{domain}/verification","verify":"POST https://agentwebmap.com/v1/sites/{domain}/verify","claims":"POST https://agentwebmap.com/v1/sites/{domain}/claims (fresh public proof and private requester credentials)","rotate_key":"POST https://agentwebmap.com/v1/sites/{domain}/key (Bearer current owner key)","update":"PATCH https://agentwebmap.com/v1/sites/{domain} (Bearer api_key) {description, tags, nested_llms_txt, contact, agent_terms}","site_stats":"GET https://agentwebmap.com/v1/sites/{domain}/stats (Bearer api_key)","recrawl":"POST https://agentwebmap.com/v1/sites/{domain}/recrawl (Bearer api_key)","badge":"GET https://agentwebmap.com/badge/{domain}.svg"},"agent_terms_fields":{"automated_access":"one of welcome | limited | ask | not_allowed: may agents use the site automatically?","rate_limit":"short text, e.g. \"60 requests/minute\"","attribution":"one of required | appreciated | none","attribution_text":"how to credit the site (≤200 chars)","pricing":"one of free | freemium | paid","pricing_url":"where prices are published","terms_url":"the full terms for automated use","notes":"anything else an agent should know (≤500 chars)"},"discovery_access":{"mode":"monitor","automatic_usage_blocks":false,"public_reads":"No automatic daily, record, distinct-domain, byte or pagination quotas","review_thresholds":{"requests_minute":60,"requests_day":10000,"records_day":3000,"domains_day":1000,"bytes_day":20971520,"result_window":250},"max_mcp_batch":10,"auth":"Optional Authorization: Bearer awm_client_… or X-AgentWebMap-Key; operator-issued, separate from owner keys","unlisted":"Explicit client permission required","bulk":"Disabled by default; separate operator permission required","docs":"https://agentwebmap.com/docs#limits"},"rate_limits":"Public discovery has no automatic daily usage or result-window quotas. Usage is monitored and explicit operator blocks remain possible. Pages hold at most 100 records; MCP batches at most 10 messages. Live checks and writes have separate limits: register 10/hour, claims and verify 30/hour per client and 10/hour per domain, check 20 and generate 5 per 10 minutes. Protected responses are private, no-store.","errors":"JSON with an \"error\" code and usually a \"hint\"."}