# Jumbo Chile Products, Prices & Unit Prices API, $1/1K, No Login (`hhonlineventures/jumbo-product-search`) Actor

Jumbo Chile Products, Prices and Unit Prices API: enter Spanish search terms or category pages, get each Jumbo.cl product with price, list price, member price, unit price, multi-buy offer, brand and category path. Schedule it to monitor supermarket prices. Pay per product.

- **URL**: https://apify.com/hhonlineventures/jumbo-product-search.md
- **Developed by:** [HH Online Ventures](https://apify.com/hhonlineventures) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Jumbo Chile Products, Prices & Unit Prices API

**Jumbo Chile Products, Prices & Unit Prices API**: Jumbo Chile Products, Prices and Unit Prices API: enter Spanish search terms or category pages, get each Jumbo.cl product with price, list price, member price, unit price, multi-buy offer, brand and category path. Schedule it to monitor supermarket prices. Pay per product.

### What data does Jumbo Chile Products, Prices & Unit Prices API return?

Each run returns one dataset item per result with these fields:

| Field | Type | Description |
|---|---|---|
| `productId` | string or null | Jumbo's product id from the result card (for example "6697"), as a string; null for a product the page lists without a card. |
| `refId` | string or null | Jumbo's reference id for the product (for example "302773"), from the card. |
| `name` | string | The product name as Jumbo shows it. |
| `brand` | string or null | The brand Jumbo lists for the product; null when none is given. |
| `url` | string | The product page on Jumbo.cl, https://www.jumbo.cl/.../p |
| `image` | string or null | The product's image URL as the results page shows it. |
| `price` | number or null | The current price in Chilean pesos, as a number (1190 for $1.190). |
| `currency` | string | Always CLP (Chilean peso). |
| `listPrice` | number or null | The crossed-out regular price shown next to the price when the product is on offer; null otherwise. |
| `memberPrice` | number or null | The member or card price the card shows as "Paga $990" next to a program badge (for example Cencosud Prime); null when not shown. |
| `memberPriceLabel` | string or null | The name of the badge icon Jumbo shows next to the member price, as the page names it (seen so far: "prime" for the Cencosud Prime badge, and "tcenco"); null when there is no member price. |
| `unitPrice` | object or null | Price per unit of measure as the card shows it under the price. text is the page's own string (for example "$1.190 x lt"); value and unit are filled when the text parses cleanly, else null. Null when the card shows no unit price. |
| `promotion` | string or null | The label on the card, for example "Oferta", "Prime Week", "Exclusivo online" or "Agotado"; null when there is none. |
| `offerText` | string or null | The multi-buy offer the card shows, for example "Lleva 2 por $2.350" or "4 por 3 a $7.470"; null when there is none. |
| `availability` | string or null | The page's schema.org availability, shortened: InStock or OutOfStock. |
| `inStock` | boolean or null | The card's own stock flag; null for a product the page lists without a card. |
| `rating` | number or null | The average rating the card shows (0 to 5); null when the card says the product is not rated. |
| `categoryPath` | array of string | Jumbo's category levels for the product, top level first. |
| `sponsored` | boolean or null | True when the card marks the result as sponsored (an ad placement in the results grid). |
| `searchTerm` | string or null | The search term this row was found for; null on a category row. |
| `categoryUrl` | string or null | The category page URL this row was found for, as you entered it; null on a search row. |
| `position` | integer | 1-based rank of the product in the results for this term or category, in page order, each product counted once. |
| `page` | integer | The results page the product was found on (40 products a page). |
| `totalResults` | integer or null | How many results Jumbo says the term or category has. |
| `scrapedAt` | string | When the page was read (ISO 8601, UTC). |
| `error` | string or null | Null on a product row. On a free error row, why the term or category returned no products: "no results", "blocked after retries", "not allowed by robots.txt" (a search term whose search URL Jumbo's robots.txt does not allow) or "invalid category URL: ...". |

### Sample output

Real output from the prefilled example input (first 3 of 10 results):

```json
[
  {
    "productId": "6697",
    "refId": "302773",
    "name": "Leche Colun Entera 1 L",
    "brand": "Colun",
    "url": "https://www.jumbo.cl/leche-entera-colun-caja-1-l-natural/p",
    "image": "https://jumbocl.vteximg.com.br/arquivos/ids/348513-250-250/Leche-entera-1-L.jpg?v=638776485157100000",
    "price": 1190,
    "currency": "CLP",
    "listPrice": 1390,
    "memberPrice": null,
    "memberPriceLabel": null,
    "unitPrice": {
      "text": "$1.190 x lt",
      "value": 1190,
      "unit": "lt"
    },
    "promotion": "Oferta",
    "offerText": null,
    "availability": "InStock",
    "inStock": true,
    "rating": 5,
    "categoryPath": [
      "Lácteos, Huevos y Congelados",
      "Leches",
      "Leche Líquida"
    ],
    "sponsored": false,
    "searchTerm": "leche",
    "categoryUrl": null,
    "position": 1,
    "page": 1,
    "totalResults": 357,
    "scrapedAt": "2026-11-18T03:00:00.000Z",
    "error": null
  },
  {
    "productId": "6690",
    "refId": "302780",
    "name": "Leche Colun Semidescremada 1 L",
    "brand": "Colun",
    "url": "https://www.jumbo.cl/leche-colun-semi-descremada-1-litro/p",
    "image": "https://jumbocl.vteximg.com.br/arquivos/ids/348510-250-250/Leche-semidescremada-1-L.jpg?v=638776485116600000",
    "price": 1190,
    "currency": "CLP",
    "listPrice": 1390,
    "memberPrice": null,
    "memberPriceLabel": null,
    "unitPrice": {
      "text": "$1.190 x lt",
      "value": 1190,
      "unit": "lt"
    },
    "promotion": "Oferta",
    "offerText": null,
    "availability": "InStock",
    "inStock": true,
    "rating": 4.9,
    "categoryPath": [
      "Lácteos, Huevos y Congelados",
      "Leches",
      "Leche Líquida"
    ],
    "sponsored": false,
    "searchTerm": "leche",
    "categoryUrl": null,
    "position": 2,
    "page": 1,
    "totalResults": 357,
    "scrapedAt": "2026-11-18T03:00:00.000Z",
    "error": null
  },
  {
    "productId": "6737",
    "refId": "1232538",
    "name": "Leche Surlat Descremada Sin Lactosa 1 L",
    "brand": "Surlat",
    "url": "https://www.jumbo.cl/leche-descremada-surlat-caja-1-l-sin-lactosa/p",
    "image": "https://jumbocl.vteximg.com.br/arquivos/ids/598890-250-250/Leche-Surlat-Descremada-Sin-Lactosa-1-L.jpg?v=639095278524000000",
    "price": 1100,
    "currency": "CLP",
    "listPrice": 1440,
    "memberPrice": 990,
    "memberPriceLabel": "prime",
    "unitPrice": {
      "text": "$1.100 x lt",
      "value": 1100,
      "unit": "lt"
    },
    "promotion": "Prime Week",
    "offerText": null,
    "availability": "InStock",
    "inStock": true,
    "rating": 4.7,
    "categoryPath": [
      "Lácteos, Huevos y Congelados",
      "Leches",
      "Leche Líquida"
    ],
    "sponsored": false,
    "searchTerm": "leche",
    "categoryUrl": null,
    "position": 3,
    "page": 1,
    "totalResults": 357,
    "scrapedAt": "2026-11-18T03:00:00.000Z",
    "error": null
  }
]
```

### Use cases

- **Supermarket price monitoring in Chile:** schedule the same search terms or category pages every day and track Jumbo's prices, list prices, member prices and unit prices over time.
- **Promotion tracking:** collect the multi-buy offers (for example "Lleva 2 por $2.350"), the crossed-out list price and the card label ("Oferta", "Prime Week", "Exclusivo online") for each product.
- **Member price research:** see which products show a Cencosud Prime or card price ("Paga $990") next to the regular price.
- **Price per unit comparisons:** compare products of different sizes with the unit price Jumbo prints (for example "$1.190 x lt"), parsed into an amount and a unit.
- **Assortment and category research:** read a whole Jumbo category page by page, with each product's brand, category path, rank and stock flag.
- **AI agents and automations:** a clean, typed dataset that an agent or a Make, Zapier or n8n flow can read directly, one row per product.

### Input examples

The prefilled example input. It runs in seconds and returns a handful of results:

```json
{
  "searchTerms": [
    "leche"
  ],
  "maxItemsPerTerm": 10,
  "maxItems": 10
}
```

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `searchTerms` | array | no |  | One search term per line, in Spanish, for example leche, arroz, aceite de oliva, detergente. Each term is searched on Jumbo.cl like the site's own search box. Empty lines and repeated terms are skipped. Up to 1,000 terms per run. Enter at least one search term or one category URL. |
| `categoryUrls` | array | no |  | Optional. Jumbo category pages, one URL per line, for example https://www.jumbo.cl/lacteos-huevos-y-congelados/leches. Only https://www.jumbo.cl/ category paths without filters or other query parameters are accepted; any other URL gets a free row that says why. Up to 1,000 URLs per run. |
| `maxItemsPerTerm` | integer | no | `40` | How many products to return for each search term and each category URL, in the order Jumbo shows them. Jumbo shows 40 products a page; the actor reads as many pages as it needs and stops at the site's last page, so a term can return fewer. |
| `maxItems` | integer | no |  | Stop the whole run after this many products are in your dataset, across all terms and categories. You pay per product, so this also caps the cost of a run. Leave empty for no overall cap. |
| `maxRetries` | integer | no | `3` | How many more times a results page is requested when Jumbo answers with an error or a page without the product list. Each retry uses a new proxy session. |

### How much does Jumbo Chile Products, Prices & Unit Prices API cost?

This actor uses pay-per-event pricing: you pay only for results you get, plus a small fee per run.
Higher Apify plans get a lower price per result.

| Event | Free plan | Bronze plan | Silver plan | Gold plan |
|---|---|---|---|---|
| Product (per 1,000) | $1.00 | $1.00 | $0.90 | $0.80 |
| Actor start (per run) | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

**1,000 results cost $1.00005 on the Bronze plan.** In one run, 1,000 results cost $1.00005 on the Free plan, $1.00005 on the Bronze plan, $0.90005 on the Silver plan and $0.80005 on the Gold plan, including the actor start.

Product: One Jumbo.cl product row in your dataset. Rows for search terms or category pages that return no products (no results, blocked after retries, not accepted) are free. Actor start: Charged once when a run starts (Apify counts one start per GB of memory).
You can set a maximum cost per run in the run options; the actor stops cleanly when it is reached.

### Schedule and monitor

**Monitor Jumbo prices every day:** save your search terms or category URLs as a task and schedule it daily or weekly. Each run adds a dataset with the current price, list price, member price, unit price, multi-buy offer, promotion label and rank of every product and a `scrapedAt` time, so you can track price changes in a spreadsheet or alert on them.

Run Jumbo Chile Products, Prices & Unit Prices API on a schedule to keep your data fresh and to monitor what changed since the last run:

1. Run the actor once with your input, then save that input as a task in Apify Console.
2. Open **Schedules** in Apify Console, click **Create new**, choose the task and set how often it runs with a cron expression, for example `0 6 * * 1` for every Monday at 06:00. Schedules support time zones and daylight saving time.
3. Every scheduled run writes a new dataset. Compare it with the previous run, or send it onward with a webhook or one of the integrations below.

### Integrations and API

Jumbo Chile Products, Prices & Unit Prices API runs on the Apify platform, so its results can go wherever Apify connects:

- **API:** start a run and read the results over HTTP from any language (examples below).
- **Make, Zapier and n8n:** Apify has official integrations for all three. Run the actor from a Make scenario, a Zap or an n8n workflow and pass each result to the next step, such as a spreadsheet, a CRM or a chat message.
- **Webhooks:** have Apify call your own URL when a run succeeds or fails, for example to load the new dataset into your system.
- **Schedules:** run it automatically at the times you choose (see Schedule and monitor above).
- **Downloads:** export any run's dataset as JSON, CSV, Excel, XML, HTML table, RSS or JSONL.

#### Run it with the API

One request starts a run and returns its dataset items, for runs that finish within 300 seconds. For bigger runs, start the run, then read its dataset when it finishes.

```bash
curl -X POST "https://api.apify.com/v2/actors/hhonlineventures~jumbo-product-search/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["leche"], "maxItemsPerTerm": 10, "maxItems": 10}'
```

JavaScript, with `npm install apify-client`:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('hhonlineventures/jumbo-product-search').call({"searchTerms": ["leche"], "maxItemsPerTerm": 10, "maxItems": 10});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

Python, with `pip install apify-client`:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("hhonlineventures/jumbo-product-search").call(run_input={'searchTerms': ['leche'], 'maxItemsPerTerm': 10, 'maxItems': 10})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

Your API token is in Apify Console under API & Integrations.

### Use with AI agents (MCP)

AI agents can run Jumbo Chile Products, Prices & Unit Prices API as a tool through the Apify MCP server (`https://mcp.apify.com`). The agent reads the input schema and the output fields above, fills in the input and gets the dataset back, with no glue code.

To give an agent exactly this actor, add the server to your MCP client with the actor in the `tools` parameter:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=hhonlineventures/jumbo-product-search"
    }
  }
}
```

On first connection your browser opens so you can sign in to Apify and approve access. A client that cannot do that can send an `Authorization: Bearer <YOUR_APIFY_TOKEN>` header instead, and a client that runs only local servers can start `npx -y @apify/actors-mcp-server` with `APIFY_TOKEN` set.

Then ask in plain language, for example:

> Run Jumbo Chile Products, Prices & Unit Prices API with this input: `{"searchTerms": ["leche"], "maxItemsPerTerm": 10, "maxItems": 10}`. Show me the results as a table.

The server also has `search-actors`, `fetch-actor-details` and `call-actor` tools, which let an agent find this actor in Apify Store, read its details and run it. Agent runs are charged the same pay-per-event prices as any other run.

### Limits

- The actor reads Jumbo.cl search results and category pages, 40 products a page, in the order Jumbo shows them. It does not change the sort order or apply filters.
- A term returns at most what Jumbo's own pages list for it (the site's last page). In our test runs on 2026-11-18, "azúcar" had 32 products in all and "plátano" 19; a term or category with more products returns as many as you ask for.
- Jumbo's search is forgiving: a misspelled or made-up word usually still returns a few products. Only a search Jumbo answers with its "not found" page gets a free row that says "no results".
- Sponsored products in the results grid are returned and marked `sponsored: true`; sponsored brand banners and product carousels on the page are not results and are left out.
- If Jumbo answers a load with an error or a page without products, the actor asks again on a new proxy session (3 more times by default). A term that still does not open gets a free row that says "blocked after retries". In our test runs on 2026-11-18, every one of 90 page loads opened on the first attempt.
- Prices are in Chilean pesos (CLP) as Jumbo shows them to a visitor who has not chosen a store or a delivery address.
- Search terms whose search address Jumbo's robots.txt does not allow (terms containing ".pdf", "checkout", "?" or similar) are not searched; each gets a free row that says "not allowed by robots.txt".
- About 2 terms or categories are worked on at a time. In our test runs on 2026-11-18, 40 products took about 4 seconds of run time, 392 products about 20 seconds and 2,154 products about 2 minutes.
- Up to 1,000 search terms and 1,000 category URLs per run.

#### What this actor is not

- **Not a product page scraper:** no descriptions, ingredients, EAN codes, full image galleries or specifications. It returns what the results page shows.
- **Not a review scraper:** it returns the card's rating, not review texts or reviewer names.
- **Not a store stock checker:** no stock by store or by address; `inStock` is the results page's own flag.
- **Not a login tool:** no Jumbo account, cart, orders or personal prices.

### Search terms buyers use

- Jumbo scraper
- Jumbo.cl scraper
- Jumbo Chile product data
- Jumbo price monitor
- Cencosud Jumbo scraper
- Chile supermarket price scraper
- Chilean grocery prices API
- scraper Jumbo Chile
- precios Jumbo
- precios supermercado Chile
- buscador de productos Jumbo
- monitoreo de precios supermercado
- extraer productos Jumbo.cl

### FAQ

#### What do I need to run it?

Only search terms (or Jumbo category URLs) and an Apify account. No Jumbo account, login, cookies or API key. Type the terms one per line, or send them as the `searchTerms` array through the API.

#### Which search terms work?

Any term you would type in Jumbo's own search box, in Spanish: `leche`, `arroz`, `aceite de oliva`, `papel higiénico`.

#### Which category URLs work?

Jumbo category pages as you see them in your browser, for example `https://www.jumbo.cl/lacteos-huevos-y-congelados/leches` or `https://www.jumbo.cl/limpieza/limpieza-de-ropa`, without filters or other `?` parameters. If Jumbo has moved a category, the actor follows it to its new address. Any other URL gets a free row that says why it was not used.

#### Is the data in Spanish?

Yes. Jumbo's catalog is in Spanish, so type your terms in Spanish as you would on Jumbo.cl. Product names, categories and labels come back exactly as Jumbo shows them; field names and the structure are in English.

#### What is the member price?

Some products show a second, lower price for members or card payers, written as "Paga $990" next to a program badge. `memberPrice` is that amount (990) and `memberPriceLabel` is the name of the badge as the page names it: `prime` for the Cencosud Prime badge, and `tcenco` for the other badge seen so far. Both are null when the card shows no member price.

#### What is the unit price?

The price per unit of measure that Jumbo prints under the price, for example `$1.190 x lt` or `$5.990 x kg`. `unitPrice.text` keeps that string as is; `unitPrice.value` (1190) and `unitPrice.unit` (`lt`) are filled when the string parses cleanly, otherwise they are null. Units are written as Jumbo writes them (`lt`, `kg`, `un`, `100g`, `100ml` and others).

#### What does position mean?

The rank of the product in Jumbo's results for that term or category, starting at 1, in page order. A product that appears again on a later page is not returned twice.

#### What am I charged for?

One `product` event per product row in your dataset, plus the actor start. Terms and categories that return no products (no results, blocked after retries, not allowed, or a category URL that was not accepted) get a free row, and repeated or empty search terms are skipped.

#### Can I track price changes?

Yes. Save the input as a task and schedule it, for example every morning. Each run adds a new dataset with the current prices, list prices, member prices, offers and positions and a `scrapedAt` time, so you can compare runs or send them to a spreadsheet.

#### What happens if I set a maximum cost per run?

The actor loads only as many result pages as your limit pays for, then stops cleanly. Every product in your dataset was charged once; nothing else was. You can also cap a run with `maxItems`.

#### Why is a field null?

Every field comes from Jumbo's own page data. When Jumbo does not show something for a product (no list price, no member price, no rating), the field is null instead of a guess.

#### Is it legal to collect this data?

The actor reads only public search and category pages, the same pages anyone can open without logging in, follows the site's robots.txt, never logs in, and returns product business data only. You are responsible for how you use the data and for following Jumbo's terms and the laws that apply to you.

# Actor input Schema

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

One search term per line, in Spanish, for example leche, arroz, aceite de oliva, detergente. Each term is searched on Jumbo.cl like the site's own search box. Empty lines and repeated terms are skipped. Up to 1,000 terms per run. Enter at least one search term or one category URL.

## `categoryUrls` (type: `array`):

Optional. Jumbo category pages, one URL per line, for example https://www.jumbo.cl/lacteos-huevos-y-congelados/leches. Only https://www.jumbo.cl/ category paths without filters or other query parameters are accepted; any other URL gets a free row that says why. Up to 1,000 URLs per run.

## `maxItemsPerTerm` (type: `integer`):

How many products to return for each search term and each category URL, in the order Jumbo shows them. Jumbo shows 40 products a page; the actor reads as many pages as it needs and stops at the site's last page, so a term can return fewer.

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

Stop the whole run after this many products are in your dataset, across all terms and categories. You pay per product, so this also caps the cost of a run. Leave empty for no overall cap.

## `maxRetries` (type: `integer`):

How many more times a results page is requested when Jumbo answers with an error or a page without the product list. Each retry uses a new proxy session.

## Actor input object example

```json
{
  "searchTerms": [
    "leche"
  ],
  "maxItemsPerTerm": 10,
  "maxItems": 10,
  "maxRetries": 3
}
```

# Actor output Schema

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

All Jumbo.cl product rows (and free error rows) returned by this run.

# 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 = {
    "searchTerms": [
        "leche"
    ],
    "maxItemsPerTerm": 10,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("hhonlineventures/jumbo-product-search").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 = {
    "searchTerms": ["leche"],
    "maxItemsPerTerm": 10,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("hhonlineventures/jumbo-product-search").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 '{
  "searchTerms": [
    "leche"
  ],
  "maxItemsPerTerm": 10,
  "maxItems": 10
}' |
apify call hhonlineventures/jumbo-product-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hhonlineventures/jumbo-product-search"
        }
    }
}
```

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/orXzRv6hmOlvzuSLs/builds/bIgCH0p9mehw4o0Jf/openapi.json
