{"openapi":"3.1.0","info":{"title":"AdvGuides Agent API","description":"Public outdoor adventure trip discovery, verified places, and confirmed booking handoffs for AI agents and LLM tools.","version":"1.0.0","contact":{"name":"AdvGuides Engineering","url":"https://advguides.com/agents"}},"servers":[{"url":"https://advguides.com","description":"Production Server"}],"paths":{"/agents/manifest.json":{"get":{"summary":"Get API Manifest & Capabilities","operationId":"getAgentManifest","description":"Returns the machine-readable capabilities, collections, and safety constraints for the AdvGuides Agent API.","responses":{"200":{"description":"Manifest successfully retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string"},"name":{"type":"string"},"api_version":{"type":"string"},"documentation_url":{"type":"string"},"catalog_index_url":{"type":"string"},"content_types":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"collection":{"type":"string"},"name":{"type":"string"},"catalog_url":{"type":"string"}}}}}}}}}}}},"/agents/catalog/{collection}.json":{"get":{"summary":"Query Token-Efficient Catalog","operationId":"getCatalogCollection","description":"Returns a compact, token-efficient listing of adventure towns, protected places, landmarks, or bookable experiences.","parameters":[{"name":"collection","in":"path","required":true,"description":"Collection name: 'index', 'towns', 'protected-places', 'adventure-spots', or 'bookable-experiences'","schema":{"type":"string","enum":["index","towns","protected-places","adventure-spots","bookable-experiences"]}},{"name":"state","in":"query","required":false,"description":"Two-letter US state code or full state name (e.g. 'CO', 'Utah')","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude coordinate for geographic proximity search","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude coordinate for geographic proximity search","schema":{"type":"number"}},{"name":"radius","in":"query","required":false,"description":"Proximity search radius in miles (default: 100)","schema":{"type":"number","default":100}},{"name":"limit","in":"query","required":false,"description":"Maximum number of items to return (default: 20, max: 100)","schema":{"type":"integer","default":20}},{"name":"page","in":"query","required":false,"description":"Page number for pagination","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Compact catalog items array","content":{"application/json":{"schema":{"type":"object","properties":{"api_version":{"type":"string"},"collection":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"page":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"content_type":{"type":"string"},"location":{"type":"object","properties":{"region":{"type":"string"},"latitude":{"type":"number","nullable":true},"longitude":{"type":"number","nullable":true}}},"summary":{"type":"string"},"item_url":{"type":"string"},"record_url":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"/agents/items/{itemId}.json":{"get":{"summary":"Get Full Detailed Item Record","operationId":"getItemDetailById","description":"Fetches comprehensive, source-grounded details for a specific town, protected place, destination, or bookable experience.","parameters":[{"name":"itemId","in":"path","required":true,"description":"Slug or identifier of the item","schema":{"type":"string"}}],"responses":{"200":{"description":"Detailed item record","content":{"application/json":{"schema":{"type":"object","properties":{"$schema":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"},"content_type":{"type":"string"},"location":{"type":"object"},"summary":{"type":"string"},"description":{"type":"string"},"source":{"type":"object","properties":{"publisher":{"type":"string"},"canonical_url":{"type":"string"},"verified_at":{"type":"string"}}},"booking":{"type":"object","nullable":true,"properties":{"is_bookable":{"type":"boolean"},"operator_name":{"type":"string"},"booking_url":{"type":"string"},"price_starting_at":{"type":"number","nullable":true},"currency":{"type":"string"},"requires_user_confirmation":{"type":"boolean"},"commission_disclosure":{"type":"string"}}},"agent_rules":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Item not found"}}}}}}