Skip to main content
GET
List search query groups

Authorizations

Authorization
string
header
required

Personal API key created in the dashboard under Settings > API keys.

Query Parameters

page
integer
default:1
Required range: x >= 1
page_size
integer
default:10
Required range: 1 <= x <= 50
sort
enum<string>
default:frequency
Available options:
frequency,
queries,
recent
group_by
enum<string>
default:topic

Cluster by topic or by prompt

Available options:
topic,
prompt
queries_limit
integer | null

Max queries sent per cluster (counts still cover all). Page the rest with /search-queries/grouped/queries.

Required range: 0 <= x <= 100
platforms
enum<string>[] | null

Filter by AI platforms (repeatable)

Available options:
ChatGPT,
Gemini,
AI Overviews,
Google AI Mode,
Perplexity,
Mistral,
Claude,
DeepSeek,
Grok,
Copilot,
Bing AI Mode
q
string | null

Filter by query text (substring)

topic_ids
integer[] | null

Filter to topics (repeatable)

tag_ids[]
integer[] | null

Filter by prompt tags. Several values match any of them.

brand_scopes[]
enum<string>[] | null

Filter by brand scope (branded or non_branded).

Available options:
branded,
non_branded
intents[]
enum<string>[] | null

Filter by prompt intent.

Available options:
informational,
comparative,
transactional,
navigational
localizations[]
string[] | null

Filter by market (prompt localizations).

time_range
enum<string> | null

Preset window (7d/30d/1y/all)

Available options:
all_time,
1y,
1m,
1w,
1d
date_from
string<date> | null

Custom start (inclusive, YYYY-MM-DD). Overrides time_range.

date_to
string<date> | null

Custom end (inclusive, YYYY-MM-DD). Overrides time_range.

website_id
integer
required

Target website id

Response

Successful Response

items
SearchQueryTopicGroup · object[]
required
total
integer
required
page
integer
required
page_size
integer
required
total_pages
integer
required
total_queries
integer
required
top_platform
enum<string> | null
Available options:
ChatGPT,
Gemini,
AI Overviews,
Google AI Mode,
Perplexity,
Mistral,
Claude,
DeepSeek,
Grok,
Copilot,
Bing AI Mode
top_platform_share
number | null