coppel.com APIwww.coppel.com ↗
Access Coppel.com product listings, prices, images, and category filters via API. Search by keyword or browse by department with pagination and sorting.
curl -X GET 'https://api.parse.bot/scraper/544e0bcc-735b-4947-ab82-fe7e6cdd3933/search_products?page=1&query=laptops&page_size=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Coppel.com by keyword. Returns product listings with images, prices, brands, badges, seller info, delivery options, and category breakdowns. Supports pagination and sorting.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
| query | string | Search keyword (e.g., 'zapatos', 'laptops', 'iPhone') |
| order_by | string | Sort order: '0'=relevance, '1'=price low-high, '2'=price high-low, '3'=newest |
| page_size | integer | Number of products per page (max ~48) |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search keyword used",
"products": "array of product objects with name, brand, sku, part_number, image_url, product_url, price, discounted_price, currency, is_on_sale, badges, seller, installment_amount, installment_duration, delivery",
"page_size": "integer, number of products per page",
"categories": "array of category objects with id, name, count, href",
"total_count": "integer, total number of matching products",
"total_pages": "integer, total number of pages available"
},
"sample": {
"data": {
"page": 1,
"query": "laptops",
"products": [
{
"sku": "212868",
"name": "Laptop HP 15-FC0288LA 15.6 Pulgadas Windows 11 AMD Ryzen 7 16 GB RAM 512 GB SSD Plateada",
"brand": "HP",
"price": 14999,
"badges": [
"Oferta"
],
"seller": "Coppel",
"currency": "MXN",
"delivery": {
"shipment": true,
"marketplace": false,
"store_pickup": true
},
"image_url": "https://cdn5.coppel.com/pm/2128683-1.jpg",
"is_on_sale": true,
"part_number": "PM-2128683",
"product_url": "https://www.coppel.com/pdp/laptop-hp-15-fc0288la-156-pulgadas-windows-11-amd-ryzen-7-16-gb-ram-512-gb-ssd-plateada-pm-2128683",
"discounted_price": 14149,
"installment_amount": "791",
"installment_duration": "24"
}
],
"page_size": 3,
"categories": [
{
"id": "cat000171",
"href": "/ct/electronica/laptop-esencial/cat000171",
"name": "Laptop esencial",
"count": "436"
}
],
"total_count": 1303,
"total_pages": 435
},
"status": "success"
}
}About the coppel.com API
The Coppel.com API provides 2 endpoints to query Mexico's largest department store catalog, returning product names, SKUs, brand, pricing, sale status, and image URLs for each result. The search_products endpoint lets you search by keyword with sorting and pagination, while get_product_listings lets you browse by category or department and exposes granular filters for brand, color, size, and discount status.
What the API Returns
Both endpoints return arrays of product objects sharing a common shape: name, brand, sku, part_number, image_url, product_url, price, discounted_price, currency, and is_on_sale. The search_products endpoint also returns a categories array that breaks down matching results by category id, name, result count, and href — useful for narrowing a broad query. The get_product_listings endpoint returns an available_filters object whose keys correspond to filter categories (brands, colors, sizes, discounts, sellers), each holding an array of option objects with id and count.
Searching and Browsing
search_products accepts a query string (e.g., zapatos, laptops, iPhone), while get_product_listings takes a search_term matching a category or department name (e.g., Celulares, Muebles, Televisores). Both support the same order_by values: 0 for relevance, 1 for price low-to-high, 2 for price high-to-low, and 3 for newest. Page size caps at approximately 48 products per request, and total_pages plus total_count are returned so you can iterate through full result sets.
Coverage and Scope
Coppel sells electronics, appliances, furniture, clothing, footwear, and financial products across Mexico. The API covers its physical and online catalog, including third-party seller listings that surface through the same search and browse interfaces. Sale pricing is distinguished from list price via discounted_price and is_on_sale, so price-monitoring and comparison workflows can detect promotions without additional parsing.
- Track price changes and sale status for electronics like phones and laptops using
price,discounted_price, andis_on_sale. - Build a product comparison tool for Mexican department store goods using SKU, brand, and category data.
- Aggregate furniture and appliance listings from
get_product_listingsusing department keywords likeMueblesorRefrigeradores. - Monitor inventory breadth across categories using
total_countreturned by keyword searches. - Feed a price-alert system by polling
search_productsfor specific product names and comparingdiscounted_priceover time. - Populate a shopping guide with product images and URLs using
image_urlandproduct_urlfields. - Identify top brands in a category by aggregating the
brandfilter options fromavailable_filtersinget_product_listings.
| 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 Coppel have an official public developer API?+
How does `search_products` differ from `get_product_listings`?+
search_products takes a free-text query and returns a categories breakdown showing how many results fall into each category. get_product_listings takes a search_term matching a department or category name and returns an available_filters object with options for brand, color, size, discount, and seller — making it better suited for faceted browsing rather than open-ended keyword search.Are individual product detail pages (descriptions, specifications, customer reviews) available?+
What is the maximum number of products returned per request?+
page_size parameter caps at approximately 48 products per page. Use the total_pages and total_count fields returned in each response to calculate how many requests are needed to paginate through a full result set.