extension

Track Extension Events

Track extension events (batch endpoint).

Accepts up to 50 events per request for efficient bulk processing. Implements idempotency using event_id to prevent duplicates.

Request Body:

{
  "events": [
    {
      "event_id": "uuid",
      "user_id": "anon_user123",
      "session_id": "session_abc",
      "timestamp": "2025-10-29T10:30:00Z",
      "event_type": "brand_viewed",
      "ai_platform": "chatgpt",
      "brand_name": "HubSpot",
      ...
    }
  ]
}

Response:

{
  "status": "success",
  "events_received": 2,
  "events_processed": 2,
  "events_failed": 0
}

Features:

  • Idempotency: Duplicate event_id will be skipped
  • Session tracking: Creates/updates session records
  • Batch processing: Up to 50 events per request
post/api/v1/extension/track

Request

  • Base URL: https://geo.sig.ai (the document declares no server; this is the origin it was published from)
  • URL: https://geo.sig.ai/api/v1/extension/track
  • Auth: none declared

Request body

Example request

{
  "events": [
    {
      "ai_platform": "chatgpt",
      "brand_category": "crm",
      "brand_name": "HubSpot",
      "clicked_through": false,
      "event_id": "550e8400-e29b-41d4-a716-446655440000",
      "event_type": "brand_viewed",
      "extension_version": "1.0.0",
      "mention_rank": 1,
      "recommendation_strength": "explicit",
      "reputation_score_viewed": true,
      "session_id": "session_xyz789",
      "time_viewed_seconds": 12,
      "timestamp": "2025-10-29T10:30:00Z",
      "user_id": "anon_abc123",
      "user_query": "best crm for small business"
    }
  ]
}

Response

Successful Response

status'success' | 'partial_success' | 'error' required
events_receivedinteger required

Number of events in request

events_processedinteger required

Number of events successfully processed

events_failedinteger required

Number of events that failed processing

errorsstring[] nullable

Error messages for failed events

Example response

{
  "events_failed": 0,
  "events_processed": 2,
  "events_received": 2,
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.