# Coppel API scraper — coppel.com (Mexico): search the catalogue, browse any category and read the full product record, with the price you pay today in MXN kept apart from the struck original price and from Coppel's published monthly credit plan (instalment amount, term and credit total), plus brand, seller (Coppel or a marketplace store), delivery options, badges, specifications, images and variants. No account, no browser.

> 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.
> ReefAPI engine `coppel` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/coppel/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/coppel/v1/search — 2 credits
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.

**Parameters:**
- `query` (string, required) — What a shopper would type in Coppel's search box, in Spanish (televisor, laptop, tenis nike, refrigerador).
- `page` (integer, optional, default 1) — Result page, from 1. Up to 200.
- `page_size` (integer, optional, default 24) — Products per page, 1-100. Coppel's own site asks for 24; larger pages are served in one call.
- `sort` (enum, optional, default "relevance") — Result order, using Coppel's own orderBy codes. [one of: relevance, price_asc, price_desc]
- `brand` (string, optional) — One brand exactly as Coppel spells it in the Marca facet (Samsung, Hisense, Adidas). Shorthand for filters=attr_facet_marca=<brand>.
- `filters` (array, 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.

**Returns:** results[]{product_id (Coppel part number), sku, default_variant_id, title, brand, url, image, price (what you pay today, MXN), list_price (struck original, null when there is no discount), discount_pct, currency, on_sale, installments{monthly_amount, months, credit_total, credit_markup_pct, currency} (Coppel's published credit plan — a higher total than the cash price), seller{id, name, kind (coppel|marketplace), is_marketplace}, badges[]{label, group, variant}, delivery{home_delivery, store_pickup, marketplace_shipping}, variant_types{has_size, is_marketplace, is_clothing, is_furniture, is_motorcycle, is_phone}}, count, total_results, total_pages, page, page_size, has_more, filters_available[]{name, key, values[]{label, count, key, value, filter}}, related_categories[]{category_id, name, product_count, url}, breadcrumb[]{category_id, name, url}, sort, applied_filters[], currency, query, redirect (the landing page Coppel sends this keyword to, when it does), query_type (Coppel's own search-engine verdict), query_id

**Example request body:**
```json
{
  "query": "televisor"
}
```

### POST https://api.reefapi.com/coppel/v1/category — 2 credits
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.

**Parameters:**
- `category` (string, 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` (integer, optional, default 1) — Result page, from 1. Up to 200.
- `page_size` (integer, optional, default 24) — Products per page, 1-100. Coppel's own site asks for 24; larger pages are served in one call.
- `sort` (enum, optional, default "relevance") — Result order, using Coppel's own orderBy codes. [one of: relevance, price_asc, price_desc]
- `brand` (string, optional) — One brand exactly as Coppel spells it in the Marca facet (Samsung, Hisense, Adidas). Shorthand for filters=attr_facet_marca=<brand>.
- `filters` (array, 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.

**Returns:** results[]{product_id (Coppel part number), sku, default_variant_id, title, brand, url, image, price (what you pay today, MXN), list_price (struck original, null when there is no discount), discount_pct, currency, on_sale, installments{monthly_amount, months, credit_total, credit_markup_pct, currency} (Coppel's published credit plan — a higher total than the cash price), seller{id, name, kind (coppel|marketplace), is_marketplace}, badges[]{label, group, variant}, delivery{home_delivery, store_pickup, marketplace_shipping}, variant_types{has_size, is_marketplace, is_clothing, is_furniture, is_motorcycle, is_phone}}, count, total_results, total_pages, page, page_size, has_more, filters_available[]{name, key, values[]{label, count, key, value, filter}}, related_categories[]{category_id, name, product_count, url}, breadcrumb[]{category_id, name, url}, sort, applied_filters[], currency, category_id, category_title, category_meta{title, description, keywords}

**Example request body:**
```json
{
  "category": "cat000166"
}
```

### POST https://api.reefapi.com/coppel/v1/product/detail — 1 credit
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.

**Parameters:**
- `product_id` (string, 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.

**Returns:** product{product_id, sku, default_variant_id, title, brand, url, image, images[], price, list_price, discount_pct, currency, on_sale, installments{monthly_amount, months, credit_total, credit_markup_pct, currency}, seller{id, name, kind, is_marketplace}, badges[], delivery{home_delivery, store_pickup, marketplace_shipping}, variant_types{}, description, specifications[]{name, value, values[]}, breadcrumb[]{category_id, name, url}, category_id, meta{title, description, keywords}, is_international, content_provider, size_guide_id, variants[]{variant_id, product_id, seller_id, seller_name, price, list_price, discount_pct, installments{}, attributes[]{name, identifier, usage, values[]}}, variant_count, variant_options[]{name, identifier, value, hex_value, options[]}, other_sellers[]{seller_id, seller_name, product_id, sku, price, list_price}}, currency

**Example request body:**
```json
{
  "product_id": "PR-8900172"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=coppel
- Human docs page: https://reefapi.com/docs/coppel
- Overview page: https://reefapi.com/coppel-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
