gap.com APIgap.com ↗
Access Gap.com product search, category browsing, product details, customer reviews, store finder, recommendations, and navigation via a single API.
curl -X GET 'https://api.parse.bot/scraper/0b7da48b-19ee-4b5e-9262-531ac2c04c30/search_products?page=0&query=shirt' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword. Returns paginated product listings including names, prices, color swatches, and review scores.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| limit | integer | Number of products per page |
| queryrequired | string | Search keyword (e.g. 'jeans', 'shirt') |
{
"type": "object",
"fields": {
"products": "array of product objects with id, name, priceRange, reviewScore, reviewCount, colors",
"pagination": "object containing pageSize, currentPage, pageNumberTotal",
"totalProducts": "string total number of products matching the query"
},
"sample": {
"data": {
"products": [
{
"id": "728822",
"name": "High Rise ’90s Slim Straight Jeans",
"colors": [
{
"id": "728822002",
"regularPrice": "89.95",
"effectivePrice": "89.95",
"shortDescription": "New medium wash"
}
],
"priceRange": [
"79.95",
"119.95"
],
"reviewCount": 3380,
"reviewScore": 4.33
}
],
"pagination": {
"pageSize": 120,
"currentPage": 0,
"pageNumberTotal": 7
},
"totalProducts": "773"
},
"status": "success"
}
}About the gap.com API
The Gap.com API covers 7 endpoints that expose Gap's full product catalog, store locations, and site navigation. The search_products endpoint returns paginated listings with price ranges, review scores, and color swatches for any keyword query. Additional endpoints handle category browsing by CID, detailed product data, customer reviews, store lookup by ZIP code, related product recommendations, and the complete category tree.
Product Search and Category Browsing
The search_products endpoint accepts a required query string plus optional page (0-indexed) and limit parameters. Each product object in the response includes id, name, priceRange, reviewScore, reviewCount, and a colors array. A pagination object (pageSize, currentPage, pageNumberTotal) and a totalProducts string let you page through large result sets. For browsing by department instead of keyword, get_category_products takes a cid string (for example, '5664' for Women's Jeans) and returns a categories array with categoryId, categoryName, and a ccList of color variants, alongside a totalColors count.
Product Details and Reviews
get_product_details takes a pid string and returns id, brand, title, description, and productName for the matched item. For review data, get_product_reviews accepts a style-level pid (e.g., '728822' rather than a full product ID) and returns a paging object with total_results, pages_total, page_size, and current_page_number, plus a results array that includes both rollup statistics and individual review records.
Stores, Recommendations, and Navigation
find_stores takes a zip parameter and returns an array of store objects, each containing id, storeName, address, phoneNumber, hours, distance, latitude, and longitude. get_recommendations accepts a product pid and returns recommendation_containers, each group carrying a model_type, model_copy label (such as 'Customers also viewed'), and a recommended_products array. Finally, get_navigation requires no inputs and returns the full category tree — id, name, type, and recursive children with link values — covering all divisions like Women, Men, Girls, and Boys.
- Build a Gap product search widget that surfaces price ranges and review scores by keyword.
- Sync a product catalog tool with Gap category listings using CID-based pagination from
get_category_products. - Display customer review summaries and ratings on a fashion comparison site using
get_product_reviews. - Power a store-locator feature by querying
find_storeswith a user's ZIP code to show nearby Gap locations with hours and distance. - Drive a 'You might also like' recommendation rail by feeding
get_recommendationsoutput into a product detail page. - Map Gap's full department and subcategory structure by parsing the
childrentree fromget_navigationto build faceted browsing. - Track price range changes for specific Gap product IDs over time using
get_product_details.
| 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 Gap have an official public developer API?+
What does `get_product_reviews` return and how is it paginated?+
get_product_reviews accepts a style-level pid (not a full product ID) and an optional 0-indexed page parameter. The response includes a paging object with total_results, pages_total, page_size, and current_page_number, plus a results array containing both aggregate rollup stats and individual review records with ratings and comments.Does `get_product_details` return available sizes or inventory levels?+
get_product_details endpoint currently returns id, brand, title, description, and productName. Size availability and inventory levels are not included in the current response shape. You can fork this API on Parse and revise it to add an endpoint that surfaces size and inventory data.How do I find the category ID (CID) to use with `get_category_products`?+
get_navigation first — it returns the full category tree with id fields at each node. Those id values are the CIDs you pass to get_category_products. For example, Women's Jeans uses CID '5664'.