{
  "openapi": "3.0.1",
  "info": {
    "title": "Scrape Walmart Products",
    "description": "Scrape Walmart products by search query or URL. Get pricing, stock, ratings, seller info, images, and full product details via API, no browser needed. Variations included free.",
    "version": "0.1",
    "x-build-id": "B7ivewROuqrOPaGMy"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/mof1re~walmart-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-mof1re-walmart-products-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/mof1re~walmart-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-mof1re-walmart-products-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/mof1re~walmart-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-mof1re-walmart-products-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",
              "product"
            ],
            "type": "string",
            "description": "Search Mode runs search queries and returns matching products. Product Mode fetches full detail for specific product URLs/IDs directly.",
            "default": "search"
          },
          "searchQueries": {
            "title": "🔎 Search queries",
            "type": "array",
            "description": "Search terms to run on Walmart. Used only in Search Mode.",
            "items": {
              "type": "string"
            }
          },
          "maxPages": {
            "title": "📄 Max pages per query",
            "type": "integer",
            "description": "How many search result pages to fetch for each query. Used only in Search Mode.",
            "default": 1
          },
          "enrichProductData": {
            "title": "✨ Enrich product data",
            "type": "boolean",
            "description": "Visit each product found in the search results to fetch full product detail (specs, description, full review summary) and product variations(no additional charge for vars, separate dataset). Each result page is fully enriched before moving to the next. Used only in Search Mode.",
            "default": false
          },
          "sorting": {
            "title": "↕️ Sort by",
            "enum": [
              "price_low",
              "price_high",
              "best_seller",
              "rating_high",
              "new"
            ],
            "type": "string",
            "description": "Order in which search results are returned. Leave empty for Relevancy. Used only in Search Mode."
          },
          "offersFilters": {
            "title": "🏷️ Special offers",
            "type": "array",
            "description": "Only include products with these special offers. Leave empty for no filter. Used only in Search Mode.",
            "items": {
              "type": "string",
              "enum": [
                "special_offers:Rollback",
                "special_offers:Clearance",
                "special_offers:Reduced Price"
              ],
              "enumTitles": [
                "📉 Rollback",
                "🧹 Clearance",
                "💰 Reduced Price"
              ]
            },
            "default": []
          },
          "ratingFilter": {
            "title": "⭐ Customer rating",
            "type": "array",
            "description": "Only include products with these customer rating ranges. Leave empty for no filter. Used only in Search Mode.",
            "items": {
              "type": "string",
              "enum": [
                "customer_rating:3 - 3.9 Stars",
                "customer_rating:4 - 5 Stars"
              ],
              "enumTitles": [
                "⭐ 3 - 3.9 stars",
                "⭐ 4 - 5 stars"
              ]
            },
            "default": []
          },
          "retailerType": {
            "title": "🏪 Retailer type",
            "type": "array",
            "description": "Only include products sold by these seller types. Leave empty for no filter. Used only in Search Mode.",
            "items": {
              "type": "string",
              "enum": [
                "retailer_type:Walmart",
                "retailer_type:Pro Sellers",
                "retailer_type:Marketplace Sellers fulfilled by Walmart"
              ],
              "enumTitles": [
                "🏬 Walmart",
                "🤝 Pro Sellers",
                "📦 Marketplace (fulfilled by Walmart)"
              ]
            },
            "default": []
          },
          "productUrls": {
            "title": "🔗 Product URLs or IDs",
            "type": "array",
            "description": "Walmart product URLs or numeric item IDs to fetch full detail for. Used only in Product Mode.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}