Walmart

List Walmart category products

List the products in a Walmart category, with prices, ratings, sellers and paging.

GET/v1/walmart/category/products
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
categorystringrequiredquery

Category id (`5427`, or `5427_486190` for a subcategory) or category page URL (`https://www.walmart.com/browse/baby/5427`).

min 1 chars · max 500 chars

sortstringoptionalquery

Order of the products: `relevance` (default), `bestselling`, `top_rated`, `newest`, `price_high_to_low` or `price_low_to_high`.

one of: relevance, bestselling, top_rated, newest, price_high_to_low, price_low_to_high

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 4096 chars

Response fields
67

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Walmart has no category with this id. A department that is only a landing page (`4171`, Toys) is a 400 naming its subcategory ids.

one of: found, not_found

The category; null when not found.

datacategoryid
stringnullable

Category id, e.g. `5427`; null when not shown.

datacategoryname
string

Category name.

datacategoryurl
stringnullable

Category page URL.

The category's path, broadest first.

databreadcrumbs[]id
stringnullable

Category id, e.g. `5427`; null when not shown.

databreadcrumbs[]name
string

Category name.

databreadcrumbs[]url
stringnullable

Category page URL.

datatotalResults
integernullable

Products matching, across every page, as Walmart counts them; null when it does not say.

Products on this page, paid placements left out.

dataproducts[]id
string

Walmart item id, e.g. `16101019327`.

dataproducts[]productId
stringnullable

Walmart's catalogue product id, e.g. `6D1IFLMZTGWY`.

dataproducts[]name
stringnullable

Product name.

dataproducts[]brand
stringnullable

Brand name, when shown.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]imageUrl
stringnullable

Product image URL.

dataproducts[]price
numbernullable

Price the shopper pays now, in `currency`.

dataproducts[]wasPrice
numbernullable

Earlier price the site shows struck through, when any.

dataproducts[]priceText
stringnullable

Price as the site writes it, e.g. `$44.96`.

dataproducts[]unitPriceText
stringnullable

Price per unit, e.g. `$14.99/qt`, when shown.

dataproducts[]currency
string

Currency code, `USD`.

dataproducts[]rating
numbernullable

Average star rating out of 5; null with no reviews.

dataproducts[]reviewCount
integernullable

Number of reviews.

dataproducts[]sellerId
stringnullable

Seller id of the shown offer.

dataproducts[]sellerName
stringnullable

Seller of the shown offer.

dataproducts[]availability
stringnullable

Stock status, e.g. `IN_STOCK` or `OUT_OF_STOCK`.

dataproducts[]additionalOfferCount
integernullable

Other sellers' offers for the item, when the site counts them.

dataproducts[]isSponsored
boolean

Whether the card is a paid placement.

Badges on the card: `Rollback`, `Best seller` and more.

dataproducts[]badges[]key
stringnullable

Badge key, e.g. `ROLLBACK`.

dataproducts[]badges[]text
string

Badge text, e.g. `Rollback`.

dataproducts[]categoryPath
stringnullable

Category path, e.g. `Home Page/Home/Appliances`.

Paid placements on this page. Walmart repeats them across pages, so they are kept apart from `products`.

datasponsoredProducts[]id
string

Walmart item id, e.g. `16101019327`.

datasponsoredProducts[]productId
stringnullable

Walmart's catalogue product id, e.g. `6D1IFLMZTGWY`.

datasponsoredProducts[]name
stringnullable

Product name.

datasponsoredProducts[]brand
stringnullable

Brand name, when shown.

datasponsoredProducts[]url
stringnullable

Product page URL.

datasponsoredProducts[]imageUrl
stringnullable

Product image URL.

datasponsoredProducts[]price
numbernullable

Price the shopper pays now, in `currency`.

datasponsoredProducts[]wasPrice
numbernullable

Earlier price the site shows struck through, when any.

datasponsoredProducts[]priceText
stringnullable

Price as the site writes it, e.g. `$44.96`.

datasponsoredProducts[]unitPriceText
stringnullable

Price per unit, e.g. `$14.99/qt`, when shown.

datasponsoredProducts[]currency
string

Currency code, `USD`.

datasponsoredProducts[]rating
numbernullable

Average star rating out of 5; null with no reviews.

datasponsoredProducts[]reviewCount
integernullable

Number of reviews.

datasponsoredProducts[]sellerId
stringnullable

Seller id of the shown offer.

datasponsoredProducts[]sellerName
stringnullable

Seller of the shown offer.

datasponsoredProducts[]availability
stringnullable

Stock status, e.g. `IN_STOCK` or `OUT_OF_STOCK`.

datasponsoredProducts[]additionalOfferCount
integernullable

Other sellers' offers for the item, when the site counts them.

datasponsoredProducts[]isSponsored
boolean

Whether the card is a paid placement.

Badges on the card: `Rollback`, `Best seller` and more.

datasponsoredProducts[]badges[]key
stringnullable

Badge key, e.g. `ROLLBACK`.

datasponsoredProducts[]badges[]text
string

Badge text, e.g. `Rollback`.

datasponsoredProducts[]categoryPath
stringnullable

Category path, e.g. `Home Page/Home/Appliances`.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: more rows exist (see `totalResults`) but no further page can be read.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/walmart/category/products?category=5427_486190" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Walmart category products.