Skip to main content
POST
/
api
/
v1
/
content
/
prompts
Per-Content Prompt Citation Breakdown
curl --request POST \
  --url https://api.athenahq.ai/api/v1/content/prompts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "content_id": "11111111-2222-3333-4444-555555555555",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-01-31T23:59:59.999Z"
  }
}
'
{
  "content_id": "11111111-2222-3333-4444-555555555555",
  "content_url": "example.com/blog/crm-roundup",
  "content_normalized_url": "example.com/blog/crm-roundup",
  "prompts": [
    {
      "prompt_id": "22222222-3333-4444-5555-666666666666",
      "prompt": "what are the best CRMs for early-stage startups?",
      "citation_percent": 33.3,
      "citations": 5,
      "estimated_impressions": 1200
    }
  ]
}

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 drilling into the prompts that cite a single content item.

​
website_id
string<uuid>
required

The website that owns the content item. Must match the content's website.

Example:

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

​
content_id
string<uuid>
required

The content_id returned by POST /api/v1/content. The endpoint resolves this server-side to a normalized URL and queries every prompt whose responses cite it.

Example:

"11111111-2222-3333-4444-555555555555"

​
filters
object
required

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

​
mentioned
boolean

If true, only count responses that mention your brand. If false, only responses that don't. Omit to count every response.

Response

Successful response with the list of citing prompts.

​
content_id
string<uuid>
required

The content_id that was queried.

​
content_url
string | null
required

The content's display URL (may be null for legacy rows).

​
content_normalized_url
string | null
required

The content's normalized URL — the value joined against citation data. null for legacy rows that were never normalized; in that case prompts is always [].

​
prompts
object[]
required