ecommerce.amazon-ads-sp-insights-reportlisted

# Amazon Ads Sponsored Products Insights Reports ## Scope Amazon Ads Reporting API v1 beta audience performance and search-term impression share/rank reports, including advertiser-account mapping, report creation, polling, and multipart CSV download. Requires an existing Amazon Ads connection through ecommerce.amazon-ads-api-access. It does not replace ordinary SP search-term performance, Sponsored Brands, Sponsored Display, or DSP reporting. Read [references/api.md](references/api.md) for the authoritative contract and `references/api.json` for the machine-readable operation catalog. ## Operations | Script | Nexscope route | |---|---| | `get_sp_audience_report.py` | `POST /api/v1/tools/research/amazonAds/developerProxy` | | `get_sp_search_impression_share.py` | `POST /api/v1/tools/research/amazonAds/developerProxy` | ## Response handling For the research HTTP response, require a numeric outer `code` equal to `0` before using `data`. Nonzero codes are platform failures; display outer `msg` without interpreting its wording as a retry instruction. Nexscope preserves upstream messages and translates Chinese to English; successful responses may have `msg: null`. HTTP 200 alone and nested business `code` / `status` do not replace the platform check. See `references/api.md` for response paths and task-specific states. Package scripts that unwrap the response keep the platform `code` and `msg` under `_nexscope`; their remaining fields are the business payload. `_nexscope.co