ads_query_ad
Query (read) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
readAmazon Adsads.v1
In the v1 model an "ad" is the creative unit inside an ad group; a sponsored ad's advertised product is inside its creative (productCreative for SP, componentCreative for SB and SD, videoCreative for ST) — ad associations (ads_query_ad_association) are AMAZON_DSP's ad-to-ad-group links, not product links. Use it for a targeted read of current settings (by id, name or state); for a whole-account dump use ads_ad_export, and for spend or sales use query_report_data. Amazon Ads API · QueryAd · POST /adsApi/v1/query/ads Docs: https://advertising.amazon.com/API/docs/en-us/api-spec-v1-ads#tag/Ads/operation/QueryAd
Call it
In an AI client (MCP)
{
"name": "ads_query_ad",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"body": {}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_query_ad \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","body":{}}'Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
bodyrequired | object | the filter object — adProductFilter is required, e.g. {adProductFilter: {include: ['SPONSORED_PRODUCTS']}, adGroupIdFilter: {include: ['<adGroupId>']}}. |
Result
Every tool answers {notification, data, human_action}; data carries:
- Amazon's payload in data.result.
data.result— the matching ads — the server follows nextToken for up to 5 pages; maxResults caps the total.data.nextToken— set when more remain — call again with the SAME filters plus this nextToken (a token-only body 400s).