# Scrapier — Walmart API > Scrapier endpoints for Walmart: Walmart Category, Walmart Data Extractor, Walmart Reviews, Walmart Search Scraper. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/walmart.md ## GET /walmart-category/ Walmart Category: Structured Walmart data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - urls (required, string, example 3944): Walmart category URL or bare category id. Required on the first call; list -> first only. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort (optional, string, one of: best_match|price_low|price_high|best_seller|top_rated|new, default best_match, locked in cursor): - min_price (optional, integer, locked in cursor): - max_price (optional, integer, locked in cursor): - refinement (optional, string, locked in cursor): Facet token(s) e.g. brand:Apple. - zip_code (optional, string, locked in cursor): Resolved to a store on page 1. - state (optional, string, locked in cursor): - store_id (optional, string, locked in cursor): - country (optional, string, one of: US|CA, default US, locked in cursor): - strict_price_filter (optional, boolean, default true, locked in cursor): - include_brand (optional, boolean, default false, locked in cursor): Per-product brand lookup (one extra product-page request per row; heavy, default off). - include_reviews_count (optional, boolean, default false, locked in cursor): - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/walmart-category/?urls=3944" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/walmart/walmart-category.md ## GET /walmart-data-extractor/ Walmart Data Extractor: Structured Walmart data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - urls (required, string, example laptop): Walmart listing (/search?q=, /browse/, /shop/) or product (/ip/) URL, or a plain keyword. Required first call. One listing page (~40-60 products, each enriched from its product page; detail_fetched=false if that missed the time budget) per call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include_details (optional, boolean, default false, locked in cursor): Also fetch each product page (seller, UPC, variants, full description). Much heavier; default false returns listing-card data. - include_reviews (optional, boolean, default false, locked in cursor): Attach reviews to each product. - zip_code (optional, string, locked in cursor): 5-digit US delivery ZIP hint. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/walmart-data-extractor/?urls=laptop" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/walmart/walmart-data-extractor.md ## GET /walmart-reviews/ Walmart Reviews: Structured Walmart data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.rating_filter Parameters: - urls (required, string, example https://www.walmart.com/ip/Apple-AirPods-4/11381374703): Walmart product URL (/ip//), reviews URL (/reviews/product/), bare item id, or search/browse URL (walks its first `max_products` items). Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - reviews_sort_type (optional, string, one of: relevancy|helpful|submission-desc|submission-asc|rating-desc|rating-asc, default relevancy): Review sort. Locked into the cursor. - rating_filter (optional, string): Only reviews with these star ratings, e.g. '5' or '1,2' (default: all). Locked into the cursor. - max_products (optional, integer, default 20): Search/browse URL input only: products walked (max 40). Locked into the cursor. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/walmart-reviews/?urls=https%3A%2F%2Fwww.walmart.com%2Fip%2FApple-AirPods-4%2F11381374703" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/walmart/walmart-reviews.md ## GET /walmart-search-scraper/ Walmart Search Scraper: Structured Walmart data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.products Parameters: - queries (required, string, example lego star wars): Search keyword or Walmart /search?q= URL. Required on the first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort (optional, string, one of: best_match|price_low|price_high|best_seller|new|rating_high, default best_match, locked in cursor): Result sort order. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/walmart-search-scraper/?queries=lego+star+wars" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/walmart/walmart-search-scraper.md