ads_sp_get_all_rule_events
Sponsored Products: list the special shopping events (Prime Day, Black Friday, …) with Amazon's suggested date range in this profile's marketplace.
readAmazon Adsads.sp
An eventId scopes an SP budget rule (duration.eventTypeRuleDuration.eventId on ads_create_budget_rules_for_campaigns) or a bid rule (recurrence.duration.eventId). Amazon Ads API · SPGetAllRuleEvents · POST /sp/v1/events Docs: https://advertising.amazon.com/API/docs/en-us/sponsored-products/3-0/openapi/prod#tag/BudgetRulesRecommendation/operation/SPGetAllRuleEvents
Call it
In an AI client (MCP)
{
"name": "ads_sp_get_all_rule_events",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_sp_get_all_rule_events \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>"}'Early access — the Tool API is open on request, contact us.
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'). |
Result
Every tool answers {notification, data, human_action}; data carries:
- Amazon's payload in data.result.
data.result.events[]— {eventId, eventName, startDate, endDate}.data.result.groupedEvents[]— {groupedEventId, groupedEventName, startDate, endDate}.
Gotchas
- Pass an eventId as recurrence.duration.eventId (with eventName) on ads_sp_create_optimization_rules to bound a rule to the event instead of hardcoding dates. Rule changes take up to 24h to take effect, so create event rules well before the event starts.