Batching requests

Both the product API and the item API have a batch version that you can use to update multiple products or items at once.

warning

If any object in a batch fails, the entire batch fails. For example, an object fails if it's missing a required field or if a value doesn't match the field type, such as a string where an integer is expected.

Routes

• Product: /v2/data_ingestion/batch/catalog/product/submission

• Item: /v2/data_ingestion/batch/catalog/item/submission

Limits

The following limits apply to batch requests:

Limit	Value	Details
Batch size	500 KB	The limit applies to the total size of the uncompressed JSON request body, including the wrapper object and the batch array. A request over the limit returns an HTTP 400 error.
Rate limit	100 batch requests per second, per client	The limit is shared across the product and item batch routes. A request over the limit returns an HTTP 429 error.

Example request body

{
  "batch": [
    {
      "lookup_code": "1234567890",
      "store_identifier": "1234",
      "available": true,
      "price": 5.99
    },
    {
      "lookup_code": "0987654321",
      "store_identifier": "4321",
      "available": false
    }
  ]
}