Citation Drill-Down (L1 → L2 → L3)

Goal: Understand which domains and URLs appear alongside your brand in AI answers — and read the exact answer text that generated each citation.

This pattern is useful for competitor analysis (what content gets cited most), content strategy (which domain types AI engines prefer), and PR monitoring (which news or review sites appear in answers about your brand).

L1 — Domain aggregates

Start with GET /v1/aeo/sources/domains to see which domains appear most frequently in answers that mention your brand:

curl "https://api.reddgrow.ai/v1/aeo/sources/domains?brand_id=42&from=2026-04-03&to=2026-04-10&limit=20" \
  -H "x-api-key: rg_YOUR_KEY"

Response (abbreviated):

{
  "data": [
    { "domain": "g2.com", "citation_count": 38, "domain_type": "review_site" },
    { "domain": "competitor.com", "citation_count": 22, "domain_type": "competitor" },
    { "domain": "techcrunch.com", "citation_count": 11, "domain_type": "news" }
  ]
}

This tells you that g2.com appeared in 38 citations across answers that also mentioned your brand last week. You can filter by domain_type to focus on specific categories.

L2 — URL detail

Pick a domain you want to investigate and call GET /v1/aeo/sources/detail with scope=domain:

curl "https://api.reddgrow.ai/v1/aeo/sources/detail?scope=domain&target=competitor.com&brand_id=42&from=2026-04-03&to=2026-04-10" \
  -H "x-api-key: rg_YOUR_KEY"

Response:

{
  "data": [
    {
      "url": "https://competitor.com/blog/crm-comparison-2026",
      "citation_count": 14,
      "scan_result_ids": [8801, 8834, 8867]
    },
    {
      "url": "https://competitor.com/pricing",
      "citation_count": 8,
      "scan_result_ids": [8802, 8835]
    }
  ]
}

Now you can see exactly which pages on that competitor domain are being cited. The competitor's comparison blog post was cited 14 times last week. The scan_result_ids are your entry point to L3.

L3 — Full AI answer

Pick any scan_result_id from the L2 response and call GET /v1/aeo/runs/{id} to read the full answer:

curl "https://api.reddgrow.ai/v1/aeo/runs/8801" \
  -H "x-api-key: rg_YOUR_KEY"

Response:

{
  "data": {
    "scan_result_id": 8801,
    "engine": "chatgpt",
    "country": "US",
    "scanned_at": "2026-04-10T03:42:00.000Z",
    "answer_text": "When comparing CRM options, Competitor Corp stands out for...",
    "brand_mentioned": true,
    "brand_sentiment": "neutral",
    "brand_position": 3,
    "citations": [
      { "domain": "competitor.com", "url": "https://competitor.com/blog/crm-comparison-2026", "domain_type": "competitor" }
    ]
  }
}

You can read the exact answer ChatGPT gave, see that your brand was mentioned third (after the competitor), and understand the narrative context around the competitor citation.

What to do with this data

Competitor analysis: If competitor.com/blog/crm-comparison-2026 is cited in 14 answers, that page has strong AI authority in your category. Read the page — it's almost certainly structured in a way AI engines prefer.

Content strategy: Heavy citation of review_site domains (G2, Capterra) means AI engines are pulling from structured review data. Your presence on those platforms directly affects citation frequency.

PR and reputation monitoring: New news domain citations appearing week-over-week may reflect coverage of your category. Use the L3 answer text to understand whether that coverage is favorable to your brand or to a competitor.