Per-Content Prompt Citation Breakdown

For a single tracked content item, returns every prompt whose AI responses cite the URL — with citations, citation %, and estimated impressions for the date range.

Use this to drill into a specific URL after POST /api/v1/content. Works for both 1st-party (topic-attached) and 3rd-party / Reddit content without topic assignment.

When the URL exists but has no normalized form (legacy unnormalized rows) the response is a successful 200 with prompts: []. Unknown content_id returns 404.

Request body

website_idstring uuid required

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

content_idstring 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.

mentionedboolean

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

Example request

{
  "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"
  }
}

Response

Successful response with the list of citing prompts.

content_idstring uuid required

The content_id that was queried.

content_urlstring nullable required

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

content_normalized_urlstring nullable 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 [].

Example response

{
  "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
    }
  ]
}