Search for item-level diagnostic issues that block or limit items from being used in Search Engine Marketing (SEM). Returns paginated, item-level diagnostic details including campaign associations, issue types, severity, remediation guidance, and overall item status.
Market availability: US only
Items in SEM campaigns must meet content, quality, and policy requirements before they can be advertised on search engines (For example, Google Shopping Ads). This endpoint surfaces the specific issues preventing or limiting an item's SEM eligibility, along with actionable remediation guidance so sellers can resolve problems and restore advertising reach.
Current scope
This endpoint currently returns diagnostics for items that are part of active SEM campaigns for the authenticated seller. Each item in the response includes its campaignAssociations — the list of campaigns the item belongs to. Items not associated with any campaign are not included in the results.
Default behavior
- When no request body is provided, defaults to
offset=0,limit=100with no filters - When no
issueCategoryfilter is provided, returns only items with issues (BLOCKEDorLIMITED) - To include healthy items, explicitly pass
issueCategoryfilter withNO_ISSUESor all three values - By default, the API prioritizes returning actionable diagnostic issues rather than healthy items. This reduces payload size and improves relevance
Supported filters
Filters are combined with AND logic. Multiple values within a single filter act as OR.
| Filter Field | Supported Values | Max Values | Description |
|---|---|---|---|
issues | Any valid issueType enum value | 100 | Filter by specific SEM issue types (For example, ITEM_OUT_OF_STOCK, TITLE_TOO_LONG, POLICY_VIOLATION) |
issueCategory | LIMITED, BLOCKED, NO_ISSUES | 100 | Filter by SEM issue severity — BLOCKED items cannot be advertised at all, LIMITED items have reduced SEM performance |
itemId | Numeric string item IDs | 100 | Filter by Walmart catalog item identifiers within the seller's active campaigns. In a future release, this filter will also support items outside of campaigns. |
Response structure
Each response contains two top-level fields:
pagination: Standard pagination metadata includinghasNextPage/hasPreviousPagefor convenient UI navigationdata: Array of item-level diagnostics. Each item appears once per uniqueofferIdwith all campaign associations listed. Each item includes anissueCategoryfield representing the overall SEM eligibility status of the item, and anissuesarray containing issue type identifiers. Issues are item-level, not campaign-specific — a blocked item is blocked in all SEM campaigns it belongs to.
Issue metadata (name, description, fixability, help links) is not included in this response. Partners should use the dedicated GET /item-issues/issue-types endpoint to retrieve complete issue metadata and cache it locally (TTL: 24 hours).
Issue categories
| Category | SEM Impact |
|---|---|
BLOCKED | Item cannot be advertised on search engines. Must be resolved before the item can appear in SEM ads. Examples: out of stock, missing title, policy violation, invalid image. |
LIMITED | Item can be advertised but with reduced visibility or performance on search engines. Resolving these issues improves ad reach and effectiveness. Examples: title too long, low image quality, description too short. |
NO_ISSUES | Item has no SEM issues and can be advertised normally with full visibility. |
Actionable vs non-actionable issues
Each issue type has an isFixable flag available via the GET /item-issues/issue-types reference endpoint:
isFixable=true: Seller can fix the issue to restore SEM eligibility (For example, restock inventory, update title, fix image). Partners should surface these with a "Fix Now" UI affordance.isFixable=false: Requires Walmart or system intervention (For example, Google policy violations). Partners should display these as informational — the seller cannot directly resolve them.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||