Feeds API FAQ
Frequently asked questions about the Feeds API.
What type of feeds are available within the Feeds API?
Select to expand the answer
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.
What format do I use when I submit feeds?
Select to expand the answer
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.
Where can I find the schema for a feed?
Select to expand the answer
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.
Where can I find the meaning of each XSD element for the XML feed?
Select to expand the answer
You can find a detailed description for each element in the XML element dictionary on Seller Central.
Can I reduce feed processing time?
Select to expand the answer
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.
Why does feed processing sometimes takes longer than one hour?
Select to expand the answer
Feed processing times depend on several factors and can take up to eight hours. To optimize feed processing, follow the Feeds API Best Practices.
Where can I find the definition of an error code in a Feeds API response?
Select to expand the answer
You can find a detailed explanation for an error code on Seller Central.
How can I use the Feeds API to manually upload invoices?
Select to expand the answer
For details about how to manually upload invoices using the Feeds API, refer to Manually Upload Invoices or Seller Central.
Should I use the Listings API or the Listings Feed to manage listings?
Select to expand the answer
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.
Why doesn't Seller Central reflect my updates after I receive a FEED_PROCESSING_FINISHED
notification for a JSON_LISTINGS_FEED
?
FEED_PROCESSING_FINISHED
notification for a JSON_LISTINGS_FEED
?Select to expand the answer
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.
Why do I get an error when I try to submit a feed as a vendor?
Select to expand the answer
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.
What does "Access to the resource is forbidden" mean?
Select to expand the answer
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.
What does "feed messages list beyond allowed size" mean?
Select to expand the answer
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.
How can a seller submit feeds through the API?
Select to expand the answer
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.
Updated 17 days ago