Coppel
Coppel
/coppel/v1/search2 creditsSearch coppel.com by keyword, exactly as Coppel's own search box does. Every product comes back with the price you actually pay today in MXN, the struck original price and the discount when there is one, Coppel's published monthly instalment plan (amount, term and the higher credit total — Coppel is a credit retailer, so this is the number most of its customers act on), the brand, whether Coppel or a marketplace store sells it, the delivery options, the sale badges and the product URL. Page through the whole result set, sort by price, narrow by brand or by any facet Coppel publishes (offer step, colour, seller, screen size, RAM…), and read the facet list back so the next call can drill down. A keyword with no match answers an honest empty result, not an error.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What a shopper would type in Coppel's search box, in Spanish (televisor, laptop, tenis nike, refrigerador). |
| page = 1 | optional | 1–200 | Result page, from 1. Up to 200. |
| page_size = 24 | optional | 1–100 | Products per page, 1-100. Coppel's own site asks for 24; larger pages are served in one call. |
| sort = relevance | optional | relevance · price_asc · price_desc | Result order, using Coppel's own orderBy codes. |
| brand | optional | — | One brand exactly as Coppel spells it in the Marca facet (Samsung, Hisense, Adidas). Shorthand for filters=attr_facet_marca=<brand>. |
| filters | optional | — | Any facet from a previous call, as filters_available[].values[].filter returns it ('attr_facet_marca=Samsung', 'attr_facet_oferta=30% o más', 'attr_facet_coloragrupador=Negro (#000)'). Several may be sent; they are combined. Both halves are required — Coppel refuses a key without a value. |
/coppel/v1/category2 creditsEvery product in a Coppel category, by category id or category URL, paged. Same product rows, sorts and facets as search, plus the category breadcrumb, the category's own page title and meta description, and the sub-categories underneath it with their product counts — so a whole department can be walked from one call.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | A Coppel category id (cat000166) or any Coppel category URL (https://www.coppel.com/ct/electronica/laptops/cat000166). Category ids come back in related_categories[] and breadcrumb[] of any call. |
| page = 1 | optional | 1–200 | Result page, from 1. Up to 200. |
| page_size = 24 | optional | 1–100 | Products per page, 1-100. Coppel's own site asks for 24; larger pages are served in one call. |
| sort = relevance | optional | relevance · price_asc · price_desc | Result order, using Coppel's own orderBy codes. |
| brand | optional | — | One brand exactly as Coppel spells it in the Marca facet (Samsung, Hisense, Adidas). Shorthand for filters=attr_facet_marca=<brand>. |
| filters | optional | — | Any facet from a previous call, as filters_available[].values[].filter returns it ('attr_facet_marca=Samsung', 'attr_facet_oferta=30% o más', 'attr_facet_coloragrupador=Negro (#000)'). Several may be sent; they are combined. Both halves are required — Coppel refuses a key without a value. |
/coppel/v1/product/detail1 creditThe full Coppel product record by part number, bare product number or product URL: title, brand, the price you pay today, the struck original price and discount, Coppel's monthly credit plan with the credit total and its mark-up over the cash price, the seller (Coppel or the marketplace store), home delivery and store pickup, sale badges, the long description with its HTML stripped, every published specification, every image, the category breadcrumb, the page's SEO title and description, and every variant (size, colour, storage) with its own price and instalment plan. A dead id answers NOT_FOUND.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | A Coppel part number — PR-8900172 (Coppel catalogue), PM-8225513 or MKP-747799071 (marketplace) — the product URL (https://www.coppel.com/pdp/...-pr-8900172), or the bare number, in which case the PR, PM and MKP prefixes are tried in that order. |
curl -X POST https://api.reefapi.com/coppel/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"televisor"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.