Partial Reindexing API

Index only the products that changed, so customers see fresh data almost instantly.

Last updated

On this page

Overview

Use the Partial Reindexing API to update a section of the product collection. Instead of reindexing all data, you index only the specific products that changed. Indexing is quicker, and customers see fresh data almost instantly.

The request body includes two arrays:

  • The first contains products to update or create.
  • The second contains the IDs of products to delete.

Endpoint

MethodPath
POST/api/v1/open-api/reindex/partial
POST/api/v2/open-api/reindex/partial

Request body

JSON
{
   "token": "{{website_token}}", //required
   "data": {
      "update": [ //required, array of objects
         {
            "entity_id": "1",
            "attribute_set_id": "15",
            "type_id": "simple",
            "sku": "24-MB01",
            "has_options": "0",
            "required_options": "0",
            "created_at": "2021-07-26 08:02:14",
            "updated_at": "2021-07-26 08:02:14",
            "visibility": "4",
            "status": "1",
            "name": "Joust Duffle Bag",
            "image": "http://m.com/media/catalog/product/mb01-blue-0.jpg",
            "small_image": "/m/b/mb01-blue-0.jpg",
            "thumbnail": "/m/b/mb01-blue-0.jpg",
            "url_key": "joust-duffle-bag",
            "price": "32.000000",
            "description": "The sporty Joust Duffle Bag can't be beat",
            "store_id": 1,
            "total_reviews": 2,
            "reviews": 50,
            "link": "http://m.com/joust-duffle-bag.html",
            "full_image_path": "http://m.com/media/catalog/product/m/b/mb01-blue-0.jpg",
            "stock": 1,
            "categories": [
               "3",
               "4"
            ],
            "salable_qty": 100
         }
      ],
      "delete": [ //required, array of objects
         {
            "entity_id": 47
         }
      ]
   }
}

Successful response

JSON
{
   "message": [
      {
         "id": 47,
         "message": "deleted",
         "status": 200,
         "time": "2021-09-03 16:05:39"
      },
      {
         "id": "1",
         "sku": "24-MB01",
         "timestamp": "",
         "time": "2021-09-03 16:05:39",
         "status": 200,
         "result": "updated"
      }
   ]
}