Selling Partner API for Listings Items
The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner listings on Amazon. Use this API in…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner listings on Amazon. Use this API in collaboration with the Selling Partner API for Product Type Definitions, which you can use to retrieve the information about Amazon product types needed to use the Listings Items API.
For more information, refer to the Listings Items API Use Case Guide.
Endpoints 5
listings
- GETgetListingsItem
/listings/2021-08-01/items/:sellerId/:sku?marketplaceIds=ATVPDKIKX0DER&issueLocale=en_US&includedData=summariesReturns details about a listings item for a selling partner. Usage Plan: The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that… - PUTputListingsItem
/listings/2021-08-01/items/:sellerId/:sku?marketplaceIds=ATVPDKIKX0DER&includedData=issues&mode=VALIDATION_PREVIEW&issueLocale=en_USCreates a new or fully updates an existing listings item for a selling partner. Usage Plan: The x-amzn-RateLimit-Limit response header returns the usage plan… - DELETEdeleteListingsItem
/listings/2021-08-01/items/:sellerId/:sku?marketplaceIds=ATVPDKIKX0DER&issueLocale=en_USDeletes a listings item for a selling partner. Usage Plan: The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to… - PATCHpatchListingsItem
/listings/2021-08-01/items/:sellerId/:sku?marketplaceIds=ATVPDKIKX0DER&includedData=issues&mode=VALIDATION_PREVIEW&issueLocale=en_USPartially update (patch) a listings item for a selling partner. Only top-level listings item attributes can be patched. Patching nested attributes is not… - GETsearchListingsItems
/listings/2021-08-01/items/:sellerId?marketplaceIds=ATVPDKIKX0DER&issueLocale=en_US&includedData=summaries&identifiers=GM-ZDPI-9B4E&identifiersType=SKU&variationParentSku=GM-ZDPI-9B4E&packageHierarchySku=GM-ZDPI-9B4E&createdAfter=2024-03-01T01:30:00.000Z&createdBefore=2024-03-31T21:45:00.000Z&lastUpdatedAfter=2024-05-05T23:45:00.000Z&lastUpdatedBefore=2024-05-01T01:15:00.000Z&withIssueSeverity=WARNING&withStatus=DISCOVERABLE&withoutStatus=BUYABLE&sortBy=lastUpdatedDate&sortOrder=DESC&pageSize=9&pageToken=sdlkj234lkj234lksjdflkjwdflkjsfdlkj234234234234Search for and return a list of selling partner listings items and their respective details. Usage Plan: The x-amzn-RateLimit-Limit response header returns…
API details
- Base URL
https://sellingpartnerapi-na.amazon.com- Authentication
- None declared in the description
- Operations
- 5 operations on 2 pathsGET 2PUT 1PATCH 1DELETE 1
- Main resources
- listings 5
- Response formats
application/json- Description format
- Swagger 2.0, API version
2021-08-01 - Links
- OpenAPI document · Support
- Listed from
- Amazon Selling Partner's published OpenAPI description (amzn/selling-partner-api-models) (Apache-2.0)
How to test the Selling Partner API for Listings Items in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Selling Partner API for Listings Items collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “getListingsItem” (GET /listings/2021-08-01/items/:sellerId/:sku?marketplaceIds=ATVPDKIKX0DER&issueLocale=en_US&includedData=summaries), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Selling Partner API for Listings Items?
The Selling Partner API for Listings Items (Listings Items API) provides programmatic access to selling partner listings on Amazon. Use this API in… It is listed under E-commerce and has 5 endpoints.
Who publishes the Selling Partner API for Listings Items?
It is listed from Amazon Selling Partner's public API description (an OpenAPI document), not published by Amazon Selling Partner on Swastik Codes. Anyone who controls sellingpartnerapi.amazon.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Selling Partner API for Listings Items?
Requests go to https://sellingpartnerapi-na.amazon.com. Endpoint paths are added to this base URL.
How do I authenticate with the Selling Partner API for Listings Items?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Selling Partner API for Listings Items have?
5 operations on 2 paths (2 GET, 1 PUT, 1 PATCH, 1 DELETE). The largest groups are listings.
Is forking the Selling Partner API for Listings Items free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.