INQUIRE NOW
INQUIRE NOW
REST API · Structured JSON · Walmart marketplace data

Walmart Product Data API

Send a Walmart product URL or a search query to one REST endpoint and get structured JSON back — title, brand, price, rating, availability, seller and more. No proxies to rotate, no headless browsers to run and no HTML to parse. Use the data to feed pricing models, catalogue tools, dashboards and market research.

  • Product, brand and category data
  • Price, currency and discount fields
  • Ratings and review counts
  • Availability and seller fields
  • Marketplace targeting by country
  • Scheduled monitoring with webhooks
/v1/productIllustrative sample
# Request (replace the key and URL with your own)
POST https://api.webfusiondata.com/v1/product
Authorization: Bearer $WFD_API_KEY

{ "url": "https://www.walmart.com/ip/example-product/EXAMPLE123",
  "country": "US" }

# Response (sample data, not a live listing)
{
  "item_id": "EXAMPLE123",
  "marketplace": "US",
  "title": "Example Product",
  "price": { "amount": 49.99, "currency": "USD" },
  "availability": "Available",
  "rating": 4.5,
  "product_url": "https://www.walmart.com/"
}

Sample values for illustration only. Exact field names and nesting for your Walmart scope are confirmed in the API reference issued with your key.

How to read this page: Documented = described on our Ecommerce Scraping API page; Illustrative = sample data or example code, not live output; Confirm at onboarding = depends on your Walmart scope and is settled with our team before you build on it.

What Is the Walmart Product Data API?

A Walmart Product Data API lets your software request information about Walmart listings and receive it as structured data instead of a web page. You send a product URL or a search query plus a marketplace, and get JSON with named fields such as title, brand, price, rating, availability and seller. Every response follows the same schema, so it can go straight into a database, dashboard or pricing model.

Behind that request sits a collection process: our infrastructure loads the listing, handles proxies and CAPTCHAs, renders JavaScript, extracts fields with site-specific parsers and validates them before anything is returned. Larger jobs run asynchronously, with results sent to a webhook or storage bucket. You work with the API; we operate the collection layer.

Teams use the data for pricing analysis, competitor research, catalogue management and market intelligence. Our price monitoring and price intelligence services build on this kind of data.

How the Walmart API Works

Six steps from choosing a marketplace to using the data in your own systems.

Your application WebFusion Data API Collection & parsing layer Validated JSON Database · dashboard · app
1

Select marketplace and data

Decide which Walmart marketplace you need and what you are looking up: a product page, a URL built from an item ID, or a keyword search.

List the fields you need now, so the scope can be confirmed against what the marketplace exposes.

2

Configure the request

Build a JSON body with url (or site and query) and an optional country.

Pick the endpoint: /v1/product for one listing, /v1/search for result lists, /v1/monitor for scheduled tracking, /v1/bulk for batches.

3

Authenticate

Pass your API key as a bearer token in the Authorization header.

Start in the sandbox, which returns sample responses, so you can test your integration before spending live request credits.

4

Process and retrieve

Our infrastructure fetches the listing, renders it, extracts the fields and validates them. Single lookups return synchronously.

Bulk jobs return a job ID you can check with /v1/status/:job_id or receive through a webhook.

5

Receive structured data

JSON is the default response format. Bulk export jobs can also be delivered as CSV or XLSX.

Each record carries a capture timestamp (crawled_at) so you always know how fresh the values are.

6

Integrate into your systems

Write results to a database, load them into a BI dashboard, trigger alerts from webhooks or schedule recurring checks with monitors.

See Integration and Data Delivery for a worked example.

Key Walmart API Features

What the Walmart Product Data API does in practice, and how much of it is already documented versus settled per project.

PD

Product, brand and category data

Returns the core listing record: title, brand, category, images and the specification table. Use it to build or audit a catalogue, group results by brand and map Walmart listings to your own taxonomy.

Documented
ID

Item ID-based product lookup

The Walmart item ID is the number at the end of every product URL (/ip/…/ITEM_ID), so a list of item IDs can be turned into product URLs and submitted. The identifier is returned in the response for matching.

URL-based: documentedDedicated item ID parameter: confirm
$

Price and discount monitoring

Captures displayed price, currency and discount, and can register a listing for scheduled checks with a webhook when a value changes. Useful for repricing inputs and promotion tracking.

Documented
★

Ratings and review data

Returns the aggregate rating and review count for each listing, so you can compare quality signals across competing products and track movement over time.

Rating & count: documentedReview text: confirm
SL

Seller and offer information

Returns the seller and fulfilment method behind a listing where displayed. Helps identify who is selling a product and how it is fulfilled.

Seller & fulfilment: documentedFull offer lists: confirm
AV

Product availability data

Returns the displayed stock status and, where exposed, a quantity signal. Supports out-of-stock alerts and availability reporting.

Documented
MP

Marketplace-specific data access

A country parameter localises the request, so prices, currency and availability reflect the marketplace you target rather than a single default.

Country parameter: documentedMarketplace list: confirm
JS

Structured API responses

Fields are type-checked and normalised into a consistent schema, with automated checks that catch malformed responses before they reach you.

Documented
AU

Automated data delivery

Schedule recurring monitors, receive webhook callbacks, or request bulk exports to cloud storage, so data arrives without manual pulls.

Documented

Walmart Product Data Fields

The fields the Walmart product data extraction returns, what each one means and what teams do with it. Field availability follows what the listing displays on the selected marketplace.

Data FieldDescriptionBusiness ApplicationAvailability
item_idWalmart item ID, the numeric identifier at the end of the product URLProduct identification, de-duplicationCore
titleName of the listed productCatalogue managementCore
brand / categoryBrand and category shown on the listingBrand analysis, category benchmarkingCore
price.amount / price.currencyDisplayed price and its currencyPrice comparison, repricing inputsCore
discountDisplayed discount and list pricePromotion analysisWhere displayed
rating / review_countStar rating and number of reviewsProduct research, sentiment analysisWhere displayed
reviews (text)Individual review contentSentiment and NLP pipelinesConfirm at onboarding
seller / fulfillment_typeSeller and fulfilment method on the listingSeller researchWhere available
availability / stock_qtyDisplayed stock status and quantity signal where exposedAvailability monitoringCore
buy_box / offersBuy Box holder and competing offersOffer comparisonConfirm at onboarding
product_url / marketplaceListing URL and the marketplace it came fromReference and validationCore
crawled_atTimestamp of data captureFreshness checks, time seriesCore

Core = part of the standard field set on our ecommerce API. Where displayed / available / exposed = returned when the listing on that marketplace shows it, so it can be empty for some products. Confirm at onboarding = settled per project. Images and specification tables are also returned. Field names are illustrative; your API reference is the source of truth.

Walmart API Endpoints and Request Parameters

The Walmart Product Data API uses the same versioned endpoints as the Ecommerce Scraping API. Walmart-specific parameter names that are not yet published are marked as illustrative.

EndpointPurposeParametersExpected response
POST /v1/product
Documented
Structured data for a single product URL: price, availability, rating and the full attribute set. Required: url
Optional: country; a dedicated item_id field is a confirm
One JSON product record, returned synchronously.
POST /v1/search
Documented
Keyword or category search on a target site, returned as a structured result list. Required: site (e.g. "walmart"), query
Optional: country
JSON with query, result_count and a results array.
POST /v1/monitor
Documented
Registers a listing for scheduled price and stock monitoring with webhook notifications. Required: url
Optional: webhook URL and check frequency names: confirm
A monitor ID you use to read tracked data later.
GET /v1/monitor/:id
Documented
Latest tracked data and change history for one monitored product. Required: id (path) JSON with the current values and recorded changes.
POST /v1/bulk
Documented
Submits a batch of URLs for asynchronous processing; results go to storage or a webhook. Required: list of URLs
Optional: delivery destination and format (JSON, CSV or XLSX) names: confirm
A job ID, then results via webhook or storage export.
GET /v1/status/:job_id
Documented
Status and progress of an asynchronous crawl or bulk export. Required: job_id (path) JSON with job state and progress.

Common validation errors

SituationTypical HTTP statusHow to fix it
Missing or malformed url400Send a full product URL on a Walmart marketplace you have scoped, including the https:// prefix.
Unsupported site or country value400 / 422Check site and country against the marketplaces confirmed for your account.
Missing or invalid API key401Send Authorization: Bearer <key> and check the key belongs to the right environment (sandbox or live).
Listing not found or no longer available404 or an empty recordVerify the item ID and marketplace; the product may be removed or unavailable in that country.
Request limit exceeded429Wait, then retry with backoff. Response headers show your remaining quota for the window.
Temporary processing failure5xxRetry with exponential backoff; for large volumes use /v1/bulk instead of many synchronous calls.

Status codes follow common REST conventions (429 is the one shown in our published dashboard example). The exact codes and error bodies are listed in the API reference supplied with your key.

Sample API Request and JSON Response

Two common calls and what comes back. Illustrative sample data — not live product information.

1 · Look up one product
curl -X POST https://api.webfusiondata.com/v1/product \
  -H "Authorization: Bearer $WFD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.walmart.com/ip/example-product/EXAMPLE123",
    "country": "US"
  }'
2 · Search Walmart by keyword
curl -X POST https://api.webfusiondata.com/v1/search \
  -H "Authorization: Bearer $WFD_API_KEY" \
  -d '{"site": "walmart", "query": "wireless earbuds", "country": "US"}'
Parameters used: url or site + query select what to fetch; country selects the marketplace. The key stays in an environment variable — never hard-code it or ship it in client-side code.
Response to request 1Illustrative
{
  "item_id": "EXAMPLE123",
  "marketplace": "US",
  "title": "Example Product",
  "brand": "Example Brand",
  "price": { "amount": 49.99, "currency": "USD" },
  "discount": { "percent": 17, "list_price": 59.99 },
  "availability": "Available",
  "rating": 4.5,
  "review_count": 1280,
  "seller": "Example Seller",
  "product_url": "https://www.walmart.com/",
  "crawled_at": "2026-01-15T09:30:00Z"
}
Response to request 2Illustrative
{
  "query": "wireless earbuds",
  "result_count": 48,
  "results": [
    { "title": "Example Product", "price": 79.99,
      "rating": 4.6, "in_stock": true }
  ]
}

The generic search sample on our Ecommerce Scraping API page uses a flat price number and an in_stock flag, while the product example above nests price under an object. The final Walmart schema is confirmed in your API reference.

Supported Walmart Marketplaces

Choose the marketplace with the country parameter. We do not claim global coverage: the marketplaces available to you are confirmed during onboarding, and requests outside that list are rejected rather than guessed.

MarketplaceWalmart domainLocal currencyStatus for the API
United Stateswalmart.comUSDWalmart listed among covered domains
Canadawalmart.caCADConfirm at onboarding
Mexicowalmart.com.mxMXNConfirm at onboarding

This is a reference list of well-known Walmart marketplaces, not a coverage guarantee. Need another marketplace? Tell us and we will confirm feasibility.

Why it matters: the marketplace you choose sets the currency, which products are available, the language of titles and categories, and which optional fields (seller, fulfilment, discount) appear. Walmart prices and pickup or delivery availability can also vary by store or delivery location, so tell us if you need store- or ZIP-level data. Read each response per marketplace.

Country-focused service: USA.

Authentication, Rate Limits and Error Handling

What is published today, and what we give you in writing before you go live. We do not publish numeric limits, latency or uptime figures on this page.

TopicHow it worksStatus
AuthenticationYour API key is sent as a bearer token in the Authorization header. Use the sandbox key while testing.Documented
Limits and concurrencyPer-minute limits and concurrent-request allowances scale with your plan; response headers show your remaining quota. Use /v1/bulk for very large volumes.DocumentedNumbers: your plan
Validation and errorsMalformed or missing parameters are rejected with a standard HTTP error (see Endpoints), and responses are schema-checked before delivery.Exact codes: API reference
Timeouts and retriesSet a client timeout and retry reads on 429 and 5xx with exponential backoff. Move long work to /v1/bulk and /v1/status/:job_id, and avoid blind retries of POST /v1/monitor or /v1/bulk.Recommended practice
PaginationSearch returns a result_count and result list. Pagination for deeper results is scoped per project.Confirm at onboarding
Usage monitoringAn account dashboard shows request volume, latency, success rate and job status.Documented

Integration and Data Delivery

Connect the API to ecommerce applications, internal databases, BI dashboards, reporting systems and analytics pipelines. The pattern is the same each time: a request layer, a place to store results and a schedule.

Integration workflow

1

Scope and test

Agree marketplaces, fields and refresh frequency, then call the sandbox with a few sample products.

2

Build the request layer

Put authentication, timeouts and retry backoff in one small client module your whole team reuses.

3

Store the results

Upsert records by item ID and marketplace, and keep every crawled_at timestamp to build a time series.

4

Schedule and alert

Use monitors and bulk jobs, act on webhooks, and connect the table to your dashboards and reports.

Example: fetch a product and store its price Illustrative

Python · requests + sqlite3
import os, sqlite3, requests

API = "https://api.webfusiondata.com/v1/product"
HEADERS = {"Authorization": f"Bearer {os.environ['WFD_API_KEY']}"}

def fetch(item_id):
    body = {
        "url": f"https://www.walmart.com/ip/{item_id}",
        "country": "US",
    }
    r = requests.post(API, json=body, headers=HEADERS, timeout=60)
    r.raise_for_status()
    return r.json()

db = sqlite3.connect("walmart_prices.db")
db.execute("CREATE TABLE IF NOT EXISTS prices "
           "(item_id TEXT, amount REAL, currency TEXT, at TEXT)")

for item_id in ["EXAMPLE123"]:
    item = fetch(item_id)
    db.execute("INSERT INTO prices VALUES (?, ?, ?, ?)", (
        item["item_id"],
        item["price"]["amount"],
        item["price"]["currency"],
        item.get("crawled_at"),
    ))
db.commit()

Delivery options

JSON

Default response format for every endpoint.

Documented

CSV, Excel and cloud storage

Bulk export jobs delivered as CSV or XLSX to S3, GCS or your own bucket.

Documented

Webhooks and scheduled monitors

Callbacks when a job completes or a tracked value changes, plus recurring checks through /v1/monitor.

Documented

Database push, SDKs and no-code

Managed warehouse connectors, client libraries and no-code paths.

Languages: confirm

Listed on the Ecommerce Scraping API page; availability for your Walmart scope is confirmed during onboarding. See also the AI Parser and ecommerce datasets. Related: product availability and MAP monitoring.

FAQs

Walmart Product Data API Frequently Asked Questions

What is the Walmart Product Data API?

It is a REST API from WebFusion Data that returns structured JSON for Walmart listings. You send a product URL, or a search query and a marketplace, and receive fields such as title, price, rating and availability. It runs on the same endpoints and infrastructure as our Ecommerce Scraping API, so you do not run proxies, browsers or parsers yourself.

What product information can it provide?

Core fields include item ID, title, brand, category, price and currency, availability, images, specifications, product URL, marketplace and a capture timestamp. Discount, rating, review count, seller, fulfilment type and a quantity signal are returned where the listing displays them. Review text, Buy Box ownership and full offer lists are confirmed per project. The data fields table shows each one.

Can I retrieve product data using an item ID?

Yes, through the product URL. The Walmart item ID is the number at the end of every product link (/ip/…/ITEM_ID), so you build the URL from your item ID and submit it to /v1/product, with the site in country. The item ID is returned in the response so you can match records. Whether a dedicated item-ID-only parameter, or lookup by UPC, is available is confirmed at onboarding.

Does it support price monitoring and historical prices?

Yes. POST /v1/monitor registers a listing for scheduled price and stock monitoring with webhook notifications, and GET /v1/monitor/:id returns the latest tracked data and change history. Frequency and volume are scoped to your project. Change history is recorded from the time you register a product; earlier history is not assumed, so ask if you need a backfill, or store each response with its crawled_at timestamp to build your own series.

Does it provide seller and Buy Box data?

Seller and fulfilment type are returned where the listing displays them. Buy Box ownership and competing offers depend on the marketplace and on your scope, and the Buy Box can change between checks, so we confirm availability and the right monitoring frequency with you before you build on it.

Which Walmart marketplaces are supported?

We do not claim global coverage. The country parameter selects the marketplace; Walmart is listed among the domains our Ecommerce Scraping API covers, and the sites and countries available to you are confirmed during onboarding. Tell us which marketplaces you need and we will confirm each one. See supported marketplaces.

How does API authentication work?

Each request carries your API key as a bearer token in the Authorization header. Every account includes a sandbox for testing with sample responses. Keep the key on your server, in an environment variable or secrets manager, and never in client-side code.

Which response formats are available?

JSON is the default for all endpoints. Bulk export jobs can also be delivered as CSV or XLSX, to S3, GCS or your own bucket. Webhooks, SDKs and database push options are described in Integration and Data Delivery.

How can I request API access?

Use the Request API Demo button or the form below and tell us the marketplaces, product volume, fields, refresh frequency and delivery format you need. We confirm the scope and set up access, including the sandbox. You can also email sales@webfusiondata.com or book a consultation.

Question mark illustration

Contact Us Now!

At WebFusionData, we specialize in cutting-edge web scraping solutions to help you unlock valuable insights and drive business growth. Whether you need custom data extraction, real-time monitoring, or large-scale web scraping, our team is here to assist you.

FAQ Illustration

Get In Touch

Ready to get started? Contact us for a personalized quote.