{ "openapi": "3.0.1", "info": { "title": "REI Product Scraper", "description": "Scrape live outdoor gear, apparel, and footwear listings from REI.com - search by keyword, browse by category or brand, or look up full product detail (price, member price, rating, images) by URL. No login required.", "version": "1.0", "x-build-id": "uJd8eheEOwmb1RuvS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~rei-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-rei-product-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/crawlerbros~rei-product-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-rei-product-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/crawlerbros~rei-product-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-rei-product-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browseByCategory", "browseByBrand", "productDetail" ], "type": "string", "description": "What to fetch from REI.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword search, e.g. `hiking boots`, `2-person tent`, `Patagonia jacket`.", "default": "hiking boots" }, "category": { "title": "Category (mode=browseByCategory, browseByBrand)", "enum": [ "Other", "hiking-boots", "winter-hiking-boots", "hiking-backpacks", "hiking-jackets", "hiking-pants", "hiking-shirts", "hiking-shorts", "hiking-socks", "trekking-poles-hiking-staffs", "backpacking-tents", "backpacking-packs", "camping-tents", "tents", "sleeping-bags", "sleeping-pads", "camp-kitchen", "camp-furniture", "camp-chairs", "coolers", "headlamps", "lanterns", "water-bottles", "portable-water-treatment", "climbing-shoes", "climbing-harnesses", "climbing-ropes", "climbing-helmets", "carabiners", "chalk-and-chalk-bags", "bouldering-crash-pads", "climbing-hardware", "climbing-packs", "mountaineering-boots", "mountaineering-tents", "crampons", "ice-axes-and-tools", "bikes", "mountain-bikes", "road-bike-helmets", "bike-helmets", "cycling-shoes", "cycling-clothing", "electric-bikes", "gravel-bikes", "hybrid-bikes", "cruiser-bikes", "bike-accessories", "bike-locks", "bike-lights", "kayaks", "kayaking", "paddleboards", "paddleboarding", "wetsuits", "dry-bags", "pfds", "kayak-paddles", "paddleboard-paddles", "dry-suits", "downhill-skis", "downhill-ski-boots", "backcountry-skis", "cross-country-skis", "snowboards", "snowboard-boots", "snowboard-bindings", "ski-helmets", "ski-goggles", "snowshoes", "snowshoeing", "splitboards", "snow-jackets", "snow-pants", "mens-running-shoes", "womens-running-shoes", "mens-trail-running-shoes", "womens-trail-running-shoes", "running-packs", "running-hydration-vests", "mens-hiking-shoes", "womens-hiking-shoes", "mens-boots", "womens-boots", "mens-sandals", "womens-sandals", "kids-shoes", "kids-boots", "mens-jackets", "womens-jackets", "mens-rain-jackets", "womens-rain-jackets", "mens-insulated-jackets", "womens-insulated-jackets", "mens-fleece-and-soft-shell-jackets", "womens-fleece-and-soft-shell-jackets", "base-layers", "mens-pants", "womens-pants", "mens-shorts", "womens-shorts", "mens-swimwear", "womens-swimwear", "mens-gloves-and-mittens", "womens-gloves-and-mittens", "sun-hats", "sunglasses", "backpacks", "travel-backpacks", "duffel-bags", "day-packs", "travel-daypacks", "kids-clothing", "kids-backpacks", "kids-bikes", "kids-sleeping-bags", "gps", "gps-sports-watches", "binoculars-and-optics", "satellite-communicators", "solar-chargers", "watches", "first-aid", "socks", "dog-gear" ], "type": "string", "description": "REI activity/product category to browse. Choose \"Other (type below)\" to enter any of REI's 400+ category slugs not listed here.", "default": "hiking-boots" }, "categoryOther": { "title": "Custom category slug (used when Category = \"Other\")", "type": "string", "description": "Any REI category slug not in the dropdown, e.g. `avalanche-safety-gear`, `bivy-sacks`, `camp-hydration`. Find the slug in a REI category page URL: rei.com/c/." }, "brand": { "title": "Brand (mode=browseByBrand)", "type": "string", "description": "Brand name to filter the selected category by, e.g. `Patagonia`, `Merrell`, `The North Face`, `Osprey`. REI does not offer a brand-wide catalog page, so brand browsing is scoped to a category.", "default": "Patagonia" }, "productUrls": { "title": "Product URLs (mode=productDetail)", "type": "array", "description": "REI product page URLs, e.g. `https://www.rei.com/product/237486/merrell-moab-3-mid-waterproof-hiking-boots-womens`.", "default": [], "items": { "type": "string" } }, "gender": { "title": "Gender filter", "enum": [ "Any", "Men's", "Women's", "Boys'", "Girls'", "Kids'", "Unisex" ], "type": "string", "description": "Restrict results to a gender/age category. Applied server-side via REI's own `r=gender:` facet (confirmed live to genuinely change the returned product set, e.g. men's vs. women's boots), not just a post-fetch filter — so this also reduces how many pages need to be fetched. Ignored for mode=productDetail (a single product lookup should not be excluded by a facet).", "default": "Any" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products cheaper than this." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products pricier than this." }, "minRating": { "title": "Min average rating (1-5)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop products rated below this." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only emit products currently discounted below the regular price (includes clearance and outlet).", "default": false }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "priceLowToHigh", "priceHighToLow", "ratingHighToLow", "mostReviewed", "newest", "bestselling", "percentOff", "brandAtoZ", "brandZtoA" ], "type": "string", "description": "Result sort order. Most options map to REI's own server-side `sort=` parameter (confirmed live), so REI returns pages already in that order across the whole category — not just a re-shuffle of whatever pages happened to be fetched. Exception: \"Most reviewed\" has no confirmed direct REI server key, so it stays a client-side re-sort of the fetched pages only.", "default": "relevance" }, "additionalFacets": { "title": "Additional REI facets (advanced)", "type": "array", "description": "Raw REI category facets as `facetKey:value` strings, appended to the category fetch on top of any brand/gender filters (works for Search, Browse by category, and Browse by brand; ignored for Product detail). REI's facet set is genuinely category-specific (hiking boots and tents expose different facets) so this is free text rather than a dropdown — use REI's own category filter sidebar to discover more. IMPORTANT: values are case-sensitive and must match REI's displayed filter label exactly (Title Case, spaces not hyphens) — `features:waterproof` returns nothing, `features:Waterproof` works. Confirmed-real examples: `features:Waterproof`, `features:Vegan`, `features:Top Rated`, `features:Insulated`, `features:New Arrivals` (hiking-boots); `features:Ultralight` (tents); `best-use:Hiking`, `best-use:Backpacking`, `best-use:Trail Running` (hiking-boots); `sustainability:bluesign` (lowercase — intentional), `sustainability:Recycled Materials`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 300, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy. The actor does not require a proxy for normal operation; you can enable the free Datacenter (AUTO) group if you see blocked runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }