get
https://{yourinstance}.makaira.io/search-term/download
Downloads search term data as a CSV file.
Downloads search term data as a CSV file. Supports the same filters as the List search terms endpoint but returns the full result set in CSV format rather than paginated JSON.
Request
GET /search-term/download
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string | 1d | Time range to look back (e.g. 1d, 7d, 30d). |
language | string | — | Filter by shop language (e.g. de, en). |
_start | integer | 0 | Starting offset within the result set. |
_count | integer | 10000 | Maximum number of rows to include in the download. |
includeHeader | boolean | true | When true, the first row of the CSV contains column headers. |
includeBotTraffic | boolean | false | When true, search terms from detected bot traffic are included. |
hits | boolean | true | When true, returns search terms with results. When false, returns zero-result search terms. |
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> |
Response
Returns a CSV file with Content-Type: text/csv and a Content-Disposition: attachment; filename="result.csv" header.
CSV Columns
| Column | Description |
|---|---|
Search term | The search term entered by the shopper. |
Number of hits | Number of times this search term was recorded within the requested time range. |
Example Response
Search term,Number of hits
running shoes,142
winter jacket,87
blue jeans,54