Analytics

Returns the share of analyzed responses that mention each tracked brand, bucketed by interval. You may scope the chart to a single brand by passing brand_id, or to every brand in a segment by passing segments. Otherwise, the result is capped to the top top_n brands by mention count, which defaults to 20 and may not exceed 50.

Returns the average sentiment score, on a 0-100 scale, of each tracked brand's mentions, bucketed by interval. You may scope the chart to a single brand by passing brand_id, or to every brand in a segment by passing segments. Otherwise, the result is capped to the top top_n brands by mention count. A per-bucket value is null when the brand had no mentions in that bucket.

Returns each tracked brand's mentions as a share of the total mentions across the displayed brand set, per bucket. The denominator always matches the displayed brand set, which means stacked bars sum to 100%. You may scope the chart with brand_id or segments, or rely on top_n to cap the series count.

For each top source, returns the percentage of analyzed responses in each bucket that cited that source. The result is capped to the top top_n sources by citation count.

For each top URL, returns the percentage of analyzed responses in each bucket that cited that exact URL. The result is capped to the top top_n URLs.

Returns per-brand aggregates across the window: visibility, share of voice, average sentiment (0-100, or null when there are no mentions), and average position. Every tracked brand in scope is returned, including those with no mentions in the window. The response is paginated.

Returns per-monitor aggregates across the filter window, scoped to a single brand. The response is paginated.

Returns per-prompt aggregates across the filter window, scoped to a single brand. Each row also lists the distinct tracked brands that were mentioned in the prompt's responses during the window. The response is paginated.

Returns per-platform aggregates across the filter window, scoped to a single brand. Every platform present in the filtered response set is returned; the result is not paginated.

Returns per-source aggregates: the percentage of analyzed responses in the window that cited each domain, together with the average number of citations from that domain per analyzed response. The response is paginated. This endpoint may not be scoped by segment.

Returns per-URL aggregates: the percentage of analyzed responses in the window that cited each URL, together with the average number of citations to it per analyzed response. The response is paginated. This endpoint may not be scoped by segment.

Returns per-prompt aggregates scoped to a single source URL: how many distinct analyzed responses on each prompt cited the URL during the window, and when the URL was most recently cited. The response is paginated. This endpoint may not be scoped by segment.

Returns a citation breakdown across the source-type classifications, such as blog, news, or forum. The result is unpaginated and contains one row per enum value. This endpoint may not be scoped by segment.

Returns a citation breakdown across the URL-type classifications, such as article, documentation, or product_page. The result is unpaginated and contains one row per enum value. This endpoint may not be scoped by segment.