Developer Docs
Integrate Omnisight AI into your workflows with our REST API.
Authentication
All API requests require a Bearer token or scoped API key in the Authorization header:
Authorization: Bearer <your-api-key> Content-Type: application/json
API keys are scoped per role (read-only, read-write, admin) and optionally per brand. Generate keys from Dashboard → Billing → API Keys.
Endpoints
/api/v1/brandsList all brands for the authenticated tenant
/api/v1/brands/:id/scoreGet the current Discovery Score breakdown
/api/v1/brands/:id/citationsList AI citation checks with model, query, and confidence
/api/v1/brands/:id/rankingsGet SERP rankings across tracked keywords
/api/v1/brands/:id/backlinksList backlink profile with DA, status, and anchor text
/api/v1/scans/triggerTrigger an on-demand discovery scan
/api/v1/approvalsList pending approval items from the Builder agent
/api/v1/approvals/:id/approveApprove a pending content deployment
/api/v1/reports/generateGenerate a PDF or HTML report for a brand
/api/v1/brands/:id/threatsList active brand threats (phishing, squatting, impersonation)
/api/v1/brands/:id/takedownsInitiate a DMCA takedown request
/api/v1/brands/:id/takedownsList takedown requests and their status
/api/v1/brands/:id/domainsList monitored domains and squatting alerts
/api/v1/brands/:id/protection/scoreGet the Brand Safety Score breakdown
/api/v1/brands/:id/provenanceVerify C2PA content credentials for a URL
/api/v1/brands/:id/influenceGet AI citation influence mapping data
/api/v1/brands/:id/entity-graphGet brand entity consistency graph and score
/api/v1/brands/:id/complianceGet compliance status (EU AI Act + GDPR)
/api/v1/brands/:id/evidence/:threatIdDownload evidence bundle for a threat
Rate Limits
Starter
Read: 60 req/min
Write: 10 req/min
Professional
Read: 200 req/min
Write: 50 req/min
Agency / Ultra
Read: 1,000 req/min
Write: 200 req/min