# Coppel Mexico Scraper: Product Prices, Brands & Search API (`latinamericadata/coppel-mexico`) Actor

Extract Coppel Mexico product search results, cash prices in MXN, brands, marketplace sellers and product URLs. Export JSON, CSV or Excel.

- **URL**: https://apify.com/latinamericadata/coppel-mexico.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 product delivereds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Coppel Mexico Scraper and Product Search API

Extract Coppel Mexico product listings with cash prices in MXN, brands, marketplace sellers and original product links. Use it for retail price monitoring, catalog discovery and competitive research across electronics, appliances, furniture and fashion.

### Quick start

```json
{"term":"laptop","maxItems":3}
```

Multiple searches:

```json
{"searchTerms":["refrigerador","lavadora"],"maxPages":2}
```

There is **no default product or page limit**. Omit maxItems and maxPages to continue until results end, the time budget expires or your Apify spending limit is reached. Default runtime is 240 seconds, adjustable up to 7200 seconds.

### Output

Products include product\_id, title, brand, sku\_id, price, list\_price, currency, seller\_name, image\_url, source\_url and delivery\_status where exposed. Search term, page, rank and collection timestamp accompany every product.

Prices are the listing's **cash prices in MXN**, not installments. Availability is not inferred: location-dependent delivery signals are preserved separately and available remains null. Only products with an identifier, title and verified MXN price are billed.

### Inputs

| Input | Purpose |
|---|---|
| term | Product, brand or category keywords; defaults to laptop. |
| searchTerms | Optional list of up to 100 searches, replacing term. |
| maxItems | Optional global maximum of unique products. |
| maxPages | Optional page limit per search. |
| startPage | First page; defaults to 1. |
| maxRuntimeSecs | Whole-search time budget; defaults to 240 seconds. |
| requestTimeoutSecs | Maximum wait per request; defaults to 30 seconds. |

### Pricing

**USD 0.003 per delivered product**, plus **Apify platform usage paid by the user running the actor**, including compute, storage, transfer and automatic proxy traffic. 1,000 products cost USD 3 in product fees plus platform usage. Empty searches, blocked diagnostics and errors incur no product fees.

### Reliability and integration

The actor reuses Coppel's public visitor session and search contract. Access and proxy rotation are automatic; customers need no extra configuration. Products are uploaded page by page and deduplicated by product ID across all terms.

Confirmed empty searches return a non-chargeable no\_results diagnostic. Blocks are reported as blocked, never empty results. A later error preserves earlier products and marks RUN\_SUMMARY as partial. Source totals can change, and a repeated non-terminal page is reported as incomplete.

Use the Apify API, schedules or integrations to run searches and download JSON, CSV or Excel. RUN\_SUMMARY reports completion, stopping reason, delivered and charged counts, request totals and timing.

### Limitations and independence

Prices and shipping options can change by region, variant, seller and checkout conditions. This actor does not log in, purchase products, promise every catalog item is retrievable, or provide an official Coppel API. It is an independent tool by Latin America Data, not affiliated with or endorsed by Coppel.

# Actor input Schema

## `term` (type: `string`):

Producto, marca o categoria.

## `searchTerms` (type: `array`):

Opcional. Sustituye term. Se eliminan productos duplicados entre busquedas.

## `maxItems` (type: `integer`):

Opcional. Sin este limite, continua hasta agotar resultados, tiempo o presupuesto.

## `maxPages` (type: `integer`):

Opcional. No hay un limite de paginas predeterminado.

## `startPage` (type: `integer`):

Primera pagina que se consulta.

## `maxRuntimeSecs` (type: `integer`):

Preserva resultados anteriores cuando se alcanza este presupuesto de tiempo.

## `requestTimeoutSecs` (type: `integer`):

Espera maxima por respuesta del sitio.

## Actor input object example

```json
{
  "term": "laptop",
  "startPage": 1,
  "maxRuntimeSecs": 240,
  "requestTimeoutSecs": 30
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("latinamericadata/coppel-mexico").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("latinamericadata/coppel-mexico").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call latinamericadata/coppel-mexico --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,latinamericadata/coppel-mexico"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/GHbfOopGQw7dW0XZP/builds/boaCfQiQ8pXvUQc9T/openapi.json