Record social sightings (internal listening use)

Social listening

post /v1/listening/sightings

Internal, non-customer-supported endpoint that records a bounded organization-scoped batch of post or profile sightings. Each item runs in its own transaction and returns ok, invalid, or failed.

Authentication

ApiKey bearer token

Send the current Benchmark API key only in the Authorization header.

Request body

sightings array<SightingItem> required

Responses

200
Per-item sighting ingest results.
400
The request failed validation.
401
The bearer credential is missing or invalid.
403
The key cannot perform this operation.
429
The Cloudflare rate limiter rejected the request.
500
The request failed without exposing internal diagnostics.
503
A required service is unavailable.

 Request cURL  curl --request POST \
  --url "${BENCHMARK_API_BASE_URL}/v1/listening/sightings" \
  --header "Authorization: Bearer ${BENCHMARK_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"sightings":[{"authorHandle":"mkbhd","comments":120,"followerCount":null,"isAdSignal":false,"likes":12500,"mediaKind":"video","platform":"youtube","platformId":"dQw4w9WgXcQ","seenAt":"2026-09-06T12:00:00.000Z","surface":"home","url":"https://www.youtube.com/shorts/dQw4w9WgXcQ","views":250000}]}' 

 Response 200  {
  "results": [
    {
      "entityId": "50000000-0000-4000-8000-000000000005",
      "index": 0,
      "reason": "stage-1-candidate",
      "status": "ok"
    }
  ]
} 