rei.com APIrei.com ↗
Search REI's catalog, browse categories, fetch product specs, check store availability, and retrieve customer reviews via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/b144cedc-d78a-4fc3-ad4f-c7479ad6fd67/get_category_products?page=1&pagesize=30&category_slug=camping-and-hiking' \ -H 'X-API-Key: $PARSE_API_KEY'
Get product listings for a specific category slug. Returns paginated JSON data including product results, facets, pagination info, and sorting options.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sortby | string | Sort order. Accepted values: 'relevance', 'title', 'title_r'. |
| pagesize | integer | Results per page. Accepted values: 30, 90. |
| category_slugrequired | string | Category slug from the REI URL path (e.g., 'camping-and-hiking', 'backpacking-tents', 'sleeping-bags'). Use get_category_navigation to discover available slugs. |
{
"type": "object",
"fields": {
"searchResults": "object containing results array, pagination, facets, query info, and menus"
},
"sample": {
"data": {
"searchResults": {
"query": {
"totalResults": 4933
},
"results": [
{
"brand": "Rumpl",
"title": "Original Puffy Blanket",
"prodId": "237298",
"rating": "4.7697",
"available": true,
"regularPrice": "199.95"
}
],
"pagination": {
"totalPages": 165
}
}
},
"status": "success"
}
}About the rei.com API
The REI.com API exposes 6 endpoints covering product search, category browsing, detailed specifications, store availability, and customer reviews from REI's outdoor gear catalog. get_product_detail returns brand info, media, features, specifications, and a review summary for any product by style number. search_products and get_category_products both support pagination and return facets alongside results, making it straightforward to build filtered browsing experiences.
Product Search and Category Browsing
search_products accepts a query string and optional page and pagesize parameters (30 or 90 results per page), returning a searchResults object that includes a results array, pagination info, facets, and menus. get_category_products works the same way but takes a category_slug — such as 'backpacking-tents' or 'sleeping-bags' — plus an optional sortby parameter accepting 'relevance', 'title', or 'title_r'. Use get_category_navigation (no inputs required) to retrieve the full category hierarchy, including slug, display label, product count, and nested subcategories, which you can then feed directly into get_category_products.
Product Detail and Reviews
get_product_detail takes a style_number — the prodId field surfaced in search and category results — and returns structured data including a brand object, media array with image paths, features array with ordered text items, specifications object with name/value pairs, and a reviewSummary covering total review count, overall rating, and a rating histogram. For full review content, get_product_reviews retrieves paginated Bazaarvoice review records per product: each review object includes id, title, rating, text, author, date, recommended, helpful_votes, and not_helpful_votes. Page size is configurable from 1 to 100.
Store Availability
get_store_availability checks in-store stock for a given style_number and optional zip_code, returning an availability object. This is useful when building applications that need to surface local pickup options alongside product detail pages.
- Build a gear comparison tool using
specificationsname/value pairs returned byget_product_detail. - Aggregate and display customer sentiment by pulling
rating,recommended, andhelpful_votesfromget_product_reviews. - Populate a category browsing UI with slugs and product counts from
get_category_navigation. - Surface local store stock checks by passing a zip code to
get_store_availability. - Index REI's outdoor catalog for a price-tracking or deal-alert service using paginated
search_productsresults. - Build a faceted search interface using the
facetsfield returned byget_category_products. - Pull product images for a curated gear guide using the
mediaarray fromget_product_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does REI have an official developer API?+
What does `get_product_detail` return beyond basic pricing?+
get_product_detail returns a brand object, an ordered features array, a specifications object with named attribute/value pairs, a media array of image paths, and a reviewSummary with overall rating and a per-star ratingHistogram. It does not expose variant-level inventory or color/size SKU breakdowns. You can fork this API on Parse and revise it to add a variant inventory endpoint.Are product variants (sizes, colors) exposed by the API?+
style_number. Variant-level attributes such as size availability or colorway-specific pricing are not currently returned as distinct fields. You can fork this API on Parse and revise it to add variant detail coverage.What pagination controls are available in search and category endpoints?+
search_products and get_category_products accept a page integer and a pagesize parameter with accepted values of 30 or 90. Pagination info is returned inside the searchResults object alongside the results array, so you can determine total pages without making an extra request.