Skip to main content
GET
List Ask Snowy chats
Chats belong to a user, not to a brand, so this endpoint isn’t available with an API key (brand or organization) and returns 403 with code API_KEY_ROUTE_NOT_ALLOWED. It works from a signed-in session or the MCP server.
List the saved Ask Snowy chats of the authenticated user, pinned chats first and then the most recently active. Archived chats, empty chats, and chats tied to a single report are left out. search matches the chat title before paging, so total counts the matches. No teamId is needed: one chat can span several of the user’s brands. Returns { "threads": [...], "page", "pageSize", "total", "totalPages" }. Pass a thread’s id to Read an Ask Snowy Chat to get its messages. This endpoint is read-only. Sending a message to Snowy, and renaming, pinning or deleting a chat, are done in the dashboard.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

page
integer

1-based page number.

pageSize
integer

Chats per page, capped at 100.

Case-insensitive text matched against the chat title. Applied before paging.

Response

Default Response

threads
object[]
required
page
integer
required
pageSize
integer
required
total
integer
required
totalPages
integer
required