Get item count by status

Overview

Use the Get item count by status API to retrieve the number of items in your Walmart Marketplace seller catalog based on publication status.

Use this API to review the total number of items or retrieve counts for a specific status, such as published, unpublished, or in progress.

This API provides aggregate counts rather than detailed item records.

Use cases

  • Retrieve the total number of items in your catalog
  • Count published items
  • Count unpublished items
  • Review items with system problems
  • Monitor items that are still in progress

Item status descriptions

Use the status query parameter to retrieve item counts based on the following statuses:

StatusDescription
ALLReturns the total number of items in your catalog, including published and unpublished items.
PUBLISHEDReturns the number of items published and live on Walmart.com.
UNPUBLISHEDReturns the number of items that are not published on Walmart.com.
SYSTEM_PROBLEMReturns the number of items with a system problem.
IN_PROGRESSReturns the number of items that are still being processed.

To investigate unpublished items and their reasons, use Get all items or Get an item to retrieve item-level details.

Reference guide

This guide explains how to retrieve item counts using the status query parameter.

For complete endpoint details, refer to the Get item count by status API reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/items/count

Request sample

The following request retrieves the count of published items.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/items/count?status=PUBLISHED' \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"
import requests url = "https://marketplace.walmartapis.com/v3/items/count?status=PUBLISHED" headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json"
} response = requests.get(url, headers=headers) print(response.text)

Replace <ACCESS_TOKEN> with a valid access token and use a unique correlation ID for each request.

Modify your request

Set the status query parameter to retrieve the count for a specific item status.

Allowed values: ALL, PUBLISHED, UNPUBLISHED, SYSTEM_PROBLEM, IN_PROGRESS.

To retrieve the total number of items:

GET /v3/items/count?status=ALL

To retrieve published or unpublished item counts:

GET /v3/items/count?status=PUBLISHED
GET /v3/items/count?status=UNPUBLISHED

To retrieve counts for other statuses, set status to SYSTEM_PROBLEM or IN_PROGRESS.

Response samples

The API contract provides the following examples.

For status=ALL:

{ "All": 682
}

For status=PUBLISHED:

{ "PUBLISHED": 99
}

For status=UNPUBLISHED:

{ "UNPUBLISHED": 383
}

These values are illustrative.

Results

After a successful request, the API returns the number of items matching the specified status. Use these counts to review the publication state of items in your seller catalog.

Next steps

  • Use Get all items to retrieve details about published or unpublished items.
  • Use Get an item to investigate an individual listing.
  • Use Monitor feed processing to check item setup or maintenance processing.
  • Use Get item count by groups to review item counts by variant group.

Did this page help you?