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.

• 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.

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"
  }
]