{"info":{"title":"AEOmeter API","version":"0.1.0","description":"Projects, browser run instructions, and immutable AI observations.\n\nSign-in, OAuth and session endpoints are documented separately in the [authentication reference](/api/auth/reference)."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"session":{"type":"apiKey","in":"cookie","name":"better-auth.session_token"},"bearer":{"type":"http","scheme":"bearer","description":"Revocable extension credential. Connection management requires a website session."}}},"security":[{"session":[]},{"bearer":[]}],"openapi":"3.1.1","paths":{"/collector/browsers":{"put":{"operationId":"collection.register","summary":"Advertise browser collection capabilities","tags":["Collection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":100},"enabled":{"type":"boolean"},"engines":{"type":"array","maxItems":5,"items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"permissions":{"type":"array","maxItems":5,"items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}}},"required":["browserId","name","enabled","engines","permissions"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}}}},"/collector/claim":{"post":{"operationId":"collection.claim","summary":"Atomically claim an eligible collection job","description":"With batch, leases every job of one run prompt on the eligible engines; job is the first of jobs. A browser holding jobs gets the same batch back.","tags":["Collection"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"batch":{"type":"boolean"}},"required":["browserId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"job":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"projectId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"provider":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string","description":"Deprecated: same as engine, for extensions up to 0.7.2."},"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"leaseToken":{"type":"string","format":"uuid"},"leaseUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","runId","projectId","promptId","prompt","engine","provider","status","leaseToken","leaseUntil","startedAt"]},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"projectId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"provider":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string","description":"Deprecated: same as engine, for extensions up to 0.7.2."},"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"leaseToken":{"type":"string","format":"uuid"},"leaseUntil":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","runId","projectId","promptId","prompt","engine","provider","status","leaseToken","leaseUntil","startedAt"]}},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}}},"required":["job","brands"]},{"type":"null"}]}}}}}}},"/collector/jobs/{jobId}/progress":{"put":{"operationId":"collection.progress","summary":"Start or update a leased job","tags":["Collection"],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"leaseToken":{"type":"string","format":"uuid"},"status":{"enum":["opening","privacy","preparing","submitting","waiting","attention","failed","no-overview","cancelled"],"type":"string"},"error":{"type":"string","maxLength":4000}},"required":["browserId","leaseToken","status"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"leaseUntil":{"type":"string"}},"required":["leaseUntil"]}}}}}}},"/collector/jobs/{jobId}/heartbeat":{"post":{"operationId":"collection.heartbeat","summary":"Renew a collector lease","tags":["Collection"],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"leaseToken":{"type":"string","format":"uuid"}},"required":["browserId","leaseToken"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"leaseUntil":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","leaseUntil"]}}}}}}},"/collector/jobs/{jobId}/resume":{"post":{"operationId":"collection.resume","summary":"Resume an interrupted job in its original browser","tags":["Collection"],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"leaseToken":{"type":"string","format":"uuid"}},"required":["browserId","leaseToken"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}}}},"/collector/jobs/{jobId}/response":{"post":{"operationId":"collection.upload","summary":"Persist a raw response and versioned backend analysis","tags":["Collection"],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"browserId":{"type":"string","format":"uuid"},"leaseToken":{"type":"string","format":"uuid"},"capture":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":20000},"answer":{"type":"string","minLength":1,"maxLength":200000},"citations":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"mentionedUrls":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"pageUrl":{"type":"string","format":"uri"},"capturedAt":{"type":"string","format":"date-time"},"method":{"enum":["automation","adapter","selection"],"type":"string"},"adapterVersion":{"type":"string","maxLength":100},"model":{"type":"string","maxLength":300},"locale":{"type":"string","maxLength":100},"context":{"enum":["fresh","existing","unknown"],"type":"string"},"privacy":{"type":"object","properties":{"mode":{"enum":["temporary-unpersonalized","temporary","incognito","search-nonpersonalized"],"type":"string"},"verified":{"const":true},"verifiedAt":{"type":"string","format":"date-time"},"memory":{"enum":["disabled","not-applicable"],"type":"string"},"evidence":{"type":"string","maxLength":8000},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}}},"required":["mode","verified","verifiedAt","memory","evidence","warnings"]},"brandMentions":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}}},"required":["brandId","name","aliases"]}},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}},"sourcesExpanded":{"type":"boolean"}},"required":["id","engine","prompt","answer","citations","pageUrl","capturedAt","method","adapterVersion","model","locale","context"]}},"required":["browserId","leaseToken","capture"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"duplicate":{"type":"boolean"}},"required":["id","duplicate"]}}}}}}},"/projects/{projectId}/jobs/{jobId}/cancel":{"post":{"operationId":"jobs.cancel","summary":"Cancel a queued or interrupted collection job","tags":["Collection"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{},{"not":{}}]}}}}}}},"/projects/{projectId}/jobs/cancel-queued":{"post":{"operationId":"jobs.cancelQueued","summary":"Cancel every queued collection job","tags":["Collection"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string","format":"uuid"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["count"]}}}}}}},"/projects/{projectId}/analytics":{"get":{"operationId":"analytics.get","summary":"Analyze visibility, competitors, prompts, and citations","tags":["Analysis"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30},"allowEmptyValue":true,"allowReserved":true},{"name":"engine","in":"query","schema":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"tag","in":"query","schema":{"type":"string","maxLength":100},"allowEmptyValue":true,"allowReserved":true},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":9007199254740991,"default":1},"allowEmptyValue":true,"allowReserved":true},{"name":"promptId","in":"query","schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true},{"name":"cohort","in":"query","schema":{"enum":["current","all"],"type":"string","default":"all"},"allowEmptyValue":true,"allowReserved":true},{"name":"source","in":"query","schema":{"type":"string","maxLength":8000},"allowEmptyValue":true,"allowReserved":true},{"name":"sourceMode","in":"query","schema":{"enum":["page","domain"],"type":"string","default":"page"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"answers":{"type":"number"},"brands":{"type":"array","items":{"type":"object","properties":{"answers":{"type":"number"},"mentions":{"type":"number"},"citations":{"type":"number"},"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"role":{"type":"string"},"occurrences":{"type":"number"},"byEngine":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"answers":{"type":"number"},"mentions":{"type":"number"},"citations":{"type":"number"}},"required":["answers","mentions","citations"]}},"shareOfVoice":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["answers","mentions","citations","id","name","role","occurrences","byEngine","shareOfVoice"]}},"daily":{"type":"array","items":{"type":"object","properties":{"answers":{"type":"number"},"mentions":{"type":"number"},"citations":{"type":"number"},"date":{"type":"string"},"competitorMentions":{"type":"number"}},"required":["answers","mentions","citations","date","competitorMentions"]}},"trend":{"type":"object","properties":{"commonInputs":{"type":"number"},"observedDays":{"type":"number"},"includedAnswers":{"type":"number"},"excludedAnswers":{"type":"number"}},"required":["commonInputs","observedDays","includedAnswers","excludedAnswers"]},"prompts":{"type":"array","items":{"type":"object","properties":{"answers":{"type":"number"},"mentions":{"type":"number"},"citations":{"type":"number"},"id":{"type":"string"},"revisionKey":{"type":"string"},"text":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"byEngine":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"answers":{"type":"number"},"mentions":{"type":"number"},"citations":{"type":"number"}},"required":["answers","mentions","citations"]}},"competitorOnlyAnswers":{"type":"number"},"uncitedMentions":{"type":"number"}},"required":["answers","mentions","citations","id","revisionKey","text","tags","byEngine","competitorOnlyAnswers","uncitedMentions"]}},"citations":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"domain":{"type":"string"},"category":{"type":"string"},"answers":{"type":"number"},"engines":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"string"}}},"required":["url","title","domain","category","answers","engines","prompts"]}},"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"category":{"type":"string"},"answers":{"type":"number"},"engines":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"string"}}},"required":["domain","category","answers","engines","prompts","pages"]}},"responses":{"type":"array","items":{"type":"object","properties":{"capture":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":20000},"answer":{"type":"string","minLength":1,"maxLength":200000},"citations":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"mentionedUrls":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"pageUrl":{"type":"string","format":"uri"},"capturedAt":{"type":"string","format":"date-time"},"method":{"enum":["automation","adapter","selection"],"type":"string"},"adapterVersion":{"type":"string","maxLength":100},"model":{"type":"string","maxLength":300},"locale":{"type":"string","maxLength":100},"context":{"enum":["fresh","existing","unknown"],"type":"string"},"privacy":{"type":"object","properties":{"mode":{"enum":["temporary-unpersonalized","temporary","incognito","search-nonpersonalized"],"type":"string"},"verified":{"const":true},"verifiedAt":{"type":"string","format":"date-time"},"memory":{"enum":["disabled","not-applicable"],"type":"string"},"evidence":{"type":"string","maxLength":8000},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}}},"required":["mode","verified","verifiedAt","memory","evidence","warnings"]},"brandMentions":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}}},"required":["brandId","name","aliases"]}},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}},"sourcesExpanded":{"type":"boolean"}},"required":["id","engine","prompt","answer","citations","pageUrl","capturedAt","method","adapterVersion","model","locale","context"]},"analysis":{"type":"object","properties":{"version":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string"},"role":{"enum":["brand","competitor"],"type":"string"},"occurrences":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"alias":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"}},"required":["text","alias","start","end"]}},"citations":{"type":"array","items":{"type":"string"}}},"required":["brandId","name","role","occurrences","citations"]}}},"required":["version","brands"]},"tags":{"type":"array","items":{"type":"string"}},"sourceStatus":{"enum":["inspected","incomplete","unknown"],"type":"string"},"currentDefinition":{"type":"boolean"}},"required":["capture","analysis","tags","sourceStatus","currentDefinition"]}},"responseCount":{"type":"number"},"page":{"type":"number"},"tags":{"type":"array","items":{"type":"string"}},"excludedAnswers":{"type":"number"},"mixedDefinitions":{"type":"boolean"},"contexts":{"type":"array","items":{"type":"string"}},"lastCapturedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceCoverage":{"type":"object","properties":{"inspected":{"type":"number"},"incomplete":{"type":"number"},"unknown":{"type":"number"}},"required":["inspected","incomplete","unknown"]},"jobs":{"type":"object","properties":{"planned":{"type":"number"},"completed":{"type":"number"},"pending":{"type":"number"},"active":{"type":"number"},"attention":{"type":"number"},"failed":{"type":"number"},"noOverview":{"type":"number"},"cancelled":{"type":"number"},"superseded":{"type":"number"}},"required":["planned","completed","pending","active","attention","failed","noOverview","cancelled","superseded"]}},"required":["version","answers","brands","daily","trend","prompts","citations","domains","responses","responseCount","page","tags","excludedAnswers","mixedDefinitions","contexts","lastCapturedAt","sourceCoverage","jobs"]}}}}}}},"/projects/{projectId}/overview":{"get":{"operationId":"analytics.overview","summary":"Summarize daily brand visibility, missed prompts, and competitor citations","tags":["Analysis"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30},"allowEmptyValue":true,"allowReserved":true},{"name":"engine","in":"query","schema":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"allowEmptyValue":true,"allowReserved":true},{"name":"cohort","in":"query","schema":{"enum":["current","all"],"type":"string","default":"current"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"own":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":["id","name","domain"]},"visibility":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]},"cited":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]},"previous":{"type":"object","properties":{"visibility":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]},"cited":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]}},"required":["visibility","cited"]},"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"enum":["brand","competitor"],"type":"string"},"mentions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","name","role","mentions","rate"]}},"missingPrompts":{"type":"array","items":{"type":"object","properties":{"promptId":{"type":"string"},"prompt":{"type":"string"},"missed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"engines":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"competitors":{"type":"array","items":{"type":"string"}}},"required":["promptId","prompt","missed","engines","competitors"]}},"competitorSources":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"title":{"type":"string"},"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"competitors":{"type":"array","items":{"type":"string"}}},"required":["domain","title","answers","competitors"]}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cited":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["date","numerator","denominator","cited"]}},"failedChecks":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastCapturedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentSince":{"type":"string"}},"required":["answers","own","visibility","cited","previous","competitors","missingPrompts","competitorSources","daily","failedChecks","lastCapturedAt","currentSince"]}}}}}}},"/projects/{projectId}/prompts/matrix":{"get":{"operationId":"analytics.promptMatrix","summary":"Read latest prompt results by engine","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30},"allowEmptyValue":true,"allowReserved":true},{"name":"tag","in":"query","schema":{"type":"string","maxLength":100},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"engines":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"rows":{"type":"array","items":{"type":"object","properties":{"promptId":{"type":"string"},"prompt":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"cells":{"type":"object","properties":{"chatgpt":{"type":"object","properties":{"state":{"enum":["mentioned","not_mentioned","no_overview","none"],"type":"string"},"answerId":{"type":"string"},"capturedAt":{"type":"string"}},"required":["state"]},"claude":{"type":"object","properties":{"state":{"enum":["mentioned","not_mentioned","no_overview","none"],"type":"string"},"answerId":{"type":"string"},"capturedAt":{"type":"string"}},"required":["state"]},"perplexity":{"type":"object","properties":{"state":{"enum":["mentioned","not_mentioned","no_overview","none"],"type":"string"},"answerId":{"type":"string"},"capturedAt":{"type":"string"}},"required":["state"]},"google-ai-overviews":{"type":"object","properties":{"state":{"enum":["mentioned","not_mentioned","no_overview","none"],"type":"string"},"answerId":{"type":"string"},"capturedAt":{"type":"string"}},"required":["state"]}},"required":["chatgpt","claude","perplexity","google-ai-overviews"]},"visibility":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]}},"required":["promptId","prompt","tags","cells","visibility"]}}},"required":["engines","rows"]}}}}}}},"/projects/{projectId}/prompts/{promptId}/detail":{"get":{"operationId":"analytics.promptDetail","summary":"Read visibility and answer history for one prompt","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"promptId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30},"allowEmptyValue":true,"allowReserved":true},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000000,"default":1},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["id","text","tags"]},"visibility":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]},"cited":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]},"engines":{"type":"array","items":{"type":"object","properties":{"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"state":{"enum":["mentioned","not_mentioned","no_overview","none"],"type":"string"},"answerId":{"type":"string"},"capturedAt":{"type":"string"},"visibility":{"type":"object","properties":{"numerator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"denominator":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["numerator","denominator"]}},"required":["engine","state","visibility"]}},"competitors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"enum":["brand","competitor"],"type":"string"},"mentions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","name","role","mentions","rate"]}},"history":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"answerId":{"type":"string"},"capturedAt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"mentioned":{"type":"boolean"},"competitors":{"type":"array","items":{"type":"string"}},"citations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ownedCitation":{"type":"boolean"}},"required":["answerId","capturedAt","engine","mentioned","competitors","citations","ownedCitation"]}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page"]}},"required":["prompt","visibility","cited","engines","competitors","history"]}}}}}}},"/projects/{projectId}/reanalyze":{"post":{"operationId":"analytics.reanalyze","summary":"Reanalyze raw responses against their original run snapshots","tags":["Analysis"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"count":{"type":"number"}},"required":["version","count"]}}}}}}},"/projects/{projectId}/answers/{answerId}":{"get":{"operationId":"answers.get","summary":"Inspect an original answer and its evidence","tags":["Analysis"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"answerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"capture":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":20000},"answer":{"type":"string","minLength":1,"maxLength":200000},"citations":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"mentionedUrls":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"pageUrl":{"type":"string","format":"uri"},"capturedAt":{"type":"string","format":"date-time"},"method":{"enum":["automation","adapter","selection"],"type":"string"},"adapterVersion":{"type":"string","maxLength":100},"model":{"type":"string","maxLength":300},"locale":{"type":"string","maxLength":100},"context":{"enum":["fresh","existing","unknown"],"type":"string"},"privacy":{"type":"object","properties":{"mode":{"enum":["temporary-unpersonalized","temporary","incognito","search-nonpersonalized"],"type":"string"},"verified":{"const":true},"verifiedAt":{"type":"string","format":"date-time"},"memory":{"enum":["disabled","not-applicable"],"type":"string"},"evidence":{"type":"string","maxLength":8000},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}}},"required":["mode","verified","verifiedAt","memory","evidence","warnings"]},"brandMentions":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}}},"required":["brandId","name","aliases"]}},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}},"sourcesExpanded":{"type":"boolean"}},"required":["id","engine","prompt","answer","citations","pageUrl","capturedAt","method","adapterVersion","model","locale","context"]},"analysis":{"type":"object","properties":{"version":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string"},"role":{"enum":["brand","competitor"],"type":"string"},"occurrences":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"alias":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"}},"required":["text","alias","start","end"]}},"citations":{"type":"array","items":{"type":"string"}}},"required":["brandId","name","role","occurrences","citations"]}}},"required":["version","brands"]},"tags":{"type":"array","items":{"type":"string"}},"sourceStatus":{"enum":["inspected","incomplete","unknown"],"type":"string"}},"required":["capture","analysis","tags","sourceStatus"]}}}}}}},"/browsers/status":{"get":{"operationId":"browserStatus","summary":"Read browser availability and advertised collection permissions","tags":["Connections"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"enabled":{"type":"boolean"},"engines":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"permissions":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"seenAt":{"type":"string"},"recent":{"type":"boolean"}},"required":["id","name","enabled","engines","permissions","seenAt","recent"]}}}}}}}},"/collectors/pool":{"get":{"operationId":"collectors.pool","summary":"List organization browser collectors","tags":["Connections"],"parameters":[{"name":"organizationId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ownerName":{"type":"string"},"mine":{"type":"boolean"},"enabled":{"type":"boolean"},"engines":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"seenAt":{"type":"string"},"recent":{"type":"boolean"}},"required":["id","name","ownerName","mine","enabled","engines","seenAt","recent"]}}}}}}}},"/me":{"get":{"operationId":"me","summary":"Identify the authenticated account","tags":["Account"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"}},"required":["userId","email","name"]}}}}}}},"/projects/{projectId}":{"put":{"operationId":"projects.update","summary":"Edit tracked brands, aliases, and competitor domains","tags":["Projects"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}}},"required":["name","brands"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"organizationId":{"type":"string"},"organizationName":{"type":"string"}},"required":["name","brands","id","createdAt","organizationId"]}}}}}},"get":{"operationId":"projects.get","summary":"Get a brand","tags":["Projects"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"organizationId":{"type":"string"},"organizationName":{"type":"string"}},"required":["name","brands","id","createdAt","organizationId"]}}}}}}},"/projects":{"get":{"operationId":"projects.list","summary":"List organization brands","tags":["Projects"],"parameters":[{"name":"organizationId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"organizationId":{"type":"string"},"organizationName":{"type":"string"}},"required":["name","brands","id","createdAt","organizationId"]}}}}}}},"post":{"operationId":"projects.create","summary":"Create a brand","tags":["Projects"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"organizationId":{"type":"string"}},"required":["name","brands"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"organizationId":{"type":"string"},"organizationName":{"type":"string"}},"required":["name","brands","id","createdAt","organizationId"]}}}}}}},"/billing":{"get":{"operationId":"billing.status","summary":"Read an organization plan, limits and subscription","tags":["Billing"],"parameters":[{"name":"organizationId","in":"query","schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"enum":["free","founder","studio"],"type":"string"},"enforced":{"type":"boolean"},"available":{"type":"boolean"},"limits":{"type":"object","properties":{"brands":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"historyDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"integrations":{"type":"boolean"}},"required":["brands","historyDays","integrations"]},"brands":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"subscription":{"anyOf":[{"type":"object","properties":{"interval":{"type":"string"},"status":{"type":"string"},"currentPeriodEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"cancelAtPeriodEnd":{"type":"boolean"},"managedByMe":{"type":"boolean"}},"required":["interval","status","currentPeriodEnd","cancelAtPeriodEnd","managedByMe"]},{"type":"null"}]}},"required":["plan","enforced","available","limits","brands","subscription"]}}}}}}},"/billing/checkout":{"post":{"operationId":"billing.checkout","summary":"Start a Polar checkout for an organization plan","tags":["Billing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string"},"plan":{"enum":["founder","studio"],"type":"string"},"interval":{"enum":["month","year"],"type":"string"}},"required":["organizationId","plan","interval"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}}}}},"/billing/portal":{"post":{"operationId":"billing.portal","summary":"Open the Polar customer portal for an organization subscription","tags":["Billing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string"}},"required":["organizationId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}}}}},"/organizations":{"get":{"operationId":"organizations.list","summary":"List organizations you belong to","tags":["Organizations"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"active":{"type":"boolean"}},"required":["id","name","role","active"]}}}}}}}},"/projects/{projectId}/prompts/starter":{"post":{"operationId":"prompts.starter","summary":"Add starter prompts and queue a first run","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","maxLength":200},"queueRun":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"}},"required":["projectId","text","id","createdAt"]}},"runId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["created","runId"]}}}}}}},"/projects/{projectId}/prompts/import":{"post":{"operationId":"prompts.import","summary":"Import reviewed prompts, skipping exact duplicates","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompts":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]}},"required":["text"]}}},"required":["prompts"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"}},"required":["projectId","text","id","createdAt"]}},"skipped":{"type":"number"}},"required":["created","skipped"]}}}}}}},"/projects/{projectId}/prompts/bulk":{"patch":{"operationId":"prompts.bulk","summary":"Pause, enable or add tags to selected prompts","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"promptIds":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","format":"uuid"}},"enabled":{"type":"boolean"},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100}}},"required":["promptIds"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"number"}},"required":["updated"]}}}}}}},"/projects/{projectId}/prompts/{promptId}":{"put":{"operationId":"prompts.update","summary":"Edit or pause a tracking prompt","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"promptId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]}},"required":["text"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"}},"required":["projectId","text","id","createdAt"]}}}}}}},"/projects/{projectId}/prompts":{"get":{"operationId":"prompts.list","summary":"List prompts","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"}},"required":["projectId","text","id","createdAt"]}}}}}}},"post":{"operationId":"prompts.create","summary":"Create a prompt","tags":["Prompts"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]}},"required":["text"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"text":{"type":"string","minLength":1,"maxLength":20000},"enabled":{"type":"boolean","default":true},"tags":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":100},"default":[]},"id":{"type":"string","format":"uuid"},"createdAt":{"type":"string"}},"required":["projectId","text","id","createdAt"]}}}}}}},"/projects/{projectId}/schedule":{"get":{"operationId":"schedules.get","summary":"Read project daily schedule","tags":["Scheduling"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"enabled":{"type":"boolean"},"time":{"type":"string"},"timezone":{"type":"string"},"engines":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"nextAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["projectId","enabled","time","timezone","engines","nextAt"]}}}}}},"put":{"operationId":"schedules.update","summary":"Configure a project daily schedule","tags":["Scheduling"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"timezone":{"type":"string","maxLength":100},"engines":{"type":"array","minItems":1,"maxItems":5,"items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}}},"required":["enabled","time","timezone","engines"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid"},"enabled":{"type":"boolean"},"time":{"type":"string"},"timezone":{"type":"string"},"engines":{"type":"array","items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"nextAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["projectId","enabled","time","timezone","engines","nextAt"]}}}}}}},"/projects/{projectId}/runs":{"get":{"operationId":"runs.list","summary":"List runs","tags":["Runs"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"projectId":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"scheduledAt":{"type":"string"},"status":{"enum":["running","paused","completed","cancelled"],"type":"string"},"finishedAt":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"privacyRequired":{"type":"boolean"},"resultId":{"type":"string","format":"uuid"},"error":{"type":"string"}},"required":["id","promptId","prompt","engine","status"]}},"pauseReason":{"type":"string"}},"required":["id","projectId","createdAt","status","brands","jobs"]}}}}}}},"post":{"operationId":"runs.create","summary":"Create a browser run","tags":["Runs"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"engines":{"type":"array","minItems":1,"maxItems":5,"items":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"}},"promptIds":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","format":"uuid"}}},"required":["engines"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"projectId":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"scheduledAt":{"type":"string"},"status":{"enum":["running","paused","completed","cancelled"],"type":"string"},"finishedAt":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"privacyRequired":{"type":"boolean"},"resultId":{"type":"string","format":"uuid"},"error":{"type":"string"}},"required":["id","promptId","prompt","engine","status"]}},"pauseReason":{"type":"string"}},"required":["id","projectId","createdAt","status","brands","jobs"]}}}}}}},"/projects/{projectId}/runs/{runId}":{"get":{"operationId":"runs.get","summary":"Get run instructions","tags":["Runs"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"projectId":{"type":"string","format":"uuid"},"createdAt":{"type":"string"},"scheduledAt":{"type":"string"},"status":{"enum":["running","paused","completed","cancelled"],"type":"string"},"finishedAt":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"domains":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}},"role":{"enum":["brand","competitor"],"type":"string"}},"required":["id","name","aliases","domains"]}},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"status":{"enum":["queued","leased","opening","privacy","preparing","submitting","waiting","attention","completed","failed","no-overview","cancelled","superseded"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"privacyRequired":{"type":"boolean"},"resultId":{"type":"string","format":"uuid"},"error":{"type":"string"}},"required":["id","promptId","prompt","engine","status"]}},"pauseReason":{"type":"string"}},"required":["id","projectId","createdAt","status","brands","jobs"]}}}}}}},"/projects/{projectId}/runs/{runId}/progress":{"put":{"operationId":"runs.progress","summary":"Report browser run progress","tags":["Runs"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"enum":["running","paused","completed","cancelled"],"type":"string"},"jobs":{"type":"array","maxItems":1000,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["queued","opening","privacy","preparing","submitting","waiting","completed","failed","no-overview","cancelled"],"type":"string"},"error":{"type":"string","maxLength":4000}},"required":["id","status"]}},"pauseReason":{"type":"string","maxLength":4000}},"required":["status","jobs"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}}}},"/projects/{projectId}/observations":{"get":{"operationId":"observations.list","summary":"List observations","tags":["Observations"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":20000},"answer":{"type":"string","minLength":1,"maxLength":200000},"citations":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"mentionedUrls":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"pageUrl":{"type":"string","format":"uri"},"capturedAt":{"type":"string","format":"date-time"},"method":{"enum":["automation","adapter","selection"],"type":"string"},"adapterVersion":{"type":"string","maxLength":100},"model":{"type":"string","maxLength":300},"locale":{"type":"string","maxLength":100},"context":{"enum":["fresh","existing","unknown"],"type":"string"},"privacy":{"type":"object","properties":{"mode":{"enum":["temporary-unpersonalized","temporary","incognito","search-nonpersonalized"],"type":"string"},"verified":{"const":true},"verifiedAt":{"type":"string","format":"date-time"},"memory":{"enum":["disabled","not-applicable"],"type":"string"},"evidence":{"type":"string","maxLength":8000},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}}},"required":["mode","verified","verifiedAt","memory","evidence","warnings"]},"brandMentions":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}}},"required":["brandId","name","aliases"]}},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}},"sourcesExpanded":{"type":"boolean"}},"required":["id","engine","prompt","answer","citations","pageUrl","capturedAt","method","adapterVersion","model","locale","context"]}}}}}}},"post":{"operationId":"observations.upload","summary":"Upload a captured observation idempotently","tags":["Observations"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capture":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"promptId":{"type":"string","format":"uuid"},"engine":{"enum":["chatgpt","claude","perplexity","google-ai-overviews"],"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":20000},"answer":{"type":"string","minLength":1,"maxLength":200000},"citations":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"mentionedUrls":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":2000},"rawUrl":{"type":"string","maxLength":8000},"source":{"enum":["source-panel","citation","inline-link","answer-text"],"type":"string"}},"required":["url","title"]}},"pageUrl":{"type":"string","format":"uri"},"capturedAt":{"type":"string","format":"date-time"},"method":{"enum":["automation","adapter","selection"],"type":"string"},"adapterVersion":{"type":"string","maxLength":100},"model":{"type":"string","maxLength":300},"locale":{"type":"string","maxLength":100},"context":{"enum":["fresh","existing","unknown"],"type":"string"},"privacy":{"type":"object","properties":{"mode":{"enum":["temporary-unpersonalized","temporary","incognito","search-nonpersonalized"],"type":"string"},"verified":{"const":true},"verifiedAt":{"type":"string","format":"date-time"},"memory":{"enum":["disabled","not-applicable"],"type":"string"},"evidence":{"type":"string","maxLength":8000},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}}},"required":["mode","verified","verifiedAt","memory","evidence","warnings"]},"brandMentions":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":300}}},"required":["brandId","name","aliases"]}},"warnings":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":2000}},"sourcesExpanded":{"type":"boolean"}},"required":["id","engine","prompt","answer","citations","pageUrl","capturedAt","method","adapterVersion","model","locale","context"]}},"required":["capture"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"duplicate":{"type":"boolean"}},"required":["id","duplicate"]}}}}}}},"/connections/oauth":{"get":{"operationId":"oauthConnections.list","summary":"List authorized Chrome browsers","tags":["Connections"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"}},"required":["id","name","createdAt","expiresAt"]}}}}}},"security":[{"session":[]}]}},"/connections/oauth/{grantId}":{"delete":{"operationId":"oauthConnections.revoke","summary":"Revoke a Chrome browser and its tokens","tags":["Connections"],"parameters":[{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":512}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}},"security":[{"session":[]}]}},"/connections":{"get":{"operationId":"connections.list","summary":"List extension connections","tags":["Connections"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":"string"}},"required":["id","name","createdAt","expiresAt"]}}}}}},"security":[{"session":[]}]},"post":{"operationId":"connections.create","summary":"Create a revocable extension credential","tags":["Connections"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"token":{"type":"string"},"expiresAt":{"type":"string"}},"required":["id","token","expiresAt"]}}}}},"security":[{"session":[]}]}},"/connections/{id}":{"delete":{"operationId":"connections.revoke","summary":"Revoke an extension credential","tags":["Connections"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true}},"required":["ok"]}}}}},"security":[{"session":[]}]}}}}