Attribute Time Series

curl --request POST \
  --url https://api.athenahq.ai/api/v1/attributes/time-series \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-12-31T23:59:59.999Z",
    "models": [
      "chatgpt",
      "perplexity"
    ],
    "prompt_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "competitor_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "location_ids": [
      "123e4567-e89b-12d3-a456-426614174111"
    ]
  }
}
'

import requests

url = "https://api.athenahq.ai/api/v1/attributes/time-series"

payload = {
    "website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filters": {
        "start_date": "2024-01-01T00:00:00.000Z",
        "end_date": "2024-12-31T23:59:59.999Z",
        "models": ["chatgpt", "perplexity"],
        "prompt_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
        "competitor_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
        "location_ids": ["123e4567-e89b-12d3-a456-426614174111"]
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    website_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    filters: {
      start_date: '2024-01-01T00:00:00.000Z',
      end_date: '2024-12-31T23:59:59.999Z',
      models: ['chatgpt', 'perplexity'],
      prompt_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
      competitor_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
      location_ids: ['123e4567-e89b-12d3-a456-426614174111']
    }
  })
};

fetch('https://api.athenahq.ai/api/v1/attributes/time-series', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.athenahq.ai/api/v1/attributes/time-series",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'website_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'filters' => [
        'start_date' => '2024-01-01T00:00:00.000Z',
        'end_date' => '2024-12-31T23:59:59.999Z',
        'models' => [
                'chatgpt',
                'perplexity'
        ],
        'prompt_ids' => [
                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ],
        'competitor_ids' => [
                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ],
        'location_ids' => [
                '123e4567-e89b-12d3-a456-426614174111'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.athenahq.ai/api/v1/attributes/time-series"

	payload := strings.NewReader("{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/attributes/time-series")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.athenahq.ai/api/v1/attributes/time-series")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "date": "2026-07-15",
      "brand_count": 1,
      "brand_total": 2,
      "brand_percentage": 50,
      "competitor_count": 0,
      "competitor_total": 0,
      "competitor_percentage": 0
    }
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

Attributes

Attribute Time Series

Returns the daily trend for ONE attribute, brand and competitors side by side. Requires an attribute_id — call GET /api/v1/attributes first to discover ids. Days with no data are returned as zeros, so the series is gap-free and chartable. Denominators are per-side, not the day’s whole response set: brand_percentage divides by that day’s responses that mention the brand (and had attribute extraction run), and competitor_percentage by responses that mention the tracked competitors. brand_total and competitor_total return those denominators explicitly. Competitor figures aggregate all tracked competitors unless filters.competitor_ids narrows them.

POST

api

attributes

time-series

Attribute Time Series

curl --request POST \
  --url https://api.athenahq.ai/api/v1/attributes/time-series \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-12-31T23:59:59.999Z",
    "models": [
      "chatgpt",
      "perplexity"
    ],
    "prompt_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "competitor_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "location_ids": [
      "123e4567-e89b-12d3-a456-426614174111"
    ]
  }
}
'

import requests

url = "https://api.athenahq.ai/api/v1/attributes/time-series"

payload = {
    "website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filters": {
        "start_date": "2024-01-01T00:00:00.000Z",
        "end_date": "2024-12-31T23:59:59.999Z",
        "models": ["chatgpt", "perplexity"],
        "prompt_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
        "competitor_ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
        "location_ids": ["123e4567-e89b-12d3-a456-426614174111"]
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    website_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    attribute_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    filters: {
      start_date: '2024-01-01T00:00:00.000Z',
      end_date: '2024-12-31T23:59:59.999Z',
      models: ['chatgpt', 'perplexity'],
      prompt_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
      competitor_ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
      location_ids: ['123e4567-e89b-12d3-a456-426614174111']
    }
  })
};

fetch('https://api.athenahq.ai/api/v1/attributes/time-series', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.athenahq.ai/api/v1/attributes/time-series",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'website_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'attribute_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'filters' => [
        'start_date' => '2024-01-01T00:00:00.000Z',
        'end_date' => '2024-12-31T23:59:59.999Z',
        'models' => [
                'chatgpt',
                'perplexity'
        ],
        'prompt_ids' => [
                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ],
        'competitor_ids' => [
                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ],
        'location_ids' => [
                '123e4567-e89b-12d3-a456-426614174111'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.athenahq.ai/api/v1/attributes/time-series"

	payload := strings.NewReader("{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/attributes/time-series")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.athenahq.ai/api/v1/attributes/time-series")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"attribute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"filters\": {\n    \"start_date\": \"2024-01-01T00:00:00.000Z\",\n    \"end_date\": \"2024-12-31T23:59:59.999Z\",\n    \"models\": [\n      \"chatgpt\",\n      \"perplexity\"\n    ],\n    \"prompt_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"competitor_ids\": [\n      \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    ],\n    \"location_ids\": [\n      \"123e4567-e89b-12d3-a456-426614174111\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "date": "2026-07-15",
      "brand_count": 1,
      "brand_total": 2,
      "brand_percentage": 50,
      "competitor_count": 0,
      "competitor_total": 0,
      "competitor_percentage": 0
    }
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

{
  "error": "Unauthorized"
}

Authorizations

x-api-key

string

header

required

API key for authentication. You can create one here.

Body

application/json

website_id

string<uuid>

required

attribute_id

string<uuid>

required

The attribute to chart. Obtain ids from GET /api/v1/attributes.

filters

object

required

Filters for querying responses and metrics. Pass location filters in the JSON body as filters.location_ids.

Show child attributes

Response

Successful response with the daily series

data

object[]

required

Show child attributes

Competitor Attribute Metrics Cumulative Share of Voice

Overview

Integrations

Basics

Content Hub

Knowledge Base

Pitch Workspace

Sources

Attributes

Metrics

Billing

Groups

Team Management

AI Access

AI Search Value

Attribute Time Series

Authorizations

Body

Response