Skip to content

Catalog Batch API - Commerce

Updated: Feb 9, 2026

Use the Catalog Batch API for these use cases:

  • If you have large catalogs, such as a catalog containing millions of items with quickly changing inventory. You can create, update, and delete multiple items in a single HTTP request.
  • If you need to create and update product information more often than once an hour (otherwise, use the Feed API). You can update multiple items in a single HTTP request.

How It Works

The Catalog Batch API for Commerce consists of the following endpoints:

EndpointDescriptionSee Guide
POST /{catalog_id}/batchSends a batch of requests (create, update, delete) for an ecommerce catalog. Used only for product items.Send Item Updates
POST /{catalog_id}/items_batchSends a batch of requests (create, update, delete) for a catalog. Used for a variety of different objects, such as products, hotels, hotel rooms, flights, destination, home listings, vehicle, and vehicle offers.Send Product Updates
GET /{catalog_id}/check_batch_request_statusChecks the status of a batch request. Use a handle (returned from a call to {catalog_id}/batch) and make a GET call.Check Batch Request Status

The parameter names for /{catalog_id}/batch and /{catalog_id}/items_batch may appear to be similar, but they are distinctly different.

Next Steps

Use the Catalog Batch API guides to help you perform common actions with the Catalog Batch API.

Learn More

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About