Sentiment Theme Sources

The URLs AI answers cited when raising sentiment themes about a tracked domain.

curl --request GET \
  --url 'https://api.aiclicks.io/api/v1/sentiment/theme-sources?domain_id=8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3&days=30' \
  --header 'Authorization: Bearer ak_live_xxx'

import httpx, os

resp = httpx.get(
    "https://api.aiclicks.io/api/v1/sentiment/theme-sources",
    params={
        "domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3",
        "days": 30,
    },
    headers={"Authorization": f"Bearer {os.environ['AICLICKS_API_KEY']}"},
)
resp.raise_for_status()
for row in resp.json()["data"]["items"][:10]:
    print(f"{row['frequency']:>3}  {row['domain']:<24}  {', '.join(row['theme_names'])}")

const url = new URL("https://api.aiclicks.io/api/v1/sentiment/theme-sources");
url.searchParams.set("domain_id", "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3");
url.searchParams.set("days", "30");

const resp = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.AICLICKS_API_KEY}` },
});
const { data } = await resp.json();
for (const row of data.items.slice(0, 10)) {
  console.log(`${row.frequency}  ${row.domain}  ${row.theme_names.join(", ")}`);
}

{
  "data": {
    "items": [
      {
        "url": "https://g2.com/products/aiclicks/reviews",
        "domain": "g2.com",
        "frequency": 12,
        "theme_names": ["Strong, favorable reviews", "Reliability"],
        "models": ["ChatGPT", "Perplexity"]
      },
      {
        "url": "https://reddit.com/r/SEO/comments/ai-visibility-tools",
        "domain": "reddit.com",
        "frequency": 7,
        "theme_names": ["Limited functionality and maturity gaps"],
        "models": ["ChatGPT"]
      }
    ]
  },
  "domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3",
  "days": 30,
  "model": "all",
  "generated_at": "2026-06-17T10:00:11.218Z"
}

The sources shaping how LLMs talk about your brand. For every sentiment theme in the window, this endpoint walks the citations in the underlying AI answers and rolls them up by URL — so you can see which pages are driving the narrative, positive or negative. Sorted by citation frequency descending.

domain_id is a required query parameter. Use GET /api/v1/domains to discover which domains the calling key can access.

Sentiment is a paid feature. The endpoint returns 403 unless the domain's team is on a Pro, Business, or Enterprise plan — in addition to the usual API-access requirement.

Authorizations

header

Authorizationstring

Required

Your API key formatted as Bearer ak_live_<your-key>. Create one in the dashboard under Settings → Developers.

header

X-Request-Idstring

Optional UUID for log correlation. If omitted, we generate one and echo it back in the response.

Query parameters

query

domain_idstring

Required

UUID of the domain. Find domains via GET /api/v1/domains. Omitting this returns 400.

query

daysinteger

Look-back window in days, 1–365. Defaults to 30. Counted as an exact window (today - days + 1), not snapped to buckets.

query

modelstring

Restrict to sources cited on a single AI channel by generic name — ChatGPT, Perplexity, Gemini, AI Overviews, Claude, Grok, Microsoft Copilot. Defaults to all. Raw model identifiers are also accepted. See Models.

Response

dataobject

Required

The list payload.

data.itemsarray

Required

One row per cited URL across all sentiment themes in the window, sorted by frequency descending. Tracking parameters (utm_*, fbclid, gclid, …) are stripped from URLs before grouping.

domain_idstring

Required

Echo of the requested domain.

daysinteger

Required

Echo of the requested window.

modelstring

Required

Echo of the requested model filter (all when unset).

generated_atstring

Required

ISO-8601 timestamp of when the server produced (or cached) this response.

Response headers

Header	Description
`X-Cache`	`HIT` or `MISS`. Indicates whether the response came from cache.
`X-Request-Id`	Unique request id. Echoes incoming if you set one.
`X-RateLimit-Limit`	Max requests per minute for this key.
`X-RateLimit-Remaining`	Requests remaining in current minute.
`X-RateLimit-Reset`	Unix epoch seconds when the window resets.

Caching

Cached for 1 hour per (domain_id, days, model). Newly completed analyses appear after the TTL expires.

How sources are rolled up

For every response attached to a sentiment theme in the window:

Extract the cited URLs from the answer's citation links.
Strip tracking parameters, then group by cleaned URL.
Per URL, count the citing responses (frequency), union the themes it appears under (theme_names), and union the AI channels that cited it (models, mapped to generic names).
Sort by frequency descending.

Errors

400 Bad Requesterror

domain_id query parameter missing. Body points you at /api/v1/domains.

401 Unauthorizederror

Missing, malformed, or revoked API key.

403 Forbiddenerror

Team's developer_access flag is off, the domain belongs to a team your API key is not scoped to, your allowed_domains allowlist excludes it, or the team's plan doesn't include sentiment (requires Pro, Business, or Enterprise).

404 Not Founderror

domain_id is malformed, does not exist, or your user is not a member of its team.

429 Too Many Requestserror

Rate limit exceeded. Inspect the Retry-After header for how long to wait.

Empty result

If no sentiment themes cited any sources in the window, the response is a successful 200 with an empty list:

{
  "data": { "items": [] },
  "domain_id": "8f1d3c0a-2f9b-4c11-9b80-7a82e1f0c3f3",
  "days": 30,
  "model": "all",
  "generated_at": "2026-06-17T10:00:11.218Z"
}

Was this page helpful?