Overview

Use Catalog APIs to retrieve the product, brand, and taxonomy metadata required for Walmart Connect Display targeting, measurement, audience creation, and creative workflows.

Catalog APIs provide the reference data used throughout Walmart Connect Display. These APIs help partners discover products, brands, and retail taxonomy information and supply the IDs and metadata required by many downstream APIs.

Use Catalog APIs to:

Build measurement item sets
Build targeting item sets
Associate products with creatives
Create brand audiences
Build retail audiences
Navigate Walmart taxonomy structures

Availability

Supported for Onsite Display advertisers.

How it works

Catalog APIs provide read-only access to advertiser catalog information.

Catalog APIs are typically the first step in many workflows.

Catalog Discovery

Retrieve item, brand, and taxonomy metadata.

Select IDs

Identify products, brands, and taxonomy structures.

Build Requests

Use metadata in targeting, audience, and creative workflows.

Configure Campaigns

Create item sets and audiences.

Activate Workflows

Launch campaign, audience, and measurement workflows.

Catalog API categories

Catalog APIs are organized into three discovery areas.

Items

Product metadata

Retrieve product-level information used throughout Walmart Connect workflows.

Item IDs
GTINs
Brand information
Product URLs

Brands

Brand discovery

Retrieve advertiser-associated brands used in targeting and audience workflows.

Brand audiences
Brand validation
Brand selection workflows

Taxonomies

Retail hierarchy

Retrieve Walmart retail taxonomy structures used in contextual targeting and audience workflows.

Departments
Categories
Subcategories
Hierarchy navigation

Available endpoints

List Items

POST /api/v1/items/list

Retrieve item-level metadata including item IDs, GTINs, product URLs, brand information, and taxonomy classifications.

List Brands

POST /api/v1/brands/list

Retrieve brands associated with an advertiser account.

List Taxonomies

POST /api/v1/taxonomies/list

Retrieve Walmart retail taxonomy information including departments, categories, and subcategories.

Choosing the right endpoint

Use the table below to determine which Catalog API supports your workflow.

Goal	Endpoint
Build featured item sets	List Items
Build halo item sets	List Items, List Brands, or List Taxonomies
Build targeting item sets	List Items, List Brands, or List Taxonomies
Find products to associate with creatives	List Items
Retrieve available brands	List Brands
Build brand audiences	List Brands
Build retail audiences	List Taxonomies
Navigate category hierarchy	List Taxonomies

Common workflows

Item workflows

Use List Items when you need:

Product identifiers
Item metadata
Product selection workflows
Creative item association

What happens next

After retrieving catalog metadata:

Create measurement item sets
Create targeting item sets
Create brand audiences
Associate products with creatives
Configure audience workflows

Catalog APIs