Deprecated

API 2027-01-01: Walmart audiences and 2026-06-01 deprecation


Summary

  • API revision 2027-01-01 is available now.
  • Strategies can target Walmart audiences, alongside your own uploaded and connected audiences, in one list.
  • New GET /catalog/audiences endpoint to browse the Walmart audience catalog.
  • New frequency_cap on strategies.
  • Interest targeting is removed.
  • Revision 2026-06-01 is deprecated on January 1, 2027 and sunsets on February 1, 2027.

What's new in 2027-01-01

ChangeType
Strategy audience targeting takes one include / exclude list of audience IDs, so Walmart audiences and your own audiences can be combinedBreaking
GET /catalog/audiences lists the Walmart audiences you can targetAdded
frequency_cap on strategiesAdded
GET /segments/interests and the interests targeting field are removedBreaking

Target Walmart audiences

Strategy targeting now takes a single list of audience IDs. One strategy can include and exclude Walmart audiences together with audiences you've uploaded or connected in Vibe.

// 2026-06-01
"targeting": {
  "audiences": {
    "upload": { "include": ["<audience_id>"], "exclude": [] }
  }
}

// 2027-01-01
"targeting": {
  "audiences": {
    "include": ["<walmart_audience_id>", "<your_audience_id>"],
    "exclude": ["<audience_id>"]
  }
}

The paths are unchanged. The new targeting shape is used by:

  • POST /strategies
  • PATCH /strategies/{strategy_id}
  • GET /strategies
  • GET /strategies/{strategy_id}
  • POST /strategies/{strategy_id}/duplicate
  • POST /strategies/{strategy_id}/actions (response)
  • POST /campaigns/{campaign_id}/duplicate (request)

Browse the Walmart audience catalog

GET /catalog/audiences returns every Walmart audience available for strategy targeting, with its category path (category, l1, l2, l3) and its addressable CTV reach (reach). Use each audience's id in targeting.audiences.include or exclude.

  • Filters: type (RECENT_BUYERS, IN_MARKET or PERSONA) and search (matches the audience name and every level of its category path).
  • Ordering: the response isn't paginated, and is ordered by category path so you can rebuild the category tree.
  • Scope: audiences:read.
  • Terms: your account must accept the Walmart audience terms in the Vibe app first. Until then, the endpoint returns 403 with the page to visit. The terms can't be accepted through the API.

Cap frequency on strategies

Strategies accept frequency_cap: the maximum number of plays per household per day. It's an integer of at least 1, and defaults to 5. Campaign goals that don't cap frequency only accept 5.

Interest targeting removed

GET /segments/interests and the interests targeting field aren't available in 2027-01-01. Use audience targeting instead, including Walmart audiences.

How to upgrade

  1. Send X-Vibe-Revision: 2027-01-01 on your requests.
  2. Move audience IDs from targeting.audiences.upload.include / exclude to targeting.audiences.include / exclude.
  3. Update any code that reads targeting.audiences.upload from strategy responses.
  4. Remove any use of GET /segments/interests and the interests field.
  5. To add Walmart audiences, accept the terms in the Vibe app https://www.vibe.co/walmart-audience-terms, then pick IDs from GET /catalog/audiences.

2026-06-01 timeline

Date2026-06-01
January 1, 2027Deprecated
February 1, 2027Sunset

GET /revisions lists every revision with its release, deprecation and sunset dates.

Questions

Do I have to upgrade now?
No. 2026-06-01 keeps working until February 1, 2027. Upgrade now if you want to target Walmart audiences or set frequency caps.

Can I target Walmart audiences on 2026-06-01?
No. Walmart audience targeting is only available on 2027-01-01.

Can I use both revisions at the same time?
Avoid updating the same strategies from both. 2026-06-01 only sees uploaded audiences, and an update sent on it replaces the strategy's audience set, so it can remove audiences added through 2027-01-01. Move every service that updates strategies to 2027-01-01 together.

Why does GET /catalog/audiences return 403?
Either the Walmart audience terms haven't been accepted for your account yet, or your token is missing the audiences:read scope. The error message says which.

Can every advertiser use Walmart audiences?
No. Advertisers in restricted categories, including political and CBD, can't target Walmart audiences.

How often does the Walmart catalog change?
Catalogs update weekly. Cache the response for at least 24 hours.

How will I know about future revisions?
Follow this changelog or its RSS feed, and check GET /revisions.