Pesquisar itens de listagem

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.

Path Params
string
required

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

Query Params
array of strings
required
length ≤ 1

Uma lista delimitada por vírgula dos identificadores do Site da Amazon para a solicitação.

marketplaceIds*
string

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".

array of strings
Defaults to summaries

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

Show Details
summariesSummary details for the listing item.
attributesA JSON object that contains structured listing item attribute data, keyed by attribute name.
issuesIssues that are associated with the listing item.
offersCurrent offers for the listing item.
fulfillmentAvailabilityFulfillment availability details for the listing item.
procurementVendor procurement details for the listing item.
relationshipsRelationship details for a listing item (for example, variations).
productTypesProduct types associated with a listing item.
includedData
array of strings
length ≤ 20

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.
identifiers
string

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

Note:
This is required when identifiers is provided.

string

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.

string

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.

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.

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.

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.

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.

array of strings

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

Show Details
ERRORIndicates that an issue has occurred, which prevented the submission from processing. For example, a validation error.
WARNINGIndicates an issue has occurred that should be reviewed, but it has not prevented the submission from processing.
withIssueSeverity
array of strings

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

Show Details
BUYABLEThe listings item can be purchased by shoppers. This status does not apply to vendor listings.
DISCOVERABLEThe listings item is visible to shoppers.
withStatus
array of strings

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

Show Details
BUYABLEThe listings item can be purchased by shoppers. This status does not apply to vendor listings.
DISCOVERABLEThe listings item is visible to shoppers.
withoutStatus
string
Defaults to lastUpdatedDate

An attribute by which to sort the returned listing items.

string
Defaults to DESC

The order in which to sort the result items.

número inteiro
≤ 20
Defaults to 10

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

string

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

Responses

Idioma
Click Try It! to start a request and see the response here! Or choose an example:
application/json