{"openapi":"3.1.0","info":{"title":"AI Directories API","version":"1.0.0","description":"Official catalog of AI tools and startup directories. Catalog reads use Authorization: Bearer aid_… from the developer dashboard. Partner submit endpoints use an issued key.","contact":{"email":"support@thedirectori.es"}},"servers":[{"url":"https://www.aidirectori.es/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"aid_","description":"User API key from /dashboard/developers, or an issued partner key."}}},"security":[{"bearerAuth":[]}],"paths":{"/tools":{"get":{"operationId":"search_tools","summary":"Search published AI tools","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"pricing","in":"query","schema":{"type":"string","enum":["FREE","FREEMIUM","PAID"]}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}]}},"/tools/top":{"get":{"operationId":"get_top_tools","summary":"Top tools by popularity","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":10,"maximum":100}},{"name":"category","in":"query","schema":{"type":"string"}}]}},"/tools/{slug}":{"get":{"operationId":"get_tool","summary":"One published AI tool","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}]}},"/categories":{"get":{"operationId":"list_categories","summary":"AI tool categories"}},"/tags":{"get":{"operationId":"list_tags","summary":"AI tool tags"}},"/directories":{"get":{"operationId":"search_directories","summary":"Search submission directories","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"cost","in":"query","schema":{"type":"string","enum":["Free","Paid","Freemium"]}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}}]}},"/directories/{slug}":{"get":{"operationId":"get_directory","summary":"One directory profile","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}]}},"/directory-categories":{"get":{"operationId":"list_directory_categories","summary":"Directory categories"}}}}