{"openapi":"3.1.0","paths":{"/public/v2/websites":{"get":{"operationId":"PublicApiV2AnalyticsController_listWebsites","parameters":[{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"},"description":"Resumable incremental scan: websites changed at or after this UTC instant."},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteListResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List websites available to the workspace","tags":["Public API V2"]}},"/public/v2/websites/{website_id}":{"get":{"operationId":"PublicApiV2AnalyticsController_getWebsite","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get one website","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics":{"get":{"operationId":"PublicApiV2AnalyticsController_latest","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"include","required":false,"in":"query","schema":{"type":"string","pattern":"^\\s*(?:providers|competitors)(?:\\s*,\\s*(?:providers|competitors))*\\s*$"},"description":"Comma-separated providers and competitors expansions."}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsSnapshotResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get the latest finalized analytics snapshot","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/history":{"get":{"operationId":"PublicApiV2AnalyticsController_history","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsHistoryListResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List immutable analytics history","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/mentions":{"get":{"operationId":"PublicApiV2AnalyticsController_mentions","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["chatgpt","gemini","perplexity","google_ai_overview"],"type":"string"}},{"name":"analysis_id","required":false,"in":"query","schema":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MentionListResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List brand mention evidence","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/citations":{"get":{"operationId":"PublicApiV2AnalyticsController_citations","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"entity_type","required":false,"in":"query","schema":{"enum":["brand","competitor","other"],"type":"string"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["chatgpt","gemini","perplexity","google_ai_overview"],"type":"string"}},{"name":"analysis_id","required":false,"in":"query","schema":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitationListResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}},"RateLimit-Limit":{"description":"Request ceiling for the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"string","pattern":"^[0-9]+$"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"string","pattern":"^[0-9]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List citation evidence","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/prompts:import":{"post":{"operationId":"PublicApiV2PromptImportController_submit","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":255}}],"responses":{"200":{"description":"Terminal replay receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Location":{"description":"Relative URL of the prompt import receipt.","schema":{"type":"string","pattern":"^/public/v2/websites/web_[A-Za-z0-9_-]+/prompt-imports/pim_[A-Za-z0-9_-]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptImportReceiptEnvelope"}}}},"202":{"description":"Accepted or pending receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Location":{"description":"Relative URL of the prompt import receipt.","schema":{"type":"string","pattern":"^/public/v2/websites/web_[A-Za-z0-9_-]+/prompt-imports/pim_[A-Za-z0-9_-]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptImportReceiptEnvelope"}}}},"400":{"description":"The request is invalid.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks prompt write access.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The idempotency key conflicts with an existing request.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"The request payload is too large.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"415":{"description":"The request media type is not supported.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Submit an append-only prompt import","tags":["Public API V2"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptImportRequestInput"}}}}}},"/public/v2/websites/{website_id}/prompt-imports/{import_id}":{"get":{"operationId":"PublicApiV2PromptImportController_get","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"import_id","required":true,"in":"path","description":"Opaque prompt import identifier.","schema":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Current prompt import receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Polling delay in seconds. Present only while status is pending or processing.","schema":{"type":"string","pattern":"^[1-9][0-9]*$","example":"2"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptImportReceiptEnvelope"}}}},"400":{"description":"The request is invalid.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks prompt write access.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get a prompt import receipt","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit":{"get":{"operationId":"PublicApiV2TechnicalAuditController_getLatest","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"methodology_version":{"type":"string"},"finding_model_version":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"validation_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"health_score":{"type":"number"},"readiness":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"measured"},"score":{"type":"number","minimum":0,"maximum":100},"observed_page_share":{"type":"number","minimum":0,"maximum":1}},"required":["status","score","observed_page_share"],"additionalProperties":{}},{"type":"object","properties":{"status":{"type":"string","const":"insufficient_observation"},"observed_page_share":{"type":"number","minimum":0,"maximum":1}},"required":["status","observed_page_share"],"additionalProperties":{}},{"type":"object","properties":{"status":{"type":"string","const":"legacy_unknown"},"observed_page_share":{"type":"null"}},"required":["status","observed_page_share"],"additionalProperties":{}}]},"readiness_caps":{"type":"array","items":{"type":"object","properties":{"gate":{"type":"string"},"cap":{"type":"number"},"reason":{"type":"string"}},"required":["gate","cap","reason"],"additionalProperties":{}}},"provider_readiness":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"display_name":{"type":"string"},"renders_js":{"type":"boolean"},"status":{"type":"string","enum":["measured","insufficient_observation","legacy_unknown"]},"score":{"type":"number","minimum":0,"maximum":100},"grade":{"type":"string","enum":["A","B","C","D","F"]},"observed_page_share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"blocking_gates":{"type":"array","items":{"type":"object","properties":{"gate":{"type":"string"},"cap":{"type":"number"},"reason":{"type":"string"}},"required":["gate","cap","reason"],"additionalProperties":{}}}},"required":["provider","display_name","renders_js","status","observed_page_share","blocking_gates"],"additionalProperties":{}}},"counts":{"type":"object","properties":{"errors":{"type":"integer","minimum":0,"maximum":9007199254740991},"warnings":{"type":"integer","minimum":0,"maximum":9007199254740991},"notices":{"type":"integer","minimum":0,"maximum":9007199254740991},"issues":{"type":"integer","minimum":0,"maximum":9007199254740991},"recommendations":{"type":"integer","minimum":0,"maximum":9007199254740991},"audited_pages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["errors","warnings","notices","issues","recommendations","audited_pages"],"additionalProperties":{}},"coverage":{"type":"object","properties":{"crawled_pages":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"type":"null"}]}},"required":["crawled_pages"],"additionalProperties":{}},"themes":{"type":"array","items":{"type":"object","properties":{"theme":{"type":"string"},"display_name":{"type":"string"},"description":{"type":"string"},"score":{"type":"number"},"error_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warning_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"notice_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"finding_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"affected_pages":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["theme","display_name","description","score","error_count","warning_count","notice_count","finding_count","affected_pages"],"additionalProperties":{}}},"diagnostics":{"type":"object","properties":{"technical":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"backlinks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"geo":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"semantic_retrieval":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"sources":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"discovery":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"policy":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"ai_search_health":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["technical","backlinks","geo","semantic_retrieval","sources","discovery","policy","ai_search_health"],"additionalProperties":{}}},"required":["id","project_id","methodology_version","finding_model_version","created_at","validation_status","health_score","readiness","readiness_caps","provider_readiness","counts","coverage","themes","diagnostics"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get the latest Technical Audit","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/runs":{"get":{"operationId":"PublicApiV2TechnicalAuditController_listRuns","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":500,"type":"number"}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"readiness_score":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"health_score":{"type":"number"},"error_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"warning_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"notice_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"pages_audited":{"type":"integer","minimum":0,"maximum":9007199254740991},"pages_discovered":{"type":"integer","minimum":0,"maximum":9007199254740991},"page_limit":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","project_id","readiness_score","health_score","error_count","warning_count","notice_count","pages_audited","pages_discovered","page_limit","created_at"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List Technical Audit Runs","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/findings":{"get":{"operationId":"PublicApiV2TechnicalAuditController_listFindings","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"theme","required":false,"in":"query","schema":{"type":"string"}},{"name":"severity","required":false,"in":"query","schema":{"enum":["error","warning","notice"],"type":"string"}},{"name":"kind","required":false,"in":"query","schema":{"enum":["issue","recommendation"],"type":"string"}},{"name":"audit_id","required":false,"in":"query","schema":{"pattern":"^aud_[A-Za-z0-9_-]+$","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":500,"type":"number"}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^fnd_[A-Za-z0-9_-]+$"},"audit_id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"kind":{"type":"string","enum":["issue","recommendation"]},"audit_check":{"type":"string"},"rule_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"type":"string"},"severity":{"type":"string","enum":["error","warning","notice"]},"score_impact":{"type":"string"},"affected_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"why_it_matters":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"anyOf":[{"type":"string"},{"type":"null"}]},"sample_pages":{"type":"array","items":{"type":"string","format":"uri"}},"evidence_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","audit_id","project_id","kind","audit_check","rule_id","theme","severity","score_impact","affected_page_count","why_it_matters","how_to_fix","sample_pages","evidence_count"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List Technical Audit Findings","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/findings/{finding_id}":{"get":{"operationId":"PublicApiV2TechnicalAuditController_getFinding","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"finding_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"audit_id","required":false,"in":"query","schema":{"pattern":"^aud_[A-Za-z0-9_-]+$","type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^fnd_[A-Za-z0-9_-]+$"},"audit_id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"kind":{"type":"string","enum":["issue","recommendation"]},"audit_check":{"type":"string"},"rule_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"theme":{"type":"string"},"severity":{"type":"string","enum":["error","warning","notice"]},"score_impact":{"type":"string"},"affected_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"why_it_matters":{"anyOf":[{"type":"string"},{"type":"null"}]},"how_to_fix":{"anyOf":[{"type":"string"},{"type":"null"}]},"sample_pages":{"type":"array","items":{"type":"string","format":"uri"}},"evidence_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","audit_id","project_id","kind","audit_check","rule_id","theme","severity","score_impact","affected_page_count","why_it_matters","how_to_fix","sample_pages","evidence_count"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get a Technical Audit Finding","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/pages":{"get":{"operationId":"PublicApiV2TechnicalAuditController_listPages","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"include_aliases","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"kind","required":false,"in":"query","schema":{"enum":["issue","recommendation","all"],"type":"string"}},{"name":"audit_check","required":false,"in":"query","schema":{"type":"string"}},{"name":"severity","required":false,"in":"query","schema":{"enum":["error","warning","notice"],"type":"string"}},{"name":"audit_id","required":false,"in":"query","schema":{"pattern":"^aud_[A-Za-z0-9_-]+$","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":500,"type":"number"}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^apg_[A-Za-z0-9_-]+$"},"audit_id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"url":{"type":"string","format":"uri"},"discovered_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"meta_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"h1_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"h1_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"rendered_word_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"js_gap_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"readability_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"redirect_target_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"scope_membership_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_indexable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"robots_directives":{"anyOf":[{"type":"string"},{"type":"null"}]},"internal_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"external_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"broken_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"has_structured_data":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"schema_types":{"type":"array","items":{}},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"template_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"crawl_depth":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"recommendations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"evidence_summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"observations_summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"semantic_analysis":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"semantic_retrieval_scores":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"core_web_vitals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","audit_id","project_id","url","discovered_url","status_code","title","meta_description","h1_count","h1_text","word_count","rendered_word_count","js_gap_ratio","readability_score","canonical_url","canonical_status","redirect_target_url","scope_membership_status","is_indexable","robots_directives","internal_links_count","external_links_count","broken_links_count","has_structured_data","schema_types","page_type","template_key","crawl_depth","issues","recommendations","evidence_summary","observations_summary","semantic_analysis","semantic_retrieval_scores","core_web_vitals"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List audited pages","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/pages/{page_id}":{"get":{"operationId":"PublicApiV2TechnicalAuditController_getPage","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"page_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"audit_id","required":false,"in":"query","schema":{"pattern":"^aud_[A-Za-z0-9_-]+$","type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^apg_[A-Za-z0-9_-]+$"},"audit_id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"url":{"type":"string","format":"uri"},"discovered_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"meta_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"h1_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"h1_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"word_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"rendered_word_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"js_gap_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"readability_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"redirect_target_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"scope_membership_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_indexable":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"robots_directives":{"anyOf":[{"type":"string"},{"type":"null"}]},"internal_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"external_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"broken_links_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"has_structured_data":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"schema_types":{"type":"array","items":{}},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"template_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"crawl_depth":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"issues":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"recommendations":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"evidence":{"type":"array","items":{"type":"object","properties":{"audit_check":{"type":"string"},"rule_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"type":"string"},"status":{"type":"string"},"kind":{"type":"string"},"verification_status":{"type":"string"},"is_actionable":{"type":"boolean"},"detector":{"type":"string"},"source":{"type":"string"},"observed_value":{"anyOf":[{"type":"string"},{"type":"null"}]},"expected_value":{"anyOf":[{"type":"string"},{"type":"null"}]},"evidence_snippet":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["audit_check","rule_id","severity","status","kind","verification_status","is_actionable","detector","source","observed_value","expected_value","evidence_snippet"],"additionalProperties":{}}},"evidence_summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"observations_summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"semantic_analysis":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"semantic_retrieval_scores":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"core_web_vitals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"performance_samples":{"type":"array","items":{"type":"object","properties":{"strategy":{"type":"string"},"field_lcp":{"anyOf":[{"type":"number"},{"type":"null"}]},"field_cls":{"anyOf":[{"type":"number"},{"type":"null"}]},"field_inp":{"anyOf":[{"type":"number"},{"type":"null"}]},"field_ttfb":{"anyOf":[{"type":"number"},{"type":"null"}]},"lab_fcp":{"anyOf":[{"type":"number"},{"type":"null"}]},"lab_lcp":{"anyOf":[{"type":"number"},{"type":"null"}]},"lab_speed_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"lab_tbt":{"anyOf":[{"type":"number"},{"type":"null"}]},"performance_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"opportunities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"diagnostics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["strategy","field_lcp","field_cls","field_inp","field_ttfb","lab_fcp","lab_lcp","lab_speed_index","lab_tbt","performance_score","opportunities","diagnostics"],"additionalProperties":{}}},"inbound_link_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"inbound_links":{"type":"array","items":{"type":"object","properties":{"source_url":{"type":"string","format":"uri"},"anchor_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_follow":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["source_url","anchor_text","is_follow"],"additionalProperties":{}}}},"required":["id","audit_id","project_id","url","discovered_url","status_code","title","meta_description","h1_count","h1_text","word_count","rendered_word_count","js_gap_ratio","readability_score","canonical_url","canonical_status","redirect_target_url","scope_membership_status","is_indexable","robots_directives","internal_links_count","external_links_count","broken_links_count","has_structured_data","schema_types","page_type","template_key","crawl_depth","issues","recommendations","evidence","evidence_summary","observations_summary","semantic_analysis","semantic_retrieval_scores","core_web_vitals","performance_samples","inbound_link_count","inbound_links"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get an audited page","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/scope":{"get":{"operationId":"PublicApiV2TechnicalAuditController_getScope","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"audit_id","required":false,"in":"query","schema":{"pattern":"^aud_[A-Za-z0-9_-]+$","type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"audit_id":{"type":"string","maxLength":128,"pattern":"^aud_[A-Za-z0-9_-]+$"},"entry_url":{"type":"string","format":"uri"},"canonical_root_url":{"type":"string","format":"uri"},"allowed_path_prefixes":{"type":"array","items":{"type":"string"}},"include_subdomains":{"type":"boolean"},"allowed_subdomains":{"type":"array","items":{"type":"string"}},"include_sitemaps":{"type":"boolean"},"manual_sitemap_urls":{"type":"array","items":{"type":"string","format":"uri"}},"exclude_patterns":{"type":"array","items":{"type":"string"}},"page_limit":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["project_id","audit_id","entry_url","canonical_root_url","allowed_path_prefixes","include_subdomains","allowed_subdomains","include_sitemaps","manual_sitemap_urls","exclude_patterns","page_limit"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get the preserved Scope for an Audit Run","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/technical-audit/fixes":{"get":{"operationId":"PublicApiV2TechnicalAuditController_listFixes","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"page_url","required":false,"in":"query","schema":{"format":"uri","type":"string"}},{"name":"finding_id","required":false,"in":"query","schema":{"pattern":"^fnd_[A-Za-z0-9_-]+$","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":500,"type":"number"}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"finding_id":{"type":"string","maxLength":128,"pattern":"^fnd_[A-Za-z0-9_-]+$"},"title":{"type":"string"},"status":{"type":"string"},"page_url":{"type":"string","format":"uri"},"fix_type":{"type":"string"},"description":{"type":"string"},"original_content":{"anyOf":[{"type":"string"},{"type":"null"}]},"proposed_content":{"type":"string"},"content_format":{"type":"string"},"placement":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","project_id","finding_id","title","status","page_url","fix_type","description","original_content","proposed_content","content_format","placement","created_at"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List proposed Technical Audit Fixes","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/topics":{"get":{"operationId":"PublicApiV2AnalyticsInsightsController_topics","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Topic performance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPerformanceResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The website was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Per-topic citation, mention, and visibility rates","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/providers":{"get":{"operationId":"PublicApiV2AnalyticsInsightsController_providers","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Provider insights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderInsightsResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The website was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Per-provider insights and the recommended provider to invest in","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/competitive-signals":{"get":{"operationId":"PublicApiV2AnalyticsInsightsController_competitiveSignals","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Competitive signals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitiveSignalsResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The website was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Gain, threat, and opportunity alerts vs. the previous simulation","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/content-gaps":{"get":{"operationId":"PublicApiV2AnalyticsInsightsController_contentGaps","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Maximum number of gap rows to return, ranked by impact."}],"responses":{"200":{"description":"Content gaps.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentGapsResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The website was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Topic-level content gaps where competitors are cited, not you","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/offpage/opportunities":{"get":{"operationId":"PublicApiV2OffpageOpportunitiesController_list","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Active opportunities.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"opportunities":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"surface":{"type":"string"},"target":{"type":"string","description":"Opportunity location; for Communities this can be a community page."},"engagement_targets":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"source":{"type":"string","enum":["opportunity_target","cited_thread"]}},"required":["url","source"]},"description":"Exact third-party threads eligible for a Community Contribution; empty when none is known."},"origin":{"type":"string"},"source_identifier":{"anyOf":[{"type":"string"},{"type":"null"}]},"competitor_cited_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"customer_cited_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"priority":{"type":"string","enum":["high","medium","low","unrated"],"description":"Opportunity Priority is an ordering, not a predicted outcome."},"generated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","surface","target","engagement_targets","origin","source_identifier","competitor_cited_count","customer_cited_count","priority","generated_at"],"additionalProperties":{}}},"next_after_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["opportunities","next_after_id"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid query or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Project not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List active Off-Page Opportunities for a Project","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/perception/questions":{"get":{"operationId":"PublicApiV2PerceptionQuestionsController_list","parameters":[{"name":"website_id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Current declared question set.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"questions":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^pqn_[A-Za-z0-9_-]+$"},"question":{"type":"string"},"category":{"type":"string","enum":["comparison","brand_quality","objection","alternative","accuracy"]}},"required":["id","question","category"],"additionalProperties":{}}}},"required":["questions"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Project not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List the Project Perception Questions","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/reports":{"get":{"operationId":"PublicApiV2ReportsController_listReports","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"A page of reports.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportListResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"List generated analytics reports","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/reports/{report_id}":{"get":{"operationId":"PublicApiV2ReportsController_getReport","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"report_id","required":true,"in":"path","description":"Opaque report identifier.","schema":{"type":"string","maxLength":128,"pattern":"^rpt_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"The report.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"bearer":[]}],"summary":"Get one analytics report","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/reports/{report_id}/download":{"get":{"operationId":"PublicApiV2ReportsController_downloadReport","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"report_id","required":true,"in":"path","description":"Opaque report identifier.","schema":{"type":"string","maxLength":128,"pattern":"^rpt_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"The report file bytes."},"400":{"description":"Invalid request or cursor."},"401":{"description":"Authentication is required."},"403":{"description":"The API key lacks read scope."},"404":{"description":"The resource was not found."},"429":{"description":"Rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"A required service is temporarily unavailable."}},"security":[{"bearer":[]}],"summary":"Download the report file (streamed through the API)","tags":["Public API V2"]}},"/public/v2/openapi.json":{"get":{"operationId":"getPublicApiV2OpenApiDocument","summary":"Download the Public API V2 OpenAPI document","description":"Returns the independently versioned OpenAPI 3.1 JSON document.","security":[],"responses":{"200":{"description":"The Public API V2 OpenAPI document.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"info":{"title":"Videntic Public API V2","description":"The independently versioned Videntic Public API V2 contract.","version":"2.0.0","contact":{}},"tags":[],"servers":[{"url":"https://api.videntic.com"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"API Key","type":"http"}},"schemas":{"WebsiteListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"domain_url":{"type":"string","format":"uri"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"industry_niche":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]},"last_analysis_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","domain_url","country","language","industry_niche","last_analysis_at"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"ErrorEnvelope":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}},"WebsiteResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"domain_url":{"type":"string","format":"uri"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"industry_niche":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]},"last_analysis_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","domain_url","country","language","industry_niche","last_analysis_at"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"AnalyticsSnapshotResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"analysis_id":{"anyOf":[{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"available_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","visibility_eligible_providers","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sov_eligible_providers","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"providers":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}}},"required":["provider","metrics","counts","unavailable_reasons"],"additionalProperties":{}}},"competitors":{"type":"array","items":{"type":"object","properties":{"competitor_entity_key":{"type":"string","pattern":"^competitor:\\d+$"},"competitor_domain":{"type":"string","minLength":1,"maxLength":253},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["mentioned_responses","eligible_responses","mentions","citations","positioned_mention_sentences"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_eligible_responses","competitor_visibility_facts_unavailable","no_competitive_mentions","competitor_sov_facts_unavailable","no_competitive_citations","competitor_citation_facts_unavailable","no_competitor_mentions","competitor_position_evidence_unavailable"]}}},"required":["competitor_domain","metrics","counts","unavailable_reasons"],"additionalProperties":{}}}},"required":["website_id","analysis_id","as_of","available_at","metrics","counts"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"includes":{"maxItems":2,"type":"array","items":{"type":"string","enum":["providers","competitors"]}},"projection_version":{"type":"string","maxLength":40,"pattern":"^public_metrics_v\\d+$"},"metric_definition_bundle_version":{"type":"string","maxLength":64,"pattern":"^public_metric_definitions_v(?:0|[1-9]\\d*)$"},"metric_precision_version":{"type":"string","maxLength":64,"pattern":"^metric_precision_v(?:0|[1-9]\\d*)$"},"metric_definition_versions":{"type":"object","properties":{"visibility":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"share_of_voice":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"sentiment":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"citation_share":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"average_mention_position":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}},"data_quality":{"type":"object","properties":{"is_partial":{"type":"boolean"},"postprocess_status":{"type":"object","properties":{"sentiment":{"type":"string","enum":["completed","partial","failed","skipped","timed_out"]},"citation":{"type":"string","enum":["completed","partial","failed","skipped","timed_out"]}},"required":["sentiment","citation"],"additionalProperties":{}}},"required":["is_partial"],"additionalProperties":{}}},"required":["request_id","includes","projection_version","metric_definition_bundle_version","metric_precision_version","metric_definition_versions","unavailable_reasons","data_quality"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"AnalyticsHistoryListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"as_of":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","visibility_eligible_providers","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sov_eligible_providers","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"meta":{"type":"object","properties":{"projection_version":{"type":"string","maxLength":40,"pattern":"^public_metrics_v\\d+$"},"metric_definition_bundle_version":{"type":"string","maxLength":64,"pattern":"^public_metric_definitions_v(?:0|[1-9]\\d*)$"},"metric_precision_version":{"type":"string","maxLength":64,"pattern":"^metric_precision_v(?:0|[1-9]\\d*)$"},"metric_definition_versions":{"type":"object","properties":{"visibility":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"share_of_voice":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"sentiment":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"citation_share":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"average_mention_position":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}},"data_quality":{"type":"object","properties":{"is_partial":{"type":"boolean"},"postprocess_status":{"type":"object","properties":{"sentiment":{"type":"string","enum":["completed","partial","failed","skipped","timed_out"]},"citation":{"type":"string","enum":["completed","partial","failed","skipped","timed_out"]}},"required":["sentiment","citation"],"additionalProperties":{}}},"required":["is_partial"],"additionalProperties":{}}},"required":["projection_version","metric_definition_bundle_version","metric_precision_version","metric_definition_versions","unavailable_reasons","data_quality"],"additionalProperties":{}}},"required":["website_id","analysis_id","as_of","available_at","metrics","counts","meta"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"MentionListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^men_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"sentence_text":{"type":"string"},"sentence_text_truncated":{"type":"boolean"},"position_in_response":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"mention_spans":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":{}}}},"required":["id","analysis_id","observed_at","available_at","provider","sentence_text","sentence_text_truncated","position_in_response","sentiment","mention_spans"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"CitationListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^cit_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string","minLength":1,"maxLength":253},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"url_unavailable_reason":{"type":"string","enum":["invalid_url","unsafe_url"]},"entity_type":{"type":"string","enum":["brand","competitor","other"]},"competitor_entity_key":{"type":"string","pattern":"^competitor:\\d+$"},"competitor_domain":{"type":"string","minLength":1,"maxLength":253}},"required":["id","analysis_id","observed_at","available_at","provider","url","domain","title","position","entity_type"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"PromptImportRequestInput":{"type":"object","properties":{"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"prompt_text":{"type":"string"},"tags":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"language":{"type":"string","pattern":"^[a-z]{2}$"},"search_intent":{"type":"string","enum":["informational","commercial","transactional"]},"category":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"topic":{"type":"string","minLength":1,"maxLength":120},"seed_keyword":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]}},"required":["prompt_text"],"additionalProperties":false}},"defaults":{"default":{},"type":"object","properties":{"tags":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"language":{"type":"string","pattern":"^[a-z]{2}$"},"search_intent":{"type":"string","enum":["informational","commercial","transactional"]}},"additionalProperties":false},"classification":{"default":{"mode":"auto"},"type":"object","properties":{"mode":{"default":"auto","type":"string","enum":["auto","provided_only"]}},"required":["mode"],"additionalProperties":false},"validate_only":{"default":false,"type":"boolean"}},"required":["items","defaults","classification","validate_only"],"additionalProperties":false},"PromptImportReceiptEnvelope":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"processing_deadline_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"pending"},"validate_only":{"type":"boolean"}},"required":["id","object","website_id","created_at","expires_at","processing_deadline_at","status","validate_only"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"processing_deadline_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"processing"},"validate_only":{"type":"boolean"},"phase":{"type":"string","enum":["validating","classifying","committing"]},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","processing_deadline_at","status","validate_only","phase","started_at"]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","created","active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"created"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","would_create","active_count","projected_active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"would_create"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]}]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"number","const":0},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]}]}]},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"TopicPerformanceResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"topics":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"citation_rate":{"anyOf":[{"type":"number"},{"type":"null"}]},"mention_rate":{"anyOf":[{"type":"number"},{"type":"null"}]},"visibility":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["category","citation_rate","mention_rate","visibility"],"additionalProperties":{}}},"total_categories":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["as_of","topics","total_categories"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"ProviderInsightsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"providers":{"type":"array","items":{"type":"object","properties":{"provider_name":{"type":"string"},"brand_visibility":{"type":"number"},"category_preferences":{"anyOf":[{"type":"object","properties":{"ugc":{"type":"number"},"media":{"type":"number"},"reference":{"type":"number"},"ecommerce":{"type":"number"},"tech":{"type":"number"},"competitor":{"type":"number"},"uncategorized":{"type":"number"}},"required":["ugc","media","reference","ecommerce","tech","competitor","uncategorized"],"additionalProperties":{}},{"type":"null"}]},"insight":{"type":"string"},"opportunity_level":{"type":"string"}},"required":["provider_name","brand_visibility","category_preferences","insight","opportunity_level"],"additionalProperties":{}}},"recommendation":{"anyOf":[{"type":"object","properties":{"target_provider":{"type":"string"},"reason":{"type":"string"},"suggested_actions":{"type":"array","items":{"type":"string"}}},"required":["target_provider","reason","suggested_actions"],"additionalProperties":{}},{"type":"null"}]},"has_data":{"type":"boolean"}},"required":["as_of","providers","recommendation","has_data"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"CompetitiveSignalsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"signals":{"type":"array","items":{"type":"object","properties":{"signal_type":{"type":"string"},"severity":{"type":"string","enum":["gain","threat","opportunity"]},"title":{"type":"string"},"description":{"type":"string"},"delta":{"anyOf":[{"type":"number"},{"type":"null"}]},"provider":{"anyOf":[{"type":"string"},{"type":"null"}]},"competitor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["signal_type","severity","title","description","delta","provider","competitor"],"additionalProperties":{}}},"message":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["as_of","signals","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"ContentGapsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"gaps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^cog_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"content_gap"},"topic":{"type":"string"},"observation_status":{"type":"string","enum":["open","addressed"]},"triage_status":{"type":"string","enum":["none","planned"]},"opened_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"last_observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"provider_coverage":{"type":"array","items":{"type":"string","enum":["gemini","chatgpt","perplexity","google_ai_overview"]}},"impact_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"relevance_score":{"anyOf":[{"type":"number"},{"type":"null"}]},"top_competitors":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"citation_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["domain","citation_count"],"additionalProperties":{}}},"gap_kind":{"anyOf":[{"type":"string","enum":["no_existing_coverage","weak_existing_coverage","phrasing_only","cannibalization","external_visibility_issue"]},{"type":"null"}]},"recommended_content_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_enriched":{"type":"boolean"}},"required":["id","object","topic","observation_status","triage_status","opened_at","last_observed_at","provider_coverage","impact_score","relevance_score","top_competitors","gap_kind","recommended_content_type","is_enriched"],"additionalProperties":{}}},"summary":{"type":"object","properties":{"total_opportunities":{"type":"integer","minimum":0,"maximum":9007199254740991},"returned_opportunities":{"type":"integer","minimum":0,"maximum":9007199254740991},"scored_opportunities":{"type":"integer","minimum":0,"maximum":9007199254740991},"average_impact_score":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["total_opportunities","returned_opportunities","scored_opportunities","average_impact_score"],"additionalProperties":{}},"insight":{"type":"string"},"has_data":{"type":"boolean"}},"required":["as_of","gaps","summary","insight","has_data"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"ReportListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^rpt_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"report"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"file_size_bytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"regenerated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","object","website_id","file_size_bytes","created_at","regenerated_at"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}},"ReportResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^rpt_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"report"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"file_size_bytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"regenerated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","object","website_id","file_size_bytes","created_at","regenerated_at"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}}