v1

latestOpenAPI 3.0.0Apache License 2.02026-07-263171,5614.1 MB
Listings Items v2021-08-01

searchListingsItems

Search for and return a list of selling partner listings items and their respective details.

Usage Plan:

Rate (requests per second)Burst
55

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

get/listings/2021-08-01/items/{sellerId}

Path parameters

sellerIdstring required

A selling partner identifier, such as a merchant account or vendor code.

Query parameters

marketplaceIdsstring[] required

A comma-delimited list of Amazon marketplace identifiers for the request.

issueLocalestring

A locale that is used to localize issues. When not provided, the default language code of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". When a localization is not available in the specified locale, localized messages default to "en_US".

includedDatastring[]

A comma-delimited list of datasets that you want to include in the response. Default: summaries.

identifiersstring[]

A comma-delimited list of product identifiers that you can use to search for listings items.

Note:

  1. This is required when you specify identifiersType.
  2. You cannot use 'identifiers' if you specify variationParentSku or packageHierarchySku.
identifiersType'ASIN' | 'EAN' | 'FNSKU' | 'GTIN' | 'ISBN' | 'JAN' | 'MINSAN' | 'SKU' | 'UPC'

A type of product identifiers that you can use to search for listings items.

Note: This is required when identifiers is provided.

variationParentSkustring

Filters results to include listing items that are variation children of the specified SKU.

Note: You cannot use variationParentSku if you include identifiers or packageHierarchySku in your request.

packageHierarchySkustring

Filter results to include listing items that contain or are contained by the specified SKU.

Note: You cannot use packageHierarchySku if you include identifiers or variationParentSku in your request.

createdAfterstring date-time

A date-time that is used to filter listing items. The response includes listings items that were created at or after this time. Values are in ISO 8601 date-time format.

createdBeforestring date-time

A date-time that is used to filter listing items. The response includes listings items that were created at or before this time. Values are in ISO 8601 date-time format.

lastUpdatedAfterstring date-time

A date-time that is used to filter listing items. The response includes listings items that were last updated at or after this time. Values are in ISO 8601 date-time format.

lastUpdatedBeforestring date-time

A date-time that is used to filter listing items. The response includes listings items that were last updated at or before this time. Values are in ISO 8601 date-time format.

withIssueSeveritystring[]

Filter results to include only listing items that have issues that match one or more of the specified severity levels.

withStatusstring[]

Filter results to include only listing items that have the specified status.

withoutStatusstring[]

Filter results to include only listing items that don't contain the specified statuses.

sortBy'sku' | 'createdDate' | 'lastUpdatedDate'

An attribute by which to sort the returned listing items.

sortOrder'ASC' | 'DESC'

The order in which to sort the result items.

pageSizeinteger

The number of results that you want to include on each page.

pageTokenstring

A token that you can use to fetch a specific page when there are multiple pages of results.

Response

Success.

numberOfResultsinteger required

The total number of selling partner listings items found for the search criteria (only results up to the page count limit is returned per request regardless of the number found).

Note: The maximum number of items (SKUs) that can be returned and paged through is 1000.