ATathenahq
Metrics

Share of Voice Over Time

Changed on

Returns daily share of voice breakdown over the specified date range. Each entry contains the date and SOV percentages for your brand and competitors, plus each company's relative_mention_rate: its mentions as a percentage of that day's responses that mention at least one tracked brand.

post/api/v1/metrics/share-of-voice/time-series

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Request body

website_idstring uuid required

The ID of the website to query share of voice for

Example request

{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-01-31T23:59:59.999Z",
    "location_ids": [
      "123e4567-e89b-12d3-a456-426614174111"
    ]
  }
}

Response

Successful response with time series data

Example response

{
  "data": [
    {
      "date": "2024-06-15"
    }
  ]
}

Changes

  • 2d1d86d5e067Revision changes
    • breaking

      added subschema #2 to the request property allOf list

    • breaking

      the request property type changed from object to no type

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /