Introducing v2 search keyword and zero search results reporting APIs

Description

We're adding v2 versions of two Marketplace search reports: top search keywords and zero search results keywords.

Beginning June 12, 2026, non-essential cookies and tracking technologies were disabled by default for Marketplace users from regulated regions, and users there must now opt in to cookies before analytics data is collected. Because these reports were built from browser analytics, reported search volumes dropped for affected traffic.

The v2 reports count searches recorded by Marketplace search itself, so they include every search regardless of a user’s cookie choices.

What's changing

Two new endpoints are available, each with a matching /export variant:

GET /rest/3/reporting/developer-space/{developerId}/search-keywords-v2/source/{sourceKey} GET /rest/3/reporting/developer-space/{developerId}/zero-search-results-keywords-v2/source/{sourceKey}

Please note that the updated counts are only available post 25th Sept 2026. Earlier dates would still have data only for users who consented for tracking cookies.

What's not changing

• The existing endpoints are unchanged and remain available for now but will be removed soon.
• Query parameters, authentication, and the response format are identical between the two versions, so moving to v2 only requires changing search-keywords to search-keywords-v2, or zero-search-results-keywords to zero-search-results-keywords-v2, in the path.
• Source coverage is also unchanged. The search keywords report supports marketplace and embedded-marketplace, and the zero search results report supports marketplace only.

What you need to know

• Review your reporting. If you track search counts over time, expect a step change when you switch.
• Historical data is limited. v2 data is available from 25th Sept 2026. Earlier dates would still have data only for users who consented for tracking cookies.