SE Ranking icon

SE Ranking

Interact with SE Ranking API for SEO data

Actions221

SE Visible → Get Aggregated Brand Metrics

AI-generated

Summary

Retrieves aggregated SE Visible brand metrics for a project over a date range, grouped by selected dimensions. Optional filters, sorting, pagination, and a comparison date range refine the results.

Inputs

  • Project Name or ID (required) — Select an SE Visible project or provide its ID.
  • Date From (required) — Start of the base period; serialized as YYYY-MM-DD.
  • Date To (required) — End of the base period; serialized as YYYY-MM-DD.
  • Dimensions (required) — Select 1–3 unique grouping dimensions: Brand, Prompt, or Topic. The last selected dimension is the pivot; with multiple dimensions, rows include pivot-based metric keys.
  • Metrics (required) — Select 1–5 metric columns, such as visibility score, share of voice, average position, sentiment, or mention counts.
  • Additional Fields — Optional comparison period (set both Compare Date From and Compare Date To), comma-separated country codes, model types, sentiments, topic IDs, and tracked brand IDs, plus sort field/order and row limit/offset.

Output shape

A list of aggregated metric rows.

Rows are grouped by the selected dimensions and contain the requested metrics; when using multiple dimensions they also include pivot-based metric keys. Results use limit/offset pagination. A comparison range can add comparison data when both dates are supplied.

Links

Discussion