{"openapi":"3.1.0","info":{"title":"1ai.tools API","version":"1.0.0","description":"Search AI tools and submit your own AI tool to 1ai.tools. Owner actions need a personal API key from https://www.1ai.tools/dashboard#api-keys."},"servers":[{"url":"https://www.1ai.tools/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Personal API key that starts with 1ai_"}}},"paths":{"/tools":{"get":{"operationId":"searchTools","summary":"Search listed AI tools","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string","enum":["chat","writing","image","video","audio","code","productivity","marketing","sales","design","research","education","agents","developer","data","other"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"page_url":{"type":"string"},"markdown_url":{"type":"string"},"alternatives_url":{"type":"string"},"website":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["chat","writing","image","video","audio","code","productivity","marketing","sales","design","research","education","agents","developer","data","other"]},"pricing":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"audience":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"/tools/{slug}":{"get":{"operationId":"getTool","summary":"Get one listed AI tool","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"page_url":{"type":"string"},"markdown_url":{"type":"string"},"alternatives_url":{"type":"string"},"website":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"category":{"type":"string","enum":["chat","writing","image","video","audio","code","productivity","marketing","sales","design","research","education","agents","developer","data","other"]},"pricing":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"audience":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"pros":{"type":"array","items":{"type":"string"}},"cons":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/submissions":{"get":{"operationId":"listSubmissions","summary":"List my submissions","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"website":{"type":"string"},"status":{"type":"string","enum":["pending","approved","rejected","paused"]},"listing_type":{"type":"string","enum":["backlink","paid"]},"paid_until":{"type":["string","null"]},"backlink":{"type":"object"},"page_url":{"type":["string","null"]},"checks":{"type":"array","items":{"type":"object"}},"next_steps":{"type":"array","items":{"type":"string"}},"payment_url":{"type":"string"}}}}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"post":{"operationId":"submitTool","summary":"Submit my AI tool","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","accept_guidelines"],"properties":{"url":{"type":"string"},"accept_guidelines":{"type":"boolean","const":true},"listing_type":{"type":"string","enum":["backlink","paid"],"default":"backlink"},"backlink_url":{"type":"string"},"notes":{"type":"string"},"fields":{"type":"object","properties":{"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"}}}}}}}},"responses":{"200":{"description":"Created as pending","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"website":{"type":"string"},"status":{"type":"string","enum":["pending","approved","rejected","paused"]},"listing_type":{"type":"string","enum":["backlink","paid"]},"paid_until":{"type":["string","null"]},"backlink":{"type":"object"},"page_url":{"type":["string","null"]},"checks":{"type":"array","items":{"type":"object"}},"next_steps":{"type":"array","items":{"type":"string"}},"payment_url":{"type":"string"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/submissions/{id}":{"get":{"operationId":"getSubmission","summary":"Get one of my submissions","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"website":{"type":"string"},"status":{"type":"string","enum":["pending","approved","rejected","paused"]},"listing_type":{"type":"string","enum":["backlink","paid"]},"paid_until":{"type":["string","null"]},"backlink":{"type":"object"},"page_url":{"type":["string","null"]},"checks":{"type":"array","items":{"type":"object"}},"next_steps":{"type":"array","items":{"type":"string"}},"payment_url":{"type":"string"}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/submissions/{id}/backlink":{"post":{"operationId":"verifyBacklink","summary":"Check the page that links to us","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/submissions/{id}/checkout":{"post":{"operationId":"getPaymentLink","summary":"Stripe link for the $6 one-year listing","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"payment_url":{"type":"string"},"price_usd":{"type":"number"}}}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}