gapcanada.ca APIwww.gapcanada.ca ↗
Access Gap Canada's full product catalog via API. Retrieve categories, paginated product listings with pricing and inventory, and SKU-level size data in CAD.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/148f30c1-3f01-4023-b803-13822b3437d6/list_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all available product categories with their IDs and department codes. Returns a static list of categories across Women, Men, Girls, Boys, and Baby & Toddler divisions. Use the returned cid and department values with get_products to fetch products from specific categories.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects each containing division, name, cid, and department"
},
"sample": {
"data": {
"categories": [
{
"cid": "1127938",
"name": "Shop All Styles",
"division": "Women",
"department": "136"
},
{
"cid": "6998",
"name": "Jeans",
"division": "Men",
"department": "75"
}
]
},
"status": "success"
}
}About the gapcanada.ca API
The Gap Canada API gives developers structured access to gapcanada.ca's product catalog across 3 endpoints, covering all five departments: Women, Men, Girls, Boys, and Baby & Toddler. The get_products endpoint returns paginated listings with real-time pricing, color variants, review scores, and inventory signals, while get_product_detail exposes individual SKU-level size availability and effective versus regular prices in CAD.
Endpoints and Coverage
The API is organized around three endpoints. list_categories returns a static index of all browsable categories, each with a cid, department code, division, and human-readable name. These identifiers feed directly into get_products and form the entry point for any catalog traversal.
Product Listings
get_products accepts a required cid and department (both sourced from list_categories), and optional page (0-indexed) and page_size (up to 200) parameters. Each product object in the response includes style_id, style_name, cc_id, color_name, color_description, effective_price, regular_price, price_ty, badges, review scores, and image references. The pagination object in the response exposes current_page, total_pages, page_size, and total_products, making it straightforward to walk a full category.
SKU-Level Detail
get_product_detail accepts a pid corresponding to the cc_id field from get_products. It returns the full set of SKUs for that color variant, each with sku_id, size, inventory_status, effective_price, and regular_price. The response also includes a sizes array of available dimension strings, the currency field (always CAD), and a customer_choice_ids array listing all color variants belonging to the same parent style — useful for fetching alternate colorways without re-querying the category listing.
- Track price drops by comparing
effective_pricetoregular_priceacross categories over time - Build a size availability checker using
inventory_statusfrom SKU objects inget_product_detail - Aggregate Gap Canada's full catalog by iterating
list_categoriesand paginating throughget_products - Monitor which products carry promotional badges in the
get_productsresponse for deal-surfacing tools - Map all color variants of a style using
customer_choice_idsreturned inget_product_detail - Feed kids' and baby clothing data into a cross-retailer comparison tool using department-filtered requests
- Sync CAD pricing and inventory status into an affiliate or price-alert application
| 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 Canada have an official public developer API?+
How do I paginate through all products in a category?+
get_products returns a pagination object containing current_page, total_pages, and total_products. Start with page=0 and increment until you reach total_pages - 1. The page_size parameter accepts values up to 200, which reduces the number of requests needed for large categories.Does `get_product_detail` return data for all color variants of a style, or only one?+
get_product_detail returns SKU and size data for a single color variant identified by its pid (the cc_id from get_products). The customer_choice_ids array in the response lists the IDs of all other color variants for that parent style, so you can call get_product_detail for each to build a full picture of the style.Does the API cover product search or filtering by size, price, or other attributes?+
list_categories and get_products, and per-variant detail via get_product_detail. There is no search or attribute-filter endpoint. You can fork this API on Parse and revise it to add a search endpoint if that capability is needed.Are prices in the API always in Canadian dollars?+
currency field in get_product_detail is always CAD, and all effective_price and regular_price values across all endpoints reflect Canadian dollar pricing from gapcanada.ca. US pricing from gap.com is not covered. You can fork this API on Parse and revise it to point at gap.com if USD pricing is required.