Domains

Every Console check runs against a Console domain. Create one with {"domain": "yourbrand.com"} and pass its id as domain_id when you submit a check. A domain you track in the dashboard cannot be used as a Console domain_id; register it here first.

Each domain record carries domain, status, created_at, and the headline metrics from its most recent completed check: latest_visibility_score, latest_brand_coverage_pct (Brand Coverage), latest_market_position (Market Position), last_scan_at, and scan_count. The list returns your 50 most recently created domains.

Creating and deleting a domain require an Idempotency-Key header when you authenticate with an API key. Deleting a domain removes it from the list; its checks stay in the scan list.

curl -X GET "https://api.surfacedby.com/api/v1/console/domains?cursor=string&page_size=50" \
  -H "X-API-Key: string"

null

curl -X POST "https://api.surfacedby.com/api/v1/console/domains" \
  -H "X-API-Key: string" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  -d '{}'

null

curl -X GET "https://api.surfacedby.com/api/v1/console/domains/string" \
  -H "X-API-Key: string"

null

curl -X DELETE "https://api.surfacedby.com/api/v1/console/domains/string" \
  -H "X-API-Key: string" \
  -H "Idempotency-Key: string"

null