API reference · Datasets

Get a dataset as CSV

The same dataset as CSV (for Google Sheets IMPORTDATA).

GET/api/v1/domains/{domain}/datasets/{name}.csv

This is the one endpoint that also takes the key as ?key=, because spreadsheets can't send headers. Anyone with the URL can read the data, so use a dedicated read key you can revoke.

Path parameters

domainstringRequired

The domain's host, like acme.example, or its ID. List them with List domains.

namestringRequired

The dataset: visibility, prompts, sources or answers.

visibilitypromptssourcesanswers

Query parameters

keystring

Your API key, for tools that can't send headers (Google Sheets IMPORTDATA). Use a dedicated read key.

rangestringdefault 30d

How far back to count: 7d, 30d, 90d or all. The previous period is the same length, just before.

7d30d90dall

surfacestring

Limit to one surface, written engine:lane, e.g. chatgpt_app:chat.

topicstring

Limit to prompts in one topic (exact name).

brandedstringdefault unbranded

Whether to count prompts that name your brand: unbranded (default), all or branded.

unbrandedallbranded

Returns

(body)text/csv

A header row, then one row per record. Values that start with =, +, - or @ are prefixed with '.

Every response includes the domain and the filters that were applied. Errors use the standard error object.