DOCSEARCHbyAlgolia
Submit Docs

Selling Partner API (SP-API) Documentation

repository·main·Indexed 23 days ago

https://github.com/amzn/selling-partner-api-docs

A decommissioned repository for Selling Partner API (SP-API) documentation. This source contains legacy guides and references, including the Listings Restrictions API, and directs users to the official documentation site for active API models, technical tutorials, and migration guides from Amazon MWS to SP-API.

Tokens
5.1K
Snippets
32
Records
51
Agent score
82%

What's inside selling-partner-api-docs

  1. What is the Listings Restrictions API?

    main

    The Listings Restrictions API allows you to check if there are restrictions preventing the creation of a listing for an item in the Amazon catalog. If an item is restricted, the API can provide information on how to request approval to list it.

    Key Capabilities

    • ASIN-based checks: Retrieve restriction details for an existing catalog item using its Amazon Standard Identification Number (ASIN).
    • Condition filtering: Optionally filter restrictions based on the item's condition type.
    • Multi-marketplace support: Check for restrictions across multiple marketplaces in a single API call.
    • Approval workflows: When a restriction requires approval, the API returns 'next step' links to guide you through the approval process.

    Recommended Workflow

    It is recommended to use the Listings Restrictions API in conjunction with the Listings Items API. A common pattern is to first call the Listings Restrictions API to verify if an item can be listed; if no restrictions are found, proceed to call the Listings Items API to create the offer-only listing.

  2. Listings Restrictions API Terminology

    main

    Understanding these core terms is essential for using the API:

    • ASIN (Amazon Standard Identification Number): The unique identifier for an item in the Amazon catalog.
    • Listing: An item a selling partner has listed for sale, identified by a Stock Keeping Unit (SKU). Product facts in a listing are reconciled into Amazon catalog items (identified by ASINs).
    • Restriction: A condition that prevents the creation of a listing. Some restrictions are 'approval requirements' that can be resolved via additional steps.

  7. Access the Vendor Direct Fulfillment Inventory API v1 documentation

    main

    The documentation for the Vendor Direct Fulfillment Inventory API v1 has been migrated. For the most up-to-date reference, guides, and API specifications, visit the new Selling Partner API Documentation website.

    https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-inventory-api-v1-reference

  8. Access the Vendor Direct Fulfillment Transactions API documentation

    main

    The documentation for the Vendor Direct Fulfillment Transactions API has been migrated. For the most up-to-date reference, implementation guides, and API details, visit the new Selling Partner API Documentation website.

    https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-transactions-api-2021-12-28-reference

  10. Access Retail Analytics Reports Best Practices

    main

    The documentation for Retail Analytics Reports Best Practices has been migrated. For the most up-to-date guidance and best practices regarding Vendor Retail Analytics reports, visit the new Selling Partner API Documentation website.

    https://developer-docs.amazon.com/sp-api/docs/report-type-values#vendor-retail-analytics-reports