Coppel API & Scraper
Coppel API returns live Coppel data as clean JSON for coppel The primary endpoint, search, returns matching records including product id, default variant id, title, brand and image.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Coppel scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, category, product/detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/coppel/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "televisor"
}
}{
"ok": true,
"meta": {
"api": "coppel",
"endpoint": "search",
"mode": "live",
"latency_ms": 2773.7,
"record_count": 24,
"bytes": 37729,
"cache_hit": false,
"country": "mx",
"requests": 2,
"total_results": 651,
"page": 1,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "8d000d9391db4d03",
"queue_ms": 1.4,
"fetched_at": "2026-11-03T17:32:04.568Z"
},
"data": {
"results": [
{
"product_id": "MKP-747671182",
"sku": "747671182",
"default_variant_id": "IMKP-747671182N7020",
"title": "Pantalla TCL 50\" QLED FHD 50Q3K",
"brand": "TCL",
"url": "https://www.coppel.com/pdp/pantalla-tcl-50-qled-fhd-50q3k-mkp-747671182",
"image": "https://cdn5.coppel.com/mkp/747671182-1.jpg",
"price": 5195,
"list_price": 6235,
"discount_pct": 17,
"currency": "MXN",
"on_sale": true,
"installments": {
"monthly_amount": 314,
"months": 24,
"credit_total": 7533,
"currency": "MXN",
"credit_markup_pct": 45
},
"seller": {
"id": "7020",
"name": "DIGIMART",
"is_marketplace": true,
"kind": "marketplace"
},
"badges": [
{
"label": "[trimmed-depth]",
"group": "[trimmed-depth]",
"variant": "[trimmed-depth]"
}
],
"delivery": {
"home_delivery": true,
"store_pickup": false,
"marketplace_shipping": true
},
"variant_types": {
"has_size": false,
"is_marketplace": true,
"is_clothing": false,
"is_furniture": false,
"is_motorcycle": false,
"is_phone": false
}
},
{
"product_id": "PM-2493543",
"sku": "249354",
"default_variant_id": "IM-2493543-0",
"title": "Pantalla Smart TV Hisense QLED 50 Pulgadas 4K 50QD5SR",
"brand": "Hisense",
"url": "https://www.coppel.com/pdp/pantalla-smart-tv-hisense-qled-50-pulgadas-4k-50qd5sr-pm-2493543",
"image": "https://cdn5.coppel.com/pm/2493543-1.jpg",
"price": 5619,
"list_price": 7399,
"discount_pct": 24,
"currency": "MXN",
"on_sale": true,
"installments": {
"monthly_amount": 315,
"months": 24,
"credit_total": 7529,
"currency": "MXN",
"credit_markup_pct": 34
},
"seller": {
"id": "0",
"name": "Coppel",
"is_marketplace": false,
"kind": "coppel"
},
"badges": [
{
"label": "[trimmed-depth]",
"group": "[trimmed-depth]",
"variant": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"group": "[trimmed-depth]",
"variant": "[trimmed-depth]"
}
],
"delivery": {
"home_delivery": true,
"store_pickup": true,
"marketplace_shipping": false
},
"variant_types": {
"has_size": false,
"is_marketplace": false,
"is_clothing": false,
"is_furniture": true,
"is_motorcycle": false,
"is_phone": false
}
},
{
"product_id": "PM-2381073",
"sku": "238107",
"default_variant_id": "IM-2381073-0",
"title": "Pantalla Smart TV LG LED 65 Pulgadas 4K 65NU850",
"brand": "LG",
"url": "https://www.coppel.com/pdp/pantalla-smart-tv-lg-led-65-pulgadas-4k-65nu850-pm-2381073",
"image": "https://cdn5.coppel.com/pm/2381073-1.jpg",
"price": 11999,
"list_price": 12999,
"discount_pct": 8,
"currency": "MXN",
"on_sale": true,
"installments": {
"monthly_amount": 671,
"months": 24,
"credit_total": 16079,
"currency": "MXN",
"credit_markup_pct": 34
},
"seller": {
"id": "0",
"name": "Coppel",
"is_marketplace": false,
"kind": "coppel"
},
"badges": [
{
"label": "[trimmed-depth]",
"group": "[trimmed-depth]",
"variant": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"group": "[trimmed-depth]",
"variant": "[trimmed-depth]"
}
],
"delivery": {
"home_delivery": true,
"store_pickup": true,
"marketplace_shipping": false
},
"variant_types": {
"has_size": false,
"is_marketplace": false,
"is_clothing": false,
"is_furniture": true,
"is_motorcycle": false,
"is_phone": false
}
}
],
"count": 24,
"total_results": 651,
"total_pages": 28,
"page": 1,
"page_size": 24,
"has_more": true,
"filters_available": [
{
"name": "Oferta",
"key": "attr_facet_oferta",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
}
]
},
{
"name": "ColorAgrupador",
"key": "attr_facet_coloragrupador",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
}
]
},
{
"name": "Marca",
"key": "attr_facet_marca",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
},
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"filter": "[trimmed-depth]"
}
]
}
],
"related_categories": null,
"breadcrumb": [
{
"category_id": "cat000061",
"name": "Electrónica",
"url": "https://www.coppel.com/ct/electronica/cat000061"
},
{
"category_id": "cat000267",
"name": "TV y video",
"url": "https://www.coppel.com/ct/electronica/tv-video/cat000267"
},
{
"category_id": "cat000268",
"name": "Pantallas",
"url": "https://www.coppel.com/ct/electronica/pantallas/cat000268"
}
],
"sort": "relevance",
"applied_filters": null,
"query": "televisor",
"currency": "MXN",
"redirect": null,
"query_id": null,
"query_type": "lexic-redirect"
}
}What the Coppel API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search 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. | Pricing teams call search to search coppel.com by keyword, exactly as Coppel's own search box does. | query, page, page_size, sort, brand, ... |
| category | Every 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. | Marketplace operators call category to get every product in a Coppel category, by category id or category URL, paged. | category, page, page_size, sort, brand, ... |
| product/detail | The 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. | Catalog enrichment teams call product/detail to get the full Coppel product record by part number, bare product number or product URL. | product_id |
Call search from your stack
curl -X POST https://api.reefapi.com/coppel/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"televisor"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/coppel/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "televisor"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/coppel/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "televisor"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.coppel.search with {"query":"televisor"}.Who uses this API and why
- Pricing teams use Coppel to search coppel.com by keyword, exactly as Coppel's own search box does.
- Marketplace operators use Coppel to get every product in a Coppel category, by category id or category URL, paged.
- Catalog enrichment teams use Coppel to get the full Coppel product record by part number, bare product number or product URL.
Questions developers ask before integrating
What is the Coppel API?
Coppel API is a ReefAPI endpoint group for coppel It returns live JSON through POST requests under /coppel/v1.
Is the Coppel API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Coppel calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Coppel login or account?
No login to Coppel is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Coppel data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Coppel API use?
Coppel actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Coppel from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call coppel actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Coppel API a Coppel scraper?
It is the managed alternative to a DIY Coppel scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same coppel back as clean JSON.
Why does my Coppel scraper keep getting blocked?
Most Coppel scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.