Sign in

v84

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

Query Web Search Results

Get web search results for a given category.

post/v1/reports/web-search-results

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

Successful Response

Example response

{
  "data": [
    {
      "dimensions": [
        "example.com",
        "/some/path",
        "2023-10-01"
      ],
      "metrics": [
        10,
        0.05
      ]
    }
  ],
  "info": {
    "query": {
      "date_interval": "day",
      "dimensions": [
        "hostname",
        "path",
        "date"
      ],
      "filters": [
        {
          "field": "hostname",
          "operator": "is",
          "value": "example.com"
        }
      ],
      "metrics": [
        "count",
        "search_share"
      ]
    },
    "total_rows": 200
  }
}