{"openapi":"3.1.0","info":{"title":"SQSEO API","version":"1.0.0","description":"Longtail keyword research, snapshots, Search Console performance and volume enrichment."},"servers":[{"url":"https://sqseo.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"An API key: Authorization: Bearer sqseo_live_…"}}},"paths":{"/v1/research":{"post":{"summary":"Run keyword research on a seed","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["seed"],"properties":{"seed":{"type":"string"},"limit":{"type":"integer","default":400,"maximum":1000}}}}}},"responses":{"200":{"description":"A scored longtail snapshot","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing or invalid key"}}}},"/v1/brief":{"post":{"summary":"Generate a content brief for a keyword","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["keyword"],"properties":{"keyword":{"type":"string"},"cluster":{"type":"array","items":{"type":"string"},"description":"Optional explicit sibling keywords; otherwise discovered by expansion.","maxItems":40}}}}}},"responses":{"200":{"description":"A content brief (titles, outline, FAQs, GEO note) + Markdown"},"401":{"description":"Missing or invalid key"}}}},"/v1/snapshots/{id}":{"get":{"summary":"Read a research snapshot","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Snapshot keywords + clusters"},"404":{"description":"Not found"}}}},"/v1/snapshots/{id}/export.csv":{"get":{"summary":"Download a snapshot as CSV","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"text/csv"}}}},"/v1/site-profile":{"get":{"summary":"Site Intelligence profile of the primary project's site","responses":{"200":{"description":"Structured profile: identity, offerings, keywords, tech, locales, contact"},"404":{"description":"No project or no completed scan yet"}}}},"/v1/gsc/performance":{"get":{"summary":"Search Console queries with Performance Labels","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"Queries + labels"}}}},"/v1/volumes":{"post":{"summary":"Enrich phrases with volume + opportunity","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["phrases"],"properties":{"phrases":{"type":"array","items":{"type":"string"},"maxItems":200}}}}}},"responses":{"200":{"description":"Per-phrase metrics"}}}},"/v1/usage":{"get":{"summary":"Today's request count + quota","responses":{"200":{"description":"Usage"}}}}}}