{
  "openapi": "3.0.1",
  "info": {
    "title": "Walmart Reviews Scraper - All Reviews by URL, ID or Keyword",
    "description": "Scrape Walmart.com customer reviews for any product by URL, item ID, or keyword search. Deep-paginates every review - rating, title, text, author, verified-purchase, helpful votes, photos, pros/cons, and date - plus a per-product rating summary. MCP-ready. $0.003 per review.",
    "version": "0.1",
    "x-build-id": "svMZwUg7DDQ7NPOFY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~walmart-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-walmart-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/khadinakbar~walmart-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-walmart-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/khadinakbar~walmart-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-walmart-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "productUrls",
              "itemIds"
            ],
            "type": "string",
            "description": "How to choose which products to pull reviews for. 'search' runs a keyword search and harvests reviews for the top products (bounded by Max products). 'productUrls' pulls reviews for the exact Walmart product URLs you supply. 'itemIds' pulls reviews for raw numeric Walmart item IDs. Defaults to 'search'.",
            "default": "search"
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Free-text product query run on Walmart's search engine (e.g., 'airpods pro', 'instant pot duo 7-in-1'). Used only when mode = search; the top products (up to Max products) have their reviews scraped. Leave blank for productUrls / itemIds modes. NOT a product URL — for a specific product use productUrls."
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "Walmart product detail URLs to pull reviews for (e.g., 'https://www.walmart.com/ip/Apple-AirPods-Pro-2/1820546583'). Used when mode = productUrls. Each URL's reviews are deep-paginated up to Max reviews per product. The product page is only opened to resolve the item ID — the reviews come from Walmart's reviews surface.",
            "items": {
              "type": "string"
            }
          },
          "itemIds": {
            "title": "Walmart item IDs",
            "type": "array",
            "description": "Raw numeric Walmart item IDs to pull reviews for (e.g., '1820546583'). Used when mode = itemIds. Reviews are fetched directly from 'walmart.com/reviews/product/{itemId}'. Find the item ID at the end of a product URL. For full product fields (price, specs, variants) use the separate walmart-data-extractor actor.",
            "items": {
              "type": "string"
            }
          },
          "maxProducts": {
            "title": "Max products (search mode)",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Upper bound on how many products from the keyword search have their reviews scraped. Applies only to mode = search; productUrls / itemIds modes scrape every product you supply. The prefill is intentionally small so Apify health checks finish fast — raise it for production. Hard cap 200.",
            "default": 10
          },
          "maxReviewsPerProduct": {
            "title": "Max reviews per product",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Upper bound on reviews scraped per product (each review is $0.003). Reviews deep-paginate newest-first by default until this cap or the product runs out of reviews. Default 100, hard cap 1000. Set lower to sample recent sentiment cheaply; raise for a full review corpus.",
            "default": 100
          },
          "sortReviews": {
            "title": "Sort reviews",
            "enum": [
              "mostRecent",
              "mostHelpful",
              "highestRating",
              "lowestRating",
              "mostRelevant"
            ],
            "type": "string",
            "description": "Order in which reviews are collected per product. 'mostRecent' (default) returns newest first — best for monitoring fresh sentiment. 'mostHelpful' returns the highest-voted reviews. 'highestRating' / 'lowestRating' surface the best/worst first. 'mostRelevant' uses Walmart's default ranking.",
            "default": "mostRecent"
          },
          "ratingFilter": {
            "title": "Star rating filter",
            "enum": [
              "all",
              "5",
              "4",
              "3",
              "2",
              "1"
            ],
            "type": "string",
            "description": "Keep only reviews with this exact star rating. 'all' (default) keeps every rating. '5'..'1' keep only that star bucket — useful for mining 1-star complaints or 5-star praise. Applied client-side so it is always exact regardless of Walmart's own filters.",
            "default": "all"
          },
          "includeProductSummary": {
            "title": "Include product summary row",
            "type": "boolean",
            "description": "When true (default), emit one aggregate row per product (tagged _type='product') with the overall rating, total review count, and 1-5 star histogram, alongside the individual review rows. Charged at $0.001 per product. Turn off to receive only individual review records.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy configuration. Defaults to Apify Residential pinned to US — required because Walmart geo-locks content and runs Akamai + PerimeterX anti-bot. Override only if you have a specific reason (e.g., your own residential pool). Datacenter proxies are blocked by Walmart.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "US"
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}