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` | ## Authentication and safety - Set `NEXSCOPE_PROXY_BASE` and `NEXSCOPE_API_KEY`. Send the NexScope key as `Authorization: Bearer <key>`. - This skill requires `ecommerce-amazon-ads-api-access` and an authorized Amazon Ads connection. Resolve the intended profile before requesting a report; never accept Amazon access or refresh tokens. - Follow the online Ads packages' connection lifecycle: authorization state, OAuth exchange, encrypted credentials, token refresh, profile discovery, and provider request signing remain backend-owned. - The allowlisted v1 beta operations still use the dedicated NexScope `developerProxy`; do not substitute direct Amazon endp