Walmart

Base URL:

https://app.partnerboost.com

All endpoints use POST with Content-Type: application/json unless noted otherwise. Auth: Partner API authentication — pass token in the JSON body (from the publisher portal).

getProducts

This API allows you to filter and search for Walmart products that meet specific criteria, helping to narrow down the selection.

Method: POST
Path: /api/walmart_datafeed/get_products

Request parameters

Key	Description	Required	Type	Example
token	Acquired from publisher portal	Yes	string	-
page_size	Page size, Maximum 50	Yes	integer	20
page	Page	Yes	integer	1
brand_id	Brand ID, Not supported for bulk	No	integer	-
item_id	Walmart Item IDs, Maximum of 50, separated by comma	No	string	-
relationship	Relationship, 1 = returns only products with a partnership (default), 0 = returns products without partnership, 2 = returns all products with relationship field indicating partnership status.	No	integer	1

Request:

{
  "token": "YOUR_CHANNEL_TOKEN",
  "page_size": 20,
  "page": 1,
  "brand_id": null,
  "relationship": 1
}

Response fields

Key	Description	Type	Example
status.code	-	integer	0
status.msg	-	string	success
data.list[].product_name	Product name	string	onn. 65" Class 4K UHD LED Roku Smart TV HDR
data.list[].image	Product image	string	https://i5.walmartimages.com/seo/onn-65-Class-4K-UHD_abc123.jpeg
data.list[].item_id	Walmart Item ID	string	587462398
data.list[].commission	Commission, Could be a percentage or flat fee	string	5%
data.list[].category	Product category	string	Electronics
data.list[].availability	Product availability status	string	IN_STOCK
data.list[].rating	Average rating	string	4.3
data.list[].reviews	Number of reviews	string	2156
data.list[].url	Product URL	string	https://www.walmart.com/ip/587462398
data.list[].brand_id	Brand ID	integer	12345
data.list[].brand_name	Brand name	string	onn.
data.list[].update_time	Updated time, Unix timestamp	integer	1716192000
data.list[].relationship	Relationship, 0 = no partnership, 1 = has partnership	integer	1
data.list[].price	Product price	string	298.00
data.list[].original_price	Original price (strikethrough price)	string	298.00
data.list[].discount	Discount percentage, rounded to 2 decimal places	number	0
data.list[].discount_start_date	Discount start date, millisecond timestamp	integer	1778987100000
data.list[].discount_end_date	Discount end date, millisecond timestamp	integer	1783906200000
data.list[].currency	Currency code	string	USD
data.has_more	Is there more data?	boolean	true

---

getProductsLink

This API allows you to generate Walmart product tracking links using Walmart Item IDs.

Method: POST
Path: /api/walmart_datafeed/get_products_link

Request parameters

Key	Description	Required	Type	Example
token	Acquired from publisher portal	Yes	string	-
item_id	Walmart Item IDs, Maximum of 50, separated by comma	Yes	string	587462398,234567891
uid	PartnerBoost UID, Maximum 5, separated by comma, Maximum length is 128	No	string	myuid

Request:

{
  "token": "YOUR_CHANNEL_TOKEN",
  "item_id": "587462398,234567891",
  "uid": "myuid"
}

Response fields

Key	Description	Type	Example
status.code	Status code, 0=success	integer	0
status.msg	-	string	success
data[].item_id	Walmart Item ID	string	587462398
data[].link	Walmart Attribution tracking link	string	https://goto.walmart.com/c/5610446/565706/9383?veh=aff&sharedid=...
data[].partnerboost_link	PartnerBoost short link	string	https://pboost.me/AbCdEfGh?uid=myuid
error_list[].item_id	Walmart Item ID that failed	string	234567891
error_list[].message	Error message	string	Product not found or no relationship

---

getShopsLink

This API allows you to generate Walmart brandshop tracking links using Brand IDs.

Method: POST
Path: /api/walmart_datafeed/get_shops_link

Request parameters

Key	Description	Required	Type	Example
token	Acquired from publisher portal	Yes	string	-
brand_id	Brand IDs, Maximum of 50, separated by comma	Yes	string	12345,67890
uid	PartnerBoost UID, Maximum 5, separated by comma, Maximum length is 128	No	string	myuid

Request:

{
  "token": "YOUR_CHANNEL_TOKEN",
  "brand_id": "12345,67890",
  "uid": "myuid"
}

Response fields

Key	Description	Type	Example
status.code	Status code, 0=success	integer	0
status.msg	-	string	success
data[].brand_id	Brand ID	string	12345
data[].brand_name	Brand name	string	onn.
data[].brandshop_link	Walmart Attribution brandshop tracking link	string	https://goto.walmart.com/c/5610446/565706/9383?veh=aff&sharedid=...
data[].partnerboost_link	PartnerBoost short link	string	https://pboost.me/XyZaBcDe?uid=myuid
error_list[].brand_id	Brand ID that failed	string	67890
error_list[].brand_name	Brand name	string	Example Brand
error_list[].message	Error message	string	Brand has no brandshop link

---

getLatestAffiliateBoostForWalmartItems

This API allows you to retrieve the latest Affiliate Boost for Walmart item list. Only authorized publishers can access this API.

Method: POST
Path: /api/datafeed/get_latest_affiliate_boost_for_walmart_items

Request parameters

Key	Description	Required	Type	Example
token	Acquired from publisher portal	Yes	string	-
page_size	Page size, Maximum 50, default at 50	Yes	integer	50
page	Page	Yes	integer	1

Request:

{
  "token": "YOUR_CHANNEL_TOKEN",
  "page_size": 50,
  "page": 1
}

Response fields

Key	Description	Type	Example
status.code	Status code, 0=success	integer	0
status.msg	-	string	success
data.list[].brand_name	Brand Name	string	onn.
data.list[].item_id	Walmart Item ID	string	587462398
data.list[].sku	SKU	string	SKU587462
data.list[].commission	Commission rate, e.g. 0.15 means 15%	string	0.15
data.list[].start_time	Commission start time, ISO 8601	string	2026-05-01T00:00:00-07:00
data.list[].end_time	Commission end time, ISO 8601	string	2026-05-31T23:59:59-07:00
data.has_more	Is there more data?	boolean	true