Sign in

v84

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0985248447.1 KB
Reports
Reports

Stream Web Search Results

post/v1/reports/web-search-results/stream

Request body

date_interval'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'relative_week'

Date interval for the report. (only used with date dimension)

dimensionsstring[]

Dimensions to group the report by.

metricsstring[] required

Metrics to include. search_share is the per-prompt occurrence rate.

order_byobject 
Custom ordering of the report results.

The order is a record of key-value pairs where:
- `key` is the field to order by, which can be a metric or dimension
- `value` is the direction of the order, either `asc` for ascending or `desc` for descending.

When not specified, the default order is the first metric in the query descending.
category_idstring uuid required
start_datestring date-time required

Start date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full ISO timestamp.

end_datestring date-time required

End date for the report. Accepts formats: YYYY-MM-DD, YYYY-MM-DD HH:MM, or full ISO timestamp.

Example request

{
  "order_by": {
    "date": "asc"
  }
}

Response

Server-sent events stream. Emits a summary event first, then one row event per streamed row.