Perform an operation on an item batch
POST {{baseUrl}}/catalogs/items/batch
This endpoint is currently in beta and not available to all apps. Learn more.
This endpoint supports multiple operations on a set of one or more catalog items.
Request Body
{"country"=>"US", "language"=>"EN", "operation"=>"UPDATE", "items"=>[{"item_id"=>"DS0294-M", "attributes"=>{"ad_link"=>"https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest", "additional_image_link"=>["https://scene.example.com/image/image_v2.jpg", "https://scene.example.com/image/image_v3.jpg"], "adult"=>true, "age_group"=>"newborn", "availability"=>"in stock", "average_review_rating"=>5, "brand"=>"Josie’s Denim", "color"=>"blue", "condition"=>"new", "custom_label_0"=>"Best sellers", "custom_label_1"=>"Summer promotion", "custom_label_2"=>"Winter sales", "custom_label_3"=>"Woman dress", "custom_label_4"=>"Man hat", "description"=>"Casual fit denim shirt made with the finest quality Japanese denim.", "free_shipping_label"=>true, "free_shipping_limit"=>"35 USD", "gender"=>"unisex", "google_product_category"=>"Apparel & Accessories > Clothing > Shirts & Tops", "gtin"=>3234567890126, "id"=>"DS0294-L", "image_link"=>["https://scene.example.com/image/image.jpg"], "item_group_id"=>"DS0294", "last_updated_time"=>1641483432072, "link"=>"https://www.example.com/cat/womens-clothing/denim-shirt-0294", "material"=>"cotton", "min_ad_price"=>"19.99 USD", "mobile_link"=>"https://m.example.com/cat/womens-clothing/denim-shirt-0294", "mpn"=>"PI12345NTEREST", "number_of_ratings"=>10, "number_of_reviews"=>10, "pattern"=>"plaid", "price"=>"24.99 USD", "product_type"=>"Clothing > Women’s > Shirts > Denim", "sale_price"=>"14.99 USD", "shipping"=>"US:CA:Ground:0 USD", "shipping_height"=>"12 in", "shipping_weight"=>"3 kg", "shipping_width"=>"16 in", "size"=>"M", "size_system"=>"US", "size_type"=>"regular", "tax"=>"US:1025433:6.00:y", "title"=>"Women’s denim shirt, large"}}, {"item_id"=>"DS0294-M", "attributes"=>{"ad_link"=>"https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest", "additional_image_link"=>["https://scene.example.com/image/image_v2.jpg", "https://scene.example.com/image/image_v3.jpg"], "adult"=>true, "age_group"=>"newborn", "availability"=>"in stock", "average_review_rating"=>5, "brand"=>"Josie’s Denim", "color"=>"blue", "condition"=>"new", "custom_label_0"=>"Best sellers", "custom_label_1"=>"Summer promotion", "custom_label_2"=>"Winter sales", "custom_label_3"=>"Woman dress", "custom_label_4"=>"Man hat", "description"=>"Casual fit denim shirt made with the finest quality Japanese denim.", "free_shipping_label"=>true, "free_shipping_limit"=>"35 USD", "gender"=>"unisex", "google_product_category"=>"Apparel & Accessories > Clothing > Shirts & Tops", "gtin"=>3234567890126, "id"=>"DS0294-L", "image_link"=>["https://scene.example.com/image/image.jpg"], "item_group_id"=>"DS0294", "last_updated_time"=>1641483432072, "link"=>"https://www.example.com/cat/womens-clothing/denim-shirt-0294", "material"=>"cotton", "min_ad_price"=>"19.99 USD", "mobile_link"=>"https://m.example.com/cat/womens-clothing/denim-shirt-0294", "mpn"=>"PI12345NTEREST", "number_of_ratings"=>10, "number_of_reviews"=>10, "pattern"=>"plaid", "price"=>"24.99 USD", "product_type"=>"Clothing > Women’s > Shirts > Denim", "sale_price"=>"14.99 USD", "shipping"=>"US:CA:Ground:0 USD", "shipping_height"=>"12 in", "shipping_weight"=>"3 kg", "shipping_width"=>"16 in", "size"=>"M", "size_system"=>"US", "size_type"=>"regular", "tax"=>"US:1025433:6.00:y", "title"=>"Women’s denim shirt, large"}}]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"items":[{"item_id":"DS0294-M","errors":[{"attribute":"title","code":106,"message":"Title is missing from product metadata."},{"attribute":"title","code":106,"message":"Title is missing from product metadata."}],"warnings":[{"attribute":"title","code":106,"message":"Title is missing from product metadata."},{"attribute":"title","code":106,"message":"Title is missing from product metadata."}],"status":"SUCCESS"},{"item_id":"DS0294-M","errors":[{"attribute":"title","code":106,"message":"Title is missing from product metadata."},{"attribute":"title","code":106,"message":"Title is missing from product metadata."}],"warnings":[{"attribute":"title","code":106,"message":"Title is missing from product metadata."},{"attribute":"title","code":106,"message":"Title is missing from product metadata."}],"status":"SUCCESS"}],"batch_id":"595953100599279259-66753b9bb65c46c49bd8503b27fecf9e","created_time":"2020-01-01T20:10:40-00:00","completed_time":"2022-03-10T15:37:10-00:00","status":"PROCESSING"}