{"openapi":"3.1.0","info":{"title":"AgentLayer — read-only catalog","version":"1.0.0","description":"Grounded catalog data and deterministic search. Prices use integer minor units. Unknown facts stay unknown; from-prices are conditional. No checkout or booking."},"servers":[{"url":"https://agentlayer.n1k.pro/s/site_00855528ee33b367"}],"paths":{"/agent/":{"get":{"operationId":"getAgentHomeHtml","summary":"Discover available read-only interfaces and follow HTML search links","responses":{"200":{"description":"HTML landing page with search form, coverage and catalog links","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/agent/search.html":{"get":{"operationId":"searchCatalogHtml","summary":"Search and read source-linked results as HTML","description":"Read-only GET search. Query strings can appear in client/proxy history; use POST /agent/query for personal input.","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":2000}}],"responses":{"200":{"description":"HTML results with status, unresolved constraints, evidence and item links","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Invalid request"},"429":{"description":"Rate limited"}}}},"/agent/pages/{page_id}.html":{"get":{"operationId":"getItemHtml","summary":"Read an HTML item page with evidence and freshness","parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"HTML item with source links","content":{"text/html":{"schema":{"type":"string"}}}},"404":{"description":"Unknown or inactive item"}}}},"/agent/index.json":{"get":{"operationId":"getSiteInfo","summary":"Read manifest and coverage","responses":{"200":{"description":"Published manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentManifest"}}}}}}},"/agent/items":{"get":{"operationId":"listItems","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Single revision page with next_cursor"},"409":{"description":"Cursor revision expired; restart pagination"}}}},"/agent/items/{item_id}.json":{"get":{"operationId":"getItem","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Item with field-level evidence"},"404":{"description":"Unknown item"}}}},"/agent/pages/{page_id}.md":{"get":{"operationId":"getItemMarkdown","summary":"Read a compact source-linked item page; catalog items provide the exact links.markdown URL","parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Item facts, freshness and source","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Unknown or inactive item"}}}},"/agent/query":{"post":{"operationId":"searchCatalog","summary":"Search using hard constraints and applicable confirmed promotions","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":2000},"constraints":{"type":"object","properties":{"category":{"type":"string","minLength":1,"maxLength":120},"required_attributes":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"},{"maxItems":30,"type":"array","items":{"type":"string","maxLength":300}}]}},"preferred_attributes":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"},{"maxItems":30,"type":"array","items":{"type":"string","maxLength":300}}]}},"max_price_minor":{"type":"integer","minimum":0,"maximum":1000000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"budget_scope":{"type":"string","enum":["item","total"]},"availability_required":{"type":"boolean"},"delivery":{"type":"object","properties":{"region":{"type":"string","maxLength":150},"by_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"max_days":{"type":"integer","minimum":0,"maximum":365}},"additionalProperties":false},"include_alternatives":{"type":"boolean"},"alternative_budget_slack_minor":{"type":"integer","minimum":0,"maximum":1000000000000},"limit":{"type":"integer","minimum":1,"maximum":20}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"status, exact_matches, partial_matches with unconfirmed-fact violations, alternatives, unresolved_constraints, reason_codes, catalog_revision and evidence"},"422":{"description":"Invalid or contradictory request"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Unavailable or disabled site"}}}},"/agent/search":{"get":{"operationId":"searchCatalogGet","description":"Use POST /agent/query for personal input; GET query strings can appear in client/proxy history.","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":2000}},{"name":"constraints","in":"query","description":"JSON-encoded typed constraints","schema":{"type":"string"}}],"responses":{"200":{"description":"Same search semantics as POST"}}}},"/agent/site.md":{"get":{"operationId":"getSiteMarkdown","responses":{"200":{"description":"Source-linked summary and policies","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"AgentManifest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schema_version":{"type":"string","const":"1.0"},"site_id":{"type":"string","pattern":"^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$"},"title":{"type":"string","minLength":1},"merchant_origin":{"type":"string","format":"uri"},"read_only":{"type":"boolean","const":true},"catalog_revision":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"languages":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"capabilities":{"type":"array","items":{"type":"string","enum":["site_info","catalog","catalog_search","catalog_pages","published_promotions","policies","mcp_read_only"]}},"endpoints":{"type":"object","properties":{"summary":{"type":"string","format":"uri"},"catalog":{"type":"string","format":"uri"},"query":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"home_html":{"type":"string","format":"uri"},"search_html":{"type":"string","format":"uri"},"item_template":{"type":"string","description":"Absolute URI template; replace {item_id} with the URL-encoded item id."},"page_template":{"type":"string","description":"Absolute URI template; replace {page_id} with the URL-encoded item id. The exact URL is also in each catalog item links.markdown."},"html_page_template":{"description":"HTML alternative to the Markdown item page. The exact URL is also in each catalog item links.html.","type":"string"}},"required":["summary","catalog","query","openapi","mcp","item_template","page_template"],"additionalProperties":false},"coverage":{"type":"object","properties":{"status":{"type":"string","enum":["complete","partial","unknown"]},"discovered":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"processed":{"type":"integer","minimum":0,"maximum":9007199254740991},"reasons":{"type":"array","items":{"type":"string"}}},"required":["status","discovered","processed","reasons"],"additionalProperties":false},"limitations":{"type":"array","items":{"type":"string"}}},"required":["schema_version","site_id","title","merchant_origin","read_only","catalog_revision","generated_at","languages","currency","capabilities","endpoints","coverage","limitations"],"additionalProperties":false}}},"x-read-only":true,"x-mcp-endpoint":"https://agentlayer.n1k.pro/s/site_00855528ee33b367/mcp"}