Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · Walmart

    walmart.search

    The products on a page of Walmart's search results: prices, ratings, sellers, with advertisements marked.

    Id
    walmart.search
    Version
    1
    Billed per
    request — 1 unit for a charged run
    Runs
    within one request

    Start it with POST /v1/scrapers/walmart.search/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.

    Inputs

    The fields of input. A field that is not listed here is refused.

    Inputs of walmart.search
    FieldTypeDescription
    queryrequiredstringWhat to search for, e.g. "wireless mouse".Limit: at least 1 characters, at most 200 characters.
    pageintegerThe results page, from 1 (Walmart serves at most 25).Limit: 1 to 25. Default: 1.
    max_resultsintegerReturn at most this many items of the page; all of them when not given.Limit: 1 to 100.
    sort"best_match" | "price_low" | "price_high"Walmart's sort order.Default: "best_match".
    include_sponsoredbooleanFalse leaves the advertisements (sponsored: true) out.Default: true.
    • One run reads one page of results; ask for the next with page.

    Record fields

    Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.

    Record fields of walmart.search
    FieldTypeNotes
    item_idstringWalmart's item id (usItemId): the number at the end of the product's address.
    product_idstring or nullWalmart's internal product id.
    urlstring or nullThe product's address, without tracking parameters.
    titlestringAlways present.
    priceobject or nullThe price shown on the tile.
    amount (in price)numberThe amount as the page states it.
    currency (in price)string or nullThe currency code the page gives with the amount (USD on walmart.com); null when it gives none.
    was_priceobject or nullThe struck-through earlier price, when the tile shows one.
    amount (in was_price)numberThe amount as the page states it.
    currency (in was_price)string or nullThe currency code the page gives with the amount (USD on walmart.com); null when it gives none.
    ratingnumber or nullAverage rating, 0 to 5.
    review_countinteger or nullNumber of reviews.
    brandstring or nullBrand, when the results page states it (it usually does not; the product page does).
    seller_namestring or nullnull when not known.
    seller_idstring or nullnull when not known.
    availabilitystring or nullWalmart's availability code, e.g. IN_STOCK.
    in_stockboolean or nullnull when not known.
    fulfilment_typestring or nullWalmart's code for where the item ships from: STORE, FC (fulfilment centre) or MARKETPLACE.
    fulfilment_optionsarray of stringHow the item can be had: PICKUP, DELIVERY.
    sponsoredboolean or nullTrue for an advertisement (a sponsored placement), false for a result; null only when the page does not say.
    badgestring or nullThe label on the tile, e.g. Best seller, Rollback, Overall pick.
    imagestring or nullnull when not known.
    match"exact" | "related" or nullexact: Walmart lists the item as a result for the query; related: under "Other options to consider" (shown when few or no items match); null when the page does not say.
    positionintegerThe item's place among the returned items of this page, from 1.
    pageintegerThe results page the item was on.
    fetched_atstring (date-time)Always present.

    Example request

    Shell
    curl -X POST "https://api.enrichednow.com/v1/scrapers/walmart.search/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"query":"wireless mouse"}}'

    The body on its own:

    JSON
    {
      "input": {
        "query": "wireless mouse"
      }
    }

    Example response

    The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.

    JSON
    {
      "id": "run_6cce2b12aaf37a10b5e1b885",
      "scraper_id": "walmart.search",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "query": "wireless mouse"
      },
      "record_count": 1,
      "units": 1,
      "diagnostics": {
        "requests": 1,
        "bytes": 232779,
        "wall_ms": 565,
        "facts": {}
      },
      "created_at": "2026-11-16T20:27:29.009834Z",
      "started_at": "2026-11-16T20:27:29.013803Z",
      "finished_at": "2026-11-16T20:27:29.582787Z"
    }

    Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):

    JSON
    {
      "records": [
        {
          "item_id": "string",
          "product_id": null,
          "url": null,
          "title": "string",
          "price": null,
          "was_price": null,
          "rating": null,
          "review_count": null,
          "brand": null,
          "seller_name": null,
          "seller_id": null,
          "availability": null,
          "in_stock": null,
          "fulfilment_type": null,
          "fulfilment_options": [],
          "sponsored": null,
          "badge": null,
          "image": null,
          "match": null,
          "position": 0,
          "page": 0,
          "fetched_at": "2026-01-01T00:00:00Z"
        }
      ],
      "next_cursor": null
    }

    A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.