{"openapi":"3.1.0","info":{"title":"Gateway AI & Bot Directory","version":"1.0.0","description":"Free anonymous read-only discovery for site owners and agents. Public source descriptions are reviewed manually; uptime, traffic, delivery and compatibility are not monitored. No listing authorizes execution or spending."},"servers":[{"url":"https://gatewayinformationgroup.com"}],"paths":{"/api/directory/v1/sites":{"get":{"operationId":"discoverDirectorySites","security":[],"parameters":[{"name":"q","schema":{"type":"string","maxLength":200},"description":"All search words must match listing metadata.","in":"query","required":false},{"name":"category","schema":{"type":"string","enum":["All","AI visibility","Crawl & indexing","AI-readable sites","Agent connections","API & server registries","Other resources"]},"in":"query","required":false},{"name":"id","schema":{"type":"string","pattern":"^[a-z0-9-]{1,100}$"},"in":"query","required":false},{"name":"free","schema":{"type":"string","enum":["0","1"],"default":"0"},"description":"Only resources with a documented free option. Provider limits may apply.","in":"query","required":false},{"name":"optional","schema":{"type":"string","enum":["0","1"],"default":"0"},"description":"Include secondary general resources. Defaults to AI/bot resources only.","in":"query","required":false},{"name":"interface","schema":{"type":"string","enum":["Website","HTTP","REST","OpenAPI","MCP","x402","Markdown"]},"description":"Documented interface; source review is not a compatibility test.","in":"query","required":false},{"name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","required":false},{"name":"offset","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0},"in":"query","required":false}],"responses":{"200":{"description":"Filtered entries ordered A–Z, with bounded pagination. Unknown valid IDs return an empty result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Directory"}}}},"400":{"description":"Unknown, repeated or invalid query parameter."}}}}},"components":{"schemas":{"Directory":{"type":"object","required":["schema_version","total","count","offset","limit","next","entries"],"properties":{"schema_version":{"type":"string"},"total":{"type":"integer"},"count":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"next":{"type":["string","null"],"format":"uri"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/Site"}}}},"Site":{"type":"object","required":["id","name","category","description","publisher","website","listing_url","interfaces","pricing","access","evidence","monitoring","optional"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"description":{"type":"string"},"publisher":{"type":"string"},"website":{"type":"string","format":"uri"},"listing_url":{"type":"string","format":"uri"},"interfaces":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"discovery_url":{"type":["string","null"],"format":"uri"},"documentation_url":{"type":["string","null"],"format":"uri"},"submission_url":{"type":["string","null"],"format":"uri"},"listing_requirements":{"type":["string","null"]},"owner_next_step":{"type":"string"},"access":{"type":"string"},"optional":{"type":"boolean"},"pricing":{"type":"object","required":["kind","note"],"properties":{"kind":{"type":"string","enum":["Free","Free plan","Check terms"]},"note":{"type":"string"}}},"evidence":{"type":"object","required":["source_url","reviewed_on","scope"],"properties":{"source_url":{"type":"string","format":"uri"},"reviewed_on":{"type":["string","null"],"format":"date"},"scope":{"type":"string"}}},"monitoring":{"type":"object","required":["status","uptime","bot_traffic"],"properties":{"status":{"type":"string","const":"not-monitored"},"uptime":{"type":"null"},"bot_traffic":{"type":"null"}}}}}}}}