Check eligibility of items

The Catalog Item Eligibility API allows you to check whether specific items in your catalog meet the required conditions for inclusion in your SEM campaign. You can filter items by SKU or other attributes to determine their eligibility for SEM ads.

Throttling

Request limits: 10 calls per minute per seller. You may receive an HTTP 429 error if you exceed this limit.

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

Use your unique WM_QOS.CORRELATION_ID for each request.
Use your unique WM_SEC.ACCESS_TOKEN obtained from the Token API.
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 about 17 hours ago