{"openapi":"3.1.0","info":{"title":"LLMrefs AI SEO API","description":"API documentation reference for the AI SEO Search Analytics platform LLMrefs. By default, all users are limited to 10 requests per minute to authenticated endpoints.\n\nLLMrefs Javascript SDK: https://github.com/LLMrefs/llmrefs-js","version":"1.0.0"},"servers":[{"url":"https://llmrefs.com/api"}],"tags":[{"name":"Organizations"},{"name":"Projects"},{"name":"Keywords"}],"paths":{"/v1/organizations":{"get":{"operationId":"organizations-list","summary":"List organizations","description":"Returns the full set of all LLMrefs organizations you have access to.","tags":["Organizations"],"security":[{"Authorization":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}}}}}}},"/v1/projects":{"get":{"operationId":"projects-list","summary":"List projects","description":"Returns the full set of all projects this LLMrefs organization has access to.","tags":["Projects"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"organizationId","schema":{"description":"Organization ID","type":"string","minLength":1},"required":true,"description":"Organization ID"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":["id","name","domain"],"additionalProperties":false}}}}}}}},"/v1/keywords":{"get":{"operationId":"keywords-list","summary":"List keywords","description":"Returns the full set of active keywords this LLMrefs project has access to.","tags":["Keywords"],"security":[{"Authorization":[]}],"parameters":[{"in":"query","name":"organizationId","schema":{"description":"Organization ID","type":"string","minLength":1},"required":true,"description":"Organization ID"},{"in":"query","name":"projectId","schema":{"description":"Project ID","type":"string","minLength":1},"required":true,"description":"Project ID"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"},"location":{"type":"string"},"searchVolume":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","value","location","searchVolume"],"additionalProperties":false}}}}}}}},"/v1/keywords/search-engines":{"get":{"operationId":"keywords-searchEngines","summary":"List search engines","description":"Returns the full set of generative AI search engines (LLMs) that are tracked by LLMrefs.","tags":["Keywords"],"security":[{"Authorization":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"name":{"type":"string"}},"required":["value","name"],"additionalProperties":false}}}}}}}},"/v1/keywords/locations":{"get":{"operationId":"keywords-locations","summary":"List locations","description":"Returns the full set of available locations that are tracked by LLMrefs.","tags":["Keywords"],"security":[{"Authorization":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"name":{"type":"string"}},"required":["value","name"],"additionalProperties":false}}}}}}}},"/v1/keywords/{keywordId}":{"get":{"operationId":"keywords-data","summary":"Get keyword data","description":"Returns the detailed breakdown of the keyword's AI SEO analytics data for the current period.","tags":["Keywords"],"security":[{"Authorization":[]}],"parameters":[{"in":"path","name":"keywordId","schema":{"description":"Keyword ID","type":"string","minLength":1},"required":true,"description":"Keyword ID"},{"in":"query","name":"organizationId","schema":{"description":"Organization ID","type":"string","minLength":1},"required":true,"description":"Organization ID"},{"in":"query","name":"projectId","schema":{"description":"Project ID","type":"string","minLength":1},"required":true,"description":"Project ID"},{"in":"query","name":"searchEngines","schema":{"description":"Filter by AI search engines (comma separated list)","type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"},"location":{"type":"string"},"searchVolume":{"anyOf":[{"type":"number"},{"type":"null"}]},"rankings":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number"},"brandId":{"type":"string"},"shareOfVoice":{"type":"string"},"averagePosition":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}}},"required":["rank","brandId","shareOfVoice","averagePosition","sources"],"additionalProperties":false}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"mentionRate":{"type":"string"},"averagePosition":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandIds":{"type":"array","items":{"type":"string"}}},"required":["source","mentionRate","averagePosition","brandIds"],"additionalProperties":false}},"responses":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string"},"searchEngine":{"type":"string"},"text":{"type":"string"},"brandsIds":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}}},"required":["prompt","searchEngine","text","brandsIds","sources"],"additionalProperties":false}},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","domain"],"additionalProperties":false}}},"required":["id","value","location","searchVolume","rankings","sources","responses","brands"],"additionalProperties":false}}}}}}}},"components":{"securitySchemes":{"Authorization":{"type":"http","scheme":"bearer"}}}}