Walmart Search API — Local Prices & Listings

At a glance

• Collect: One store-scoped listing page for each keyword.
• Input: use the runnable example below or the prefilled Input form.
• Output: the default dataset supports JSON/CSV/Excel export; see output modes below.
• Billing: $2 per 1,000 successful keyword requests, including all exported rows for each request. No startup fee. Platform usage may be additional.
• Limits: No supported page-number input. hasMorePages does not mean this Actor can retrieve every page.

Search Walmart US by keyword and store or ZIP. Get product IDs, prices, ratings, sellers, fulfillment and sponsored flags. One request includes all returned listings.

Quick start

{
  "queries": [
    "milk"
  ],
  "storeId": "1735",
  "maxRequests": 1
}

Provide exactly one of storeId or zipcode. Keep ZIP codes as strings. Inputs are validated before any request. Duplicate inputs are skipped, and maxRequests caps unique requests per run.

Output and exports

Results are stored in the default dataset, exportable as JSON, CSV or Excel. Store context and UTC fetch timestamps accompany records. SUMMARY in the key-value store reports successful requests, results, safe failures and budget stops. Partial batches retain completed results.

Billing

Launch price: $2 per 1,000 successful keyword requests, including valid empty searches. All delivered listings from that request are included; this is not per-result billing. No startup fee or monthly rental. Failed or invalid responses are not billed. Consult the live Pricing tab for current pricing and platform terms. Set a maximum total charge per run to control spending.

Limitations

The current service returns one results page per keyword. Pagination indicators are preserved, but this Actor does not promise to retrieve additional pages. Sponsored filtering and a per-query row cap are supported; these do not reduce the number of billed requests. No product-detail enrichment or review text is included.

Prices and availability are point-in-time signals for the returned store context, not guaranteed checkout prices or verified stock quantities. Availability depends on Walmart and supported store coverage. No Walmart login or customer API key is required.

Support

Open an issue with your run ID, input example and expected behavior—never include credentials. For custom integrations or other data needs, contact the developer through the profile contact details.

Independent tool, not affiliated with or endorsed by Walmart.

Minimal API example

Store your own Apify token in APIFY_TOKEN; never paste it into public input or code. This example uses the same small input as the prefilled form.

import os
import requests

response = requests.post(
    "https://api.apify.com/v2/acts/gauravlabs~walmart-search-api/run-sync-get-dataset-items",
    headers={"Authorization": "Bearer " + os.environ["APIFY_TOKEN"]},
    json={"queries":["milk"],"storeId":"1735"},
    timeout=300,
)
response.raise_for_status()
print(response.json())

For large batches, start an asynchronous run with /runs, wait for its final status, and retrieve its default dataset. HTTP success when starting a run does not prove the extraction succeeded.

Minimal output shape (illustrative)

The following shows one documented field, not a fresh result or a promised yield. Inspect the output reference above for the complete schema.

{
  "stockStatus": "unknown"
}

Practical workflow and accuracy notes

The endpoint documents no page-number parameter. page, totalPages and hasMorePages are descriptive metadata, not a guarantee of pageable coverage. maxResultsPerQuery caps saved rows, not retrieval size. Take an item_id into our Walmart Product API for detail enrichment using the same store. requestRetries defaults to one bounded retry; a successful keyword is charged once, not once per attempt.