API Reference
Developer HubAPI StatusSupport

searchPromotions

get
https://sellingpartnerapi-na.amazon.com/promotions/2025-12-01/promotions

Search and filter promotions based on various criteria. Returns a paginated list of promotion summaries.

Usage Plan:

Rate (requests per second)Burst
0.14

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits.

Query Params
marketplaceIds
array of strings
required
length ≤ 1

The Amazon stores from which to retrieve promotions. Refer to Store Identifiers for a list of Amazon store values.

marketplaceIds*
string
^[a-z]{2}_[A-Z]{2}$
Defaults to en_US

The locale from which to retrieve promotions. Formatted as an ISO 639 language code, followed by an underscore, followed by an ISO 3166-1 alpha-2 country code.

statuses
array of strings

The statuses of promotions to retrieve, formatted as a comma-delimited list.

statuses
Allowed:
asins
array of strings
length ≤ 10

The ASINs to which promotions apply, formatted as a comma-delimited list.

asins
skus
array of strings
length ≤ 10

The SKUs to which promotions apply, formatted as a comma-delimited list.

skus
promotionTypes
array of strings

The promotion types to which promotions apply, formatted as a comma-delimited list.

promotionTypes
Allowed:
date-time

Promotions that start before this date are returned. Formatted in ISO 8601 format, including the timezone. For example: 1970-01-01T00:00:00-07:00.

date-time

Promotions that start after this date are returned. Formatted in ISO 8601 format, including the timezone. For example: 1970-01-01T00:00:00-07:00.

date-time

Promotions that end before this date are returned. Formatted in ISO 8601 format, including the timezone. For example: 1970-01-01T00:00:00-07:00.

date-time

Promotions that end after this date are returned. Formatted in ISO 8601 format, including the timezone. For example: 1970-01-01T00:00:00-07:00.

date-time

Filter promotions that were last modified after this timestamp. Zoned Datetime in ISO 8601 format (e.g., 1970-01-01T00:00:00-07:00).

date-time

Filter promotions that were last modified before this timestamp. Zoned Datetime in ISO 8601 format (e.g., 1970-01-01T00:00:00-07:00).

string

A token that you use to retrieve the next page of results. The response includes paginationToken when the number of results exceeds the specified limit value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until paginationToken is null. Note that this operation can return empty pages.

string
enum
Defaults to PUBLISHED

Specifies which promotion revision or revisions to match against when filtering. This controls which promotions are included in search results, not the shape of the response. The response always returns the published revision in the main body, with latestRevision included when the latest revision diverges.

Allowed:
int64
1 to 100
Defaults to 20

The maximum number of response results per page.

includedData
array of strings

A comma-delimited list of datasets to include in the response.

includedData
Allowed:
Responses

Updated 23 days ago

Language
LoadingLoading…
Response
Choose an example:
application/json

Updated 23 days ago

Policies and Agreements    Privacy notice   |   Conditions of use