Skip to main content
POST
/
api
/
v1
/
content
List Tracked Content
curl --request POST \
  --url https://api.athenahq.ai/api/v1/content \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-01-31T23:59:59.999Z"
  },
  "sheet_id": "00000000-0000-4000-8000-000000000001",
  "page_size": 50
}
'
{
  "content": [
    {
      "content_id": "11111111-2222-3333-4444-555555555555",
      "title": "Best CRMs for Startups, Reviewed",
      "url": "example.com/blog/crm-roundup",
      "normalized_url": "example.com/blog/crm-roundup",
      "type": "external",
      "topic_name": "CRM Software",
      "sheet_id": "00000000-0000-4000-8000-000000000001",
      "sheet_name": "3rd-Party Placements",
      "citations": 42,
      "citation_percent": 12.5,
      "estimated_impressions": 18400,
      "total_responses": 336,
      "mark_as_done_time": "2024-01-15T00:00:00.000Z",
      "created_at": "2024-01-10T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page_num": 0,
    "page_size": 50,
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

API key for authentication. You can create one here.

Body

application/json

Request body for listing tracked content.

​
website_id
string<uuid>
required

The website to list tracked content for.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
filters
object
required

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

​
content_type
enum<string>

Restrict to a single content type. athena_created is a shortcut for the four Athena-generated subtypes (draft, snipe, optimize, slice). Omit to span every type.

Available options:
external,
imported,
athena_created,
draft,
snipe,
optimize,
slice
​
sheet_id
string<uuid>

Restrict to content on a single Content Hub tab. Use GET /api/v1/content/sheets to discover IDs. Omit to span every tab.

​
mentioned
boolean

If true, only count responses that mention your brand. If false, only count responses that do not. Omit to count every response.

​
page_num
integer
default:0

Zero-indexed page number.

Required range: x >= 0
​
page_size
integer
default:50

Number of items per page (1–100).

Required range: 1 <= x <= 100

Response

Successful response with the page of tracked content.

​
content
object[]
required
​
pagination
object
required

Pagination metadata. Uses page_size + 1 lookahead — has_more=true means the next page is non-empty. No total-count field, by design (avoids the extra COUNT(*) round-trip).