Signal360
Request demo
API v1

Build on Signal360

REST API for opportunities, outcomes, citation sources, agent analytics, and channel metrics. API-key auth with scoped permissions and per-key rate limiting.

Interactive Swagger DocsOpenAPI 3.1 Spec (JSON)

Authentication

All v1 endpoints require an API key passed in the X-API-Key header. Generate one in your Signal360 dashboard under Workspace → API Keys.

curl https://app.signal360.ai/api/v1/opportunities \
  -H "X-API-Key: ${SIGNAL360_API_KEY}" \
  -G --data-urlencode "brandId=42" --data-urlencode "severity=high,critical"

Bearer token (OAuth 2.0) is also supported on every endpoint via Authorization: Bearer <token>.

Rate Limits

Per-API-key rate limits depend on your tier. Every response includesX-RateLimit-Limit,X-RateLimit-Remaining, andX-RateLimit-Reset. On 429 we add Retry-After.

TierRequests / minuteRequests / dayBurst
free601,000+10
standard30010,000+50
professional60050,000+100
enterprise1,200200,000+200

Endpoints

Every endpoint requires a scope (the second column). Generate API keys with only the scopes you need — least privilege wins on enterprise security review.

Opportunities

Canonical issue queue — every opportunity Signal360 detects with state, owner, SLA, verification, and outcome attribution.

GET/api/v1/opportunities

List opportunities with filters

read:opportunities
GET/api/v1/opportunities/{id}

Get one opportunity

read:opportunities
POST/api/v1/opportunities/{id}/transition

Apply a state transition

write:opportunities
GET/api/v1/opportunities/_summary/kpis

Aggregate KPIs

read:opportunities

Outcomes

Verified business impact of resolved opportunities — citation rate, AI traffic, conversions, revenue.

GET/api/v1/outcomes/_summary

Outcome rows for the window

read:outcomes

Citation Sources

Domains driving AI citations about your brand. Includes absence detection — domains where competitors are cited but you aren't.

GET/api/v1/citation-sources/top

Top domains by consensus score

read:citation-sources
GET/api/v1/citation-sources/absences

High-influence absence domains

read:citation-sources

Agent Analytics

AI bot crawl activity from CDN log ingestion or Node middleware.

GET/api/v1/agent-analytics/bot-visits

Per-request bot visit log

read:agent-analytics

Channels

Connected analytics channels and their metrics.

GET/api/v1/channels

List connected channels

read:metrics
GET/api/v1/metrics

Channel performance metrics

read:metrics

Webhooks

Subscribe to opportunity / outcome / verification events as they happen.

GET/api/v1/webhooks

List webhook subscriptions

read:webhooks
POST/api/v1/webhooks

Create a subscription

write:webhooks

Webhooks

Subscribe to opportunity.opened,opportunity.resolved,verification.completed, andoutcome.finalizedevents. Payloads are HMAC-signed with your webhook secret. See the webhooks guide for the canonical event schema.

Need higher limits or a custom integration?

Enterprise customers get 1,200 req/min, custom DPA, and a dedicated solutions engineer.

Talk to Sales