My Account

New: Search Insights reports in On-request Reports API

Date: June 23, 2026

The On-request Reports API reference now supports two Search Insights report types: Request a search insights performance report and Request a search insights SQR report. Sellers and solution providers can now request Search Insights data through the existing on-request report workflow, check request status, and download the generated CSV when the report is ready.

What changed

  • Report types
    • Added SEARCH_INSIGHTS_PERF_REPORT for item-level search performance insights.
    • Added SEARCH_INSIGHTS_SQR_REPORT for query-level search insights.
  • Search Insights Performance report
    • Provides item-level metrics such as impressions rank, clicks rank, add-to-cart rank, sales rank, transactability score, buy box win percentage, and keyword recommendations.
    • Supports optional filters for SKU, PRODUCT TYPE, RECOMMENDATIONS EXISTS, and SALES RANK EXISTS.
    • Data for the previous week is available Wednesday by 7 AM PST.
  • Search Insights SQR report
    • Provides query-level metrics such as query score, frequency rank, impressions share, clicks share, add-to-cart share, and top clicked product URL.
    • Supports monthly and weekly report formats through the FREQUENCY INTERVAL filter. Allowed values: MONTHLY, WEEKLY.
    • Supports filters for YEAR, MONTH, WEEK, SKU, HIGHLY CLICKED, HIGHLY ATC, and TRENDING.
    • Weekly data for the previous week is available Tuesday by 8 PM PST. Monthly data for the previous month is available on the second day of the current month by 8 PM PST.
  • Report workflow
    • Use POST /v3/reports/reportRequests with reportType and reportVersion=v1 to request either report.
    • Use GET /v3/reports/reportRequests or GET /v3/reports/reportRequests/{requestId} to check report status.
    • When requestStatus is READY, use the downloadUrl or download report endpoint to retrieve the CSV file.

Scope

These updates apply to the On-request Reports API reference and the report request workflow for Search Insights report types, including create report request, get report request status, get a single report request, and download report.

Why it matters

These report types let sellers access search performance data through the On-request Reports API instead of relying only on dashboard workflows. Sellers can use item-level and query-level insights to identify underperforming SKUs, improve product discoverability, evaluate search engagement, and prioritize listing optimization work based on customer search behavior.

Next steps

  • Use SEARCH_INSIGHTS_PERF_REPORT and accompanying guide to request item-level search performance data.
  • Use SEARCH_INSIGHTS_SQR_REPORT and accompanying guide to request search query performance data.
  • Set reportVersion to v1 for both report types.
  • Add the required filters for SQR reports: FREQUENCY INTERVAL, YEAR, and either MONTH or WEEK.
  • Check requestStatus until it returns READY, then download the report CSV.
  • For more information and usage examples, refer to the On-request Reports API reference.