Openbridge employs a conservative API request strategy, ensuring that we operate within published rate limits and throttling constraints imposed by Amazon. We carefully model each endpoint and how best to request and re-request data in a manner that minimizes our consumption of API rate limits.
Amazon recommends that you do not request reports at a frequency greater than the data for that report can be refreshed. There are cases where other applications are attached to a customer account. These applications may not properly follow Amazon documentation for limits and throttles. As a result of these application's lack of properly working within Amazon limits, they can effectively prevent Openbridge from collecting data on your behalf.
There are two common outcomes to over-aggressive use of the API:
- CANCELLED - The report was canceled.
- NO_DATA - The report was generated, but there was no data to report. This happens when there is no new data to report between consecutive report requests.
Openbridge has no control over the CANCELLED or NO_DATA responses from Amazon.
As a general rule, most reports are daily and should be requested no more than once a day. If you have another application or tool authorized to a seller account that is requesting a report at a frequency greater than it can support, the API will not honor requests Openbridge attempts to make.
Specifically, here is what Amazon will do in response to an app or toll exhausting API limits:
- Amazon will return CANCELLED to an API request, or
- The report will be generated with no data. It will include a short error message that the report was requested too frequently.
If you have other applications OR scheduled processes in the Seller Central UI, it will increase the risk of these errors occurring. Per Amazon, you should not have multiple applications requesting the same data.
If requests are failing, it is most likely there is another application is already requesting the same data. These applications may be requesting data faster than that particular type allows will result in an error.
If you have another app or tool exhausting API capacity, it will impact our ability to collect data on your behalf!
Make sure to check if you have any other application, or Seller Central reports scheduled. If you do, remove or pause them. This will reduce the number of requests that end in a CANCELLED or NO_DATA state.
Lastly, if reports have been generated from Seller Central UI, these requests will count against API limits. If you have scheduled reports in the Seller Central UI and are attempting to programmatically export via the API, we suggest stopping any scheduled reports in the seller UI.