Delta Feeds API

The Delta Feeds API updates availability, titles, and prices for existing variants in a linked product feed. Send only the products that changed instead of uploading your entire catalog again.

Before you begin

You need:

• An Ads API key from the ad account’s Settings tab in Ads Manager.
• A product feed linked to that ad account and its feed ID.
• An initial catalog already uploaded to the feed.
• The existing parent product and variant identifiers from that catalog.

The endpoint updates existing feed variants. It doesn’t create feeds, upload full catalogs, or add products that aren’t already in the feed. See Product Feeds to set up the initial catalog.

Update product variants

Send a PATCH request with each changed product and its affected variants. You can update a variant’s price, availability, or both.

PATCH /feeds/{feed_id}/products

curl -X PATCH \
  "https://api.ads.openai.com/v1/feeds/product_feed_123/products" \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "id": "running-shoe-001",
        "variants": [
          {
            "id": "running-shoe-001-black-9",
            "availability": {
              "available": false
            }
          },
          {
            "id": "running-shoe-001-white-9",
            "title": "Running shoe - white, size 9",
            "price": {
              "amount": 8999,
              "currency": "USD"
            },
            "availability": {
              "status": "in_stock"
            }
          }
        ]
      }
    ]
  }'

The API returns 200 OK with the feed ID and an acceptance result:

{
  "id": "product_feed_123",
  "accepted": true
}

accepted: true means the update was accepted by feed processing. It doesn’t mean downstream indexing, ad eligibility, or serving has already updated. Check the accepted value before treating the request as successful.

Request fields

Both products and every variants array must contain at least one item. Product and variant IDs must be nonempty. Don’t include the same variant more than once in a request.

Send the feed ID in the URL, the parent product ID in products[].id, and the variant ID in products[].variants[].id. Don’t send shop_id, scoped_offer_id, or target_country; feed ownership, product identity, and supported countries are resolved from the linked feed.

Understand how changes are applied

The initial feed upload supplies the full product record. A delta request changes only the specified fields on existing variants and preserves the remaining catalog data.

After feed processing accepts an update, downstream systems apply the change asynchronously. An out-of-stock product stops qualifying for delivery after the change propagates. Marking a product in stock doesn’t guarantee that it will serve: the product, campaign, ad group, and ad must still meet normal serving requirements.

There is no completion timestamp or downstream processing result in the acceptance response. Use your normal feed and campaign monitoring to verify the result.

Handle common errors

If the error code is product_feed_api_disabled or product_feed_delta_api_disabled, access hasn’t been enabled for the account. Don’t retry unchanged requests until access or the underlying request issue is resolved.

Next steps

• Set up a product feed and product-feed campaign.
• Review Advertiser API authentication.
• Understand Advertiser API access and limits.