Walmart

Get Walmart product

Get a Walmart product with its price, seller, offers by condition, specifications, variants and rating.

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

API key (`sfk_...`)

Parameters
1
productIdstringrequiredquery

Walmart item id (`16101019327`) or product page URL (`https://www.walmart.com/ip/Beautiful-3-Qt-Air-Fryer/16101019327`).

min 1 chars · max 500 chars

Response fields
86

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Walmart has no product with this id.

one of: found, not_found

dataproductId
string

The item id asked for.

The product; null when not found.

dataproductid
string

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

dataproductproductId
stringnullable

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

dataproductname
string

Product name.

dataproducturl
stringnullable

Product page URL.

dataproductbrand
stringnullable

Brand name.

dataproductbrandUrl
stringnullable

Brand page URL.

dataproductmodel
stringnullable

Model number.

dataproductmanufacturerProductId
stringnullable

Manufacturer's part number.

dataproductupc
stringnullable

UPC barcode, when shown.

dataproductproductType
stringnullable

Walmart's product type, e.g. `Disposable Baby Diapers`.

dataproductdescription
stringnullable

Short description, plain text.

dataproductlongDescription
stringnullable

Full description, plain text.

Key facts the page highlights.

dataproducthighlights[]name
string

Label, e.g. `Brand`.

dataproducthighlights[]value
string

Value, e.g. `Beautiful`.

Specification table.

dataproductspecifications[]name
string

Label, e.g. `Brand`.

dataproductspecifications[]value
string

Value, e.g. `Beautiful`.

Product images, main first.

dataproductimageUrls[]
stringoptional

Category path, broadest first.

dataproductcategories[]id
stringnullable

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

dataproductcategories[]name
string

Category name.

dataproductcategories[]url
stringnullable

Category page URL.

dataproductrating
numbernullable

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

dataproductreviewCount
integernullable

Number of reviews.

dataproductcurrency
string

Currency code, `USD`.

dataproductprice
numbernullable

Price the shopper pays now, in `currency`.

dataproductpriceText
stringnullable

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

dataproductwasPrice
numbernullable

Earlier price the site shows struck through, when any.

dataproductlistPrice
numbernullable

List price, when shown.

dataproductunitPriceText
stringnullable

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

dataproductsavingsText
stringnullable

Saving the site shows, e.g. `SAVE $5.00`.

dataproductavailability
stringnullable

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

dataproductofferId
stringnullable

Id of the offer the page shows.

The seller of the offer the product page shows.

dataproductsellerid
stringnullable

Seller id.

dataproductsellername
stringnullable

Seller name, e.g. `Walmart.com`.

dataproductsellertype
stringnullable

`INTERNAL` for Walmart itself, `EXTERNAL` for a marketplace seller.

dataproductsellerurl
stringnullable

Seller's store page URL, when shown.

dataproductsellerrating
numbernullable

Seller's average rating out of 5; null when not shown.

dataproductsellerreviewCount
integernullable

Reviews of the seller; null when not shown.

dataproductisFulfilledByWalmart
booleannullable

Whether Walmart ships it for the seller.

The best offer in each condition the page offers.

dataproductconditionOffers[]offerId
stringnullable

Offer id.

dataproductconditionOffers[]condition
stringnullable

Condition, e.g. `New` or `Restored`.

dataproductconditionOffers[]price
numbernullable

Price in `currency`.

dataproductconditionOffers[]priceText
stringnullable

Price as shown.

dataproductconditionOffers[]availability
stringnullable

Stock status, e.g. `IN_STOCK`.

dataproductofferCount
integernullable

Offers for the item across every seller, the shown one included.

dataproductadditionalOfferCount
integernullable

Other sellers' offers beyond the shown one.

dataproductorderLimit
integernullable

Most a shopper may order at once.

dataproductreturnPolicy
stringnullable

Return policy as shown, e.g. `Free 90-day returns`.

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

dataproductbadges[]key
stringnullable

Badge key, e.g. `ROLLBACK`.

dataproductbadges[]text
string

Badge text, e.g. `Rollback`.

How the variants differ; empty when there are none.

dataproductvariantDimensions[]id
string

Dimension key, e.g. `actual_color`.

dataproductvariantDimensions[]name
stringnullable

Dimension name, e.g. `Actual Color`.

Values to choose from.

dataproductvariantDimensions[]values[]id
string

Value key, e.g. `actual_color-rose`.

dataproductvariantDimensions[]values[]name
stringnullable

Value name, e.g. `Rose`.

dataproductvariantDimensions[]values[]availability
stringnullable

Stock status of this value.

dataproductvariantDimensions[]values[]isSelected
boolean

Whether this value is the one the page shows.

dataproductvariantDimensions[]values[]swatchImageUrl
stringnullable

Swatch image URL, when shown.

Every variant; empty when there are none.

dataproductvariants[]id
stringnullable

Walmart item id of the variant.

dataproductvariants[]productId
string

Catalogue product id of the variant.

dataproductvariants[]name
stringnullable

Variant name.

dataproductvariants[]url
stringnullable

Variant page URL.

Its value keys, e.g. `actual_color-rose`.

dataproductvariants[]values[]
stringoptional
dataproductvariants[]price
numbernullable

Price in `currency`.

dataproductvariants[]priceText
stringnullable

Price as shown.

dataproductvariants[]availability
stringnullable

Stock status.

dataproductvariants[]imageUrl
stringnullable

Main image URL.

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/product?productId=16101019327" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Walmart product.