ATathenahq
Attributes

Cumulative Attribute Metrics

Changed on

Returns directional prevalence for each direction-neutral brand-perception attribute. The optional top-level positive request field selects positive or negative observations and defaults to true. total_responses is the denominator: sampled, successfully analyzed responses in the date range that mention the brand. An analyzed response with no supported attribute claim remains in the denominator. Attributes nobody mentioned are returned with response_count 0 rather than omitted.

post/api/v1/attributes/cumulative

Request

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

Request body

website_idstring uuid required
positiveboolean

Observation direction to select.

Example request

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

Response

Successful response with attribute metrics

Example response

{
  "data": [
    {
      "attribute_name": "Affordable"
    }
  ]
}

Changes

  • 2d1d86d5e067Revision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property

    • info

      added the new meta_ai enum value to the request property //

    • info

      added the new mistral enum value to the request property //