Guides
My Account

Check eligibility of items

Use the Catalog Item Eligibility API to verify whether specific items in your catalog qualify for SEM campaigns. You can filter items by SKU to determine their eligibility for SEM ads. An item is eligible only if it is published, in stock, has no GMC errors, and is not part of an active or scheduled campaign. The response returns only eligible items. SKUs that fail these checks are omitted.

An item can be in only one active campaign at a time. Before you create or update a campaign, use this API to check whether the item is already in an active campaign.

Throttling

This API endpoint is throttled—if you submit too many feeds too quickly, you might hit Walmart’s rate limits and receive HTTP 429 responses. To learn more about throttling, refer to the Marketplace throttling documentation.

Endpoint

POST /v3/advertising/sem/items/eligibility

Sample request

Use this example as a starting point, then modify it with your actual values and any additional parameters described in the API reference.

curl --location 'https://marketplace.walmartapis.com/v3/advertising/sem/items/eligibility' \
--header 'WM_SVC.NAME: Search Engine Marketing' \
--header 'WM_QOS.CORRELATION_ID: e3ccb563-784b-49c4-b1bf-c1d696599dfa' \
--header 'WM_SEC.ACCESS_TOKEN: **********' \
--header 'Content-Type: application/json' \
--data '{ "filters": [ { "field": "sku", "values": [ "sku_07144442400738_test", "sku_00993001888299_test", "sku_07148487515983_test", "sku_invalid_test" ] } ]
}'

import requests
import json url = "https://marketplace.walmartapis.com/v3/advertising/sem/items/eligibility" headers = { "WM_SVC.NAME": "Search Engine Marketing", "WM_QOS.CORRELATION_ID": "e3ccb563-784b-49c4-b1bf-c1d696599dfa", "WM_SEC.ACCESS_TOKEN": "**********", "Content-Type": "application/json"
} data = { "filters": [ { "field": "sku", "values": [ "sku_07144442400738_test", "sku_00993001888299_test", "sku_07148487515983_test", "sku_invalid_test" ] } ]
} response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.text)

Modify your code

  1. Use your unique WM_QOS.CORRELATION_ID for each request.
  2. Use your unique WM_SEC.ACCESS_TOKEN obtained from the Token API.
  3. Update the values array inside the filters object with the actual SKU values you want to check for eligibility.

Sample response

{ "pagination": { "pageNo": 0, "pageSize": 10, "totalCount": 3, "totalPages": 1 }, "data": [ { "itemId": "5014488974", "sku": "sku_07144442400738_test", "productId": "1A2B3C4D5E", "productName": "Wireless Bluetooth Headphones", "categoryName": "Electronics", "productUrl": "/ip/Headphones/5014488974", "productImageUrl": "https://i5-qa.walmartimages.com/asr/dffe200d-117d-4804-a4de-aebbdbe7a616.ccd4b68eb51087086daf6c75197b214b.avif" }, { "itemId": "5014389813", "sku": "sku_00993001888299_test", "productId": "1YO2HKFIAB1E", "productName": "Womens Square Neck Ribbed Sweater Dress", "categoryName": "Clothing", "productUrl": "/ip/Sweater/5014389813", "productImageUrl": "https://i5-qa.walmartimages.com/asr/cc211564-bf4c-4810-8474-3b192a1c8631.e87331cdd32950f6f83a239743ea9816.jpeg" }, { "itemId": "5014389838", "sku": "sku_07148487515983_test", "productId": "2CZOV9ZBND06", "productName": "Low-Fat Milk", "categoryName": "Food & Beverage", "productUrl": "/ip/Milk/5014389838", "productImageUrl": "https://i5-qa.walmartimages.com/asr/030d9eed-3b2c-4d5f-baa3-55c82fa36e0a.5b1cc2147571bae5b3c62016c6220309.jpeg" } ]
}

Result

If successful, the API response returns an HTTP status: 200 OK with a JSON payload containing the item details for the specified SKUs.

Updated 5 days ago