GET /2/searches

Returns the most popular searches. For each search, it also includes the average number of hits.

If you set the clickAnalytics query parameter to true, the response also includes:

If you set the revenueAnalytics query parameter to true, the response also includes:

There's a difference between 0% rates and null rates:

Servers

Query parameters

Name Type Required Description
revenueAnalytics Boolean No

Whether to include metrics related to revenue events in the response.

Default value: false

endDate String No

End date of the period to analyze, in YYYY-MM-DD format.

limit Integer No

Number of items to return.

Default value: 10

direction String No

Sorting direction of the results: ascending or descending.

Valid values:

  • "desc"
  • "asc"

Default value: "asc"

orderBy String No

Attribute by which to order the response items.

If the clickAnalytics parameter is false, only searchCount is available.

Valid values:

  • "clickThroughRate"
  • "searchCount"
  • "conversionRate"
  • "averageClickPosition"

Default value: "searchCount"

clickAnalytics Boolean No

Whether to include metrics related to click and conversion events in the response.

Default value: false

tags String No

Tags by which to segment the analytics.

You can combine multiple tags with OR and AND. Tags must be URL-encoded. For more information, see Segment your analytics data.

startDate String No

Start date of the period to analyze, in YYYY-MM-DD format.

index String Yes

Index name.

offset Integer No

Position of the first item to return.

Default value: 0

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.