Feeds API FAQ

The API provides feeds for a variety of use cases, including listing management, invoicing, and order management. For more details about Feeds API operations, associated data types, and schemas, refer to the Feeds API Reference.

For details about available feed types, refer to Feed Type Values.

You can submit feed documents in XML format or as flat files. The feed type name indicates the format. If the feed type contains FLAT_FILE, the document uses a flat file. Otherwise, the document uses XML for feed submission. Some reports, such as UPLOAD_VAT_INVOICE, neither use XML nor a flat file.

The documentation for each specific feed type includes a link to its schema. The schemas are available only for XML feeds, not for flat files. For flat files, refer to the list of attributes that the documentation provides for each feed type.

You can find a detailed description for each element in the XML element dictionary on Seller Central.

Feed processing cannot be prioritized. Feeds are queued in the backend and processed sequentially based on their order in the queue. However, you can optimize feed performance and processing by following Feeds API Best Practices.

Feed processing times depend on several factors and can take up to eight hours. To optimize feed processing, follow the Feeds API Best Practices.

You can find a detailed explanation for an error code on Seller Central.

For details about how to manually upload invoices using the Feeds API, refer to Manually Upload Invoices or Seller Central.

You can use the same data when you submit the feeds individually to the Listings API or in bulk with the JSON_LISTINGS_FEED. Generally, it is recommended to use the feed for operations that involve more than 1,500 items (up to 10,000 per feed). Due to rate limits on the Listings API, feed processing is faster in such cases. For more information, refer to the documentation.

You get the FEED_PROCESSING_FINISHED notification for JSON_LISTINGS_FEED when submissions are accepted into the Amazon catalog for further processing. This does not mean that the updates are fully processed. You should subscribe to LISTINGS_ITEM_ISSUES_CHANGE to get notified if errors occur during further processing.

Currently, vendors can only use JSON_LISTINGS_FEED. All other feeds are for sellers only. You can check the availability of each feed in the table on Feed Type Values.

Feeds require specific roles, depending on their content. You get this error when you do not have the appropriate roles to submit a feed. You can find the necessary roles for each report in the documentation. You can find further information on roles in the SP-API at Roles in the Selling Partner API.

The allowed size for a single feed document is currently 10 MB. If your file exceeds this size, divide it into smaller submissions. For more information, refer to Feeds API Best Practices.
JSON_LISTINGS_FEED has a limit of 10,000 items.

Sellers can submit feeds through the SP-API after they register as a developer to build their own integration or use one of the partner apps available in the Selling Partner Appstore on Seller Central.