Amazon Selling Partner

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…

E-commerce#openapi

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

How to test the Selling Partner API for Listings Items in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. 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.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. 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.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.