Update Existing Products in a Nested Format

For the Availability Based feed management type, only the stock status is required. Pricing is optional.

curl --request POST "https://catalog.api.useinsider.com/v2/ingest" \
                    --header "Content-Type: application/json" \
                    --header "X-PARTNER-NAME: yourPartnerName" \
                    --header "X-REQUEST-TOKEN: your-api-token" \
                    --data '[
                    {
                    "item_id": "velocity-runner-pro-white",
                    "locale": "en_US",
                    "name": "Velocity Runner Pro - White",
                    "url": "https://www.example-insiderone.com/shoes/velocity-runner-pro-white",
                    "image_url": "https://cdn.example-insiderone.com/images/velocity-runner-pro-white.jpg",
                    "in_stock": 1
                    }
                    ]'

The Published Time Based feed management type requires an update timestamp instead of pricing.

curl --request POST "https://catalog.api.useinsider.com/v2/ingest" \
                    --header "Content-Type: application/json" \
                    --header "X-PARTNER-NAME: yourPartnerName" \
                    --header "X-REQUEST-TOKEN: your-api-token" \
                    --data '[
                    {
                    "item_id": "blog-top-running-shoes-2025",
                    "locale": "en_US",
                    "name": "Top 10 Running Shoes for 2025",
                    "url": "https://www.example-insiderone.com/blog/top-running-shoes-2025",
                    "image_url": "https://cdn.example-insiderone.com/images/blog/running-shoes-2025.jpg",
                    "item_update_date": "2025-01-15 10:30:00"
                    }
                    ]'

The Start & End Time Based feed management type requires date range attributes for time-bound content.

curl --request POST "https://catalog.api.useinsider.com/v2/ingest" \
                    --header "Content-Type: application/json" \
                    --header "X-PARTNER-NAME: yourPartnerName" \
                    --header "X-REQUEST-TOKEN: your-api-token" \
                    --data '[
                    {
                    "item_id": "promo-summer-clearance-2025",
                    "locale": "en_US",
                    "name": "Summer Clearance Sale - Up to 50% Off",
                    "url": "https://www.example-insiderone.com/campaigns/summer-clearance-2025",
                    "image_url": "https://cdn.example-insiderone.com/images/campaigns/summer-clearance.jpg",
                    "item_start_date": "2025-06-01 00:00:00",
                    "item_end_date": "2025-08-31 23:59:59"
                    }
                    ]'

The category attribute accepts an array of strings. How the array is interpreted depends on your account's category type, which is configured during onboarding. You must choose one of the two types:

• Hierarchical Category Type

Use this if your categories follow a parent-child structure, with subcategories nested under broader categories. Each element in the array represents a level in the hierarchy, ordered from broadest to most specific.

{
                    "category": ["Clothing", "Men", "Shirts", "Casual Shirts"]
                    }

This creates the hierarchy: Clothing → Men → Shirts → Casual Shirts.

The order matters; the first element is the top-level category, and each subsequent element is a child of the previous one.

• Flat Category Type

Use this if your categories are independent and don't follow a parent-child hierarchy. Each element is a standalone category label at the same level.

{
                    "category": ["Men's Shirts", "Women's Dresses", "Kids' Shoes"]
                    }

In flat mode, all categories are treated equally; there is no implied nesting or ordering relationship between elements.

Limits:

• Combined length of all category elements: max 1024 characters.

• Each element: max 512 characters.

Tags are used for product grouping and merchandising rules within the Insider One platform.

{
                    "tags": ["new-arrival", "bestseller", "summer-collection", "free-shipping"]
                    }

You can use tags to:

• Create product segments for personalization

• Trigger merchandising rules

• Filter products in recommendation widgets

• Define campaign audiences

Limits:

• Combined length of all tags: max 4096 characters

• Each tag: max 512 characters

The groupcode attribute links product variants together as a single product group. Products sharing the same groupcode are treated as variations of the same product (e.g., different sizes or colors).

[
                    {
                    "item_id": "velocity-runner-pro-white",
                    "groupcode": "velocity-runner-pro",
                    "color": "White",
                    "size": "10"
                    },
                    {
                    "item_id": "velocity-runner-pro-black",
                    "groupcode": "velocity-runner-pro",
                    "color": "Black",
                    "size": "10"
                    }
                    ]