Walmart

Search Walmart products

Search Walmart products by keyword, with prices, ratings, sellers and paging.

GET/v1/walmart/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

Words to search for, up to 200 characters (`air fryer`).

min 1 chars · max 200 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
62

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The words searched for.

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.

Related searches the site suggests.

datarelatedSearches[]
stringoptional

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/search?query=air%20fryer" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Walmart product search results.