Paris.cl API & Scraper
Paris is Cencosud's department store chain in Chile, and paris.cl sells both Paris's own stock and the products of Marketplace shops.
🤖 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.
`search` and `category` return one page of products (24 by default, up to 60): id, name, brand, the search index's lowest price (the Tarjeta Cencosud price when there is one), discount %, the seller and whether it is Paris or a Marketplace shop, product type, category path, rating, review count, image and every size or colour variant with its own SKU, plus the filter values with counts. Filters: brand, seller type, price range, category, sort and page, and by default the same in-stock view the site shows. `product` returns the three prices separately (the crossed normal price, the internet price and the Tarjeta Cencosud card price) for the product and for each variant, with EAN, model, seller and its legal name, the specification sheet, every attribute, extended-warranty offers and the description. `stock` gives the stock level, unit count and delivery and pickup options of up to 40 SKUs for any Chilean comuna. `reviews` returns the rating distribution, the site's AI review summary and every review. `categories` lists the category tree with product counts.
What a Paris.cl field actually contains
Fields that read differently from how they look. Every row was measured against live Paris.cl answers and product pages on 2026-10-15.
| Field | What it holds |
|---|---|
| price, price_type | What a shopper without the Paris card pays: the internet price, or the normal price when there is no internet price. In whole Chilean pesos (Paris writes $579.990 for 579,990 CLP). |
| normal_price, internet_price, card_price | The three prices Paris shows on a product page, kept apart: the crossed normal price, the internet price and the price only for Tarjeta Cencosud holders. All three matched the product page on 12 of 12 products across notebooks, sneakers, sofas, perfume, fridges and T-shirts. card_price is null when the product has no card price (5 of the 12). |
| search_index_price | In search rows: the lowest price the search index holds for the product, which is the card price when there is one. On 19 of 20 products it equalled the product's own lowest price; on one TV the index was lower than any price on the product page. Use product for the three current prices. |
| seller, seller_type | Paris itself (seller_type paris) or the Marketplace shop's name (Acer Tienda Oficial, Muebles Cottoni). The seller in search rows and in product agreed on 20 of 20 products. |
| variants | Every size or colour with its own SKU, EAN and three prices. A T-shirt carried 83 variants. Pass a variant SKU to stock. |
| stock_quantity, stock_level, shipping_options | Units and IN_STOCK / LOW_STOCK / OUT_OF_STOCK for the comuna you ask for (13114 Las Condes by default), with each delivery and pickup option. The same SKUs gave different options in Las Condes and Iquique. |
| total, total_capped | Paris's own count of matches. It stops at 10,000; total_capped says when it did. |
| ai_summary | The review summary Paris generates and shows above the reviews. It is Paris's text, not ours. |
Search counts match what paris.cl lists by default (products with stock for delivery or pickup): notebook 836 on the site view against 6,441 in the full index. include_unavailable=true returns the full index.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/paris-cl/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "notebook"
}
}{
"ok": true,
"meta": {
"api": "paris-cl",
"endpoint": "search",
"mode": "live",
"latency_ms": 1202.6,
"record_count": 24,
"bytes": 233606,
"cache_hit": false,
"total": 858,
"sort": "relevance",
"view": "site view (in stock)",
"currency": "CLP",
"upstream_requests": 1,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "3a9d0368f19f4363",
"queue_ms": 1.4,
"fetched_at": "2026-10-18T11:42:01.736Z"
},
"data": {
"query": "notebook",
"category_id": null,
"total": 858,
"total_capped": false,
"page": 1,
"page_size": 24,
"last_page": 36,
"beyond_last_page": false,
"returned": 24,
"results": [
{
"id": "MKSQKNFQC9",
"variation_id": "MKSQKNFQC9-1",
"name": "Notebook Acer Aspire Lite AL15-46P-R7M1-2 AMD Ryzen 3 8GB RAM 256GB SSD 15.6\" FHD",
"brand": "Acer",
"url": "https://www.paris.cl/notebook-acer-aspire-lite-al15-46p-r7m1-2-amd-ryzen-3-8gb-ram-256gb-ssd-156-fhd-MKSQKNFQC9.html",
"search_index_price": 389990,
"search_index_price_note": "the search index's lowest price for this product: the Tarjeta Cencosud price when it has one, else the internet price; it can lag the product record (19 of 20 matched in our audit). The three current prices are in `product`.",
"discount_pct": 35,
"currency": "CLP",
"seller": "Acer Tienda Oficial",
"sellers": [
"Acer Tienda Oficial"
],
"seller_type": "marketplace",
"product_type": "Notebooks",
"category": "Acer",
"category_id": "tecMrcAcer",
"category_path": [
"Tecno",
"Marcas Destacadas",
"Acer"
],
"rating": null,
"review_count": 0,
"image": "https://cl-cenco-pim-resizer.ecomm.cencosud.com/unsafe/adaptive-fit-in/792x1068/prd-cl/product-medias/982b3e60-7f14-4f19-953d-457fbaa85cab/MKSQKNFQC9/MKSQKNFQC9-1/1785880720652-MKSQKNFQC9-1-1.jpg",
"color": "Único Color",
"model": null,
"variant_count": 1,
"variants": [
{
"sku": "[trimmed-depth]",
"size": "[trimmed-depth]",
"color": "[trimmed-depth]",
"search_index_price": "[trimmed-depth]",
"image": "[trimmed-depth]"
}
],
"rank": 1
},
{
"id": "151337999",
"variation_id": "151337999",
"name": "Notebook Galaxy Book4 Intel Core i5 13va Gen 16GB RAM 512GB SSD 15.6'' Silver",
"brand": "Samsung",
"url": "https://www.paris.cl/notebook-galaxy-book4-intel-core-i5-13va-gen-16gb-ram-512gb-ssd-156-silver-151337999.html",
"search_index_price": 599990,
"search_index_price_note": "the search index's lowest price for this product: the Tarjeta Cencosud price when it has one, else the internet price; it can lag the product record (19 of 20 matched in our audit). The three current prices are in `product`.",
"discount_pct": 31,
"currency": "CLP",
"seller": "Paris",
"sellers": [
"Paris"
],
"seller_type": "paris",
"product_type": "Notebooks",
"category": "Notebooks",
"category_id": "tecCompNotebooks",
"category_path": [
"Tecno",
"Computadores",
"Notebooks"
],
"rating": 4.66667,
"review_count": 6,
"image": "https://cl-dam-resizer.ecomm.cencosud.com/unsafe/adaptive-fit-in/792x1068/cl/paris/151337999/variant/68123dd9afa563bc0a571ae8/images/2e38490c-312f-4966-a421-b87fc2f07a1d/151337999-0000-001.jpg",
"color": "Único Color",
"model": "NP750XGJ-KS5CL",
"variant_count": 1,
"variants": [
{
"sku": "[trimmed-depth]",
"size": "[trimmed-depth]",
"color": "[trimmed-depth]",
"search_index_price": "[trimmed-depth]",
"image": "[trimmed-depth]"
}
],
"rank": 2
},
{
"id": "332774999",
"variation_id": "332774999",
"name": "Notebook Gamer TUF F16 Intel Core 5 Nvidia GeForce RTX 3050 8GB RAM 512GB SSD 16'' 144Hz",
"brand": "Asus",
"url": "https://www.paris.cl/notebook-gamer-tuf-f16-intel-core-5-nvidia-geforce-rtx-3050-8gb-ram-512gb-ssd-16-144hz-332774999.html",
"search_index_price": 759990,
"search_index_price_note": "the search index's lowest price for this product: the Tarjeta Cencosud price when it has one, else the internet price; it can lag the product record (19 of 20 matched in our audit). The three current prices are in `product`.",
"discount_pct": 31,
"currency": "CLP",
"seller": "Paris",
"sellers": [
"Paris"
],
"seller_type": "paris",
"product_type": "Notebooks Gamers",
"category": "Tecno Circular",
"category_id": "tecCompTecnoCircular",
"category_path": [
"Tecno",
"Computadores",
"Tecno Circular"
],
"rating": 3.5,
"review_count": 4,
"image": "https://cl-dam-resizer.ecomm.cencosud.com/unsafe/adaptive-fit-in/792x1068/cl/paris/332774999/variant/6a76127ea6bf41d2b58e20c7/images/e594df72-b9b5-4039-9ae5-34f1214e8424/332774999-0000-001.jpg",
"color": "Único Color",
"model": "ASUS TUF Gaming F16 FX607VJB-RL112W",
"variant_count": 1,
"variants": [
{
"sku": "[trimmed-depth]",
"size": "[trimmed-depth]",
"color": "[trimmed-depth]",
"search_index_price": "[trimmed-depth]",
"image": "[trimmed-depth]"
}
],
"rank": 3
}
],
"facets": [
{
"name": "tipoProductoAll",
"label": "Tipo de Producto",
"values": [
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
},
{
"name": "brand",
"label": "Marca",
"values": [
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
},
{
"name": "regularPrice",
"label": "Rangos de precio",
"values": [
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"value": "[trimmed-depth]",
"label": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
]
}
],
"categories": [
{
"id": "ecommerce-root",
"name": "ecommerce",
"count": 858
},
{
"id": "tecnologia",
"name": "Tecno",
"count": 858
},
{
"id": "CategDescuentoParis",
"name": "Top Ofertas",
"count": 10
}
]
}
}What the Paris.cl API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Paris.cl (Cencosud, Chile) — Paris's own stock and its Marketplace shops. One page of products: id, name, brand, the search index's lowest price (`search_index_price`: the Tarjeta Cencosud price when there is one), discount %, seller and whether it is Paris or a Marketplace shop, product type, category path, rating, review count, image and every size/colour variant with its own SKU — plus the source's facet counts (brands, seller types, product types, price and discount bands). Filters: brand, seller_type, min_price, max_price, category; sort; page. By default the same in-stock view the site shows. For the three separate prices (normal / internet / card) call `product`. `query` is required. | Pricing teams call search to search Paris.cl (Cencosud, Chile). | query, category, page, page_size, sort, ... |
| category | Browse one Paris.cl category (e.g. tecCompNotebooks = Notebooks, tecnologia = Tecno) — the same rows, filters, sort and facets as `search`, without a keyword. Category ids come from `categories` or from a search row's `category_id`. `category` is required. | Marketplace operators call category to get browse one Paris.cl category (e.g. | category, page, page_size, sort, brand, ... |
| categories | The Paris.cl category tree with product counts per category: the top departments, or the children of one `category`. Ids feed `category` and `search`. | Catalog enrichment teams call categories to get the Paris.cl category tree with product counts per category. | category, depth |
| product | One Paris.cl product by id (as search rows return it), variant SKU or product URL: the three prices kept apart — normal (crossed) price, internet price and the Tarjeta Cencosud card price — with discount %, EAN, brand, model, seller (Paris or the Marketplace shop) and its legal name, category path, rating and review count, all images, description, the specification sheet, every attribute, extended-warranty offers with their price, and every size/colour variant with its own SKU, EAN and three prices. Stock per comuna: `stock`. One of `id`, `sku` or `url` is required. | Retail analysts call product to get one Paris.cl product by id (as search rows. | id, sku, url |
| stock | Stock and delivery options of one or more Paris.cl SKUs for a Chilean comuna: whether it can be delivered/picked up there, the stock level (IN_STOCK, LOW_STOCK, OUT_OF_STOCK), the unit count the source publishes, and each shipping option (home delivery scheduled / next day, pickup at Copec or in store) with its own stock and order-by time. Up to 40 SKUs of the same call are answered by the source in one request. `sku` is required. | Pricing teams call stock to get stock and delivery options of one or more Paris.cl SKUs for a Chilean comuna. | sku, comuna |
| reviews | Ratings and reviews of one Paris.cl product: average rating, review count, the 1-5 star distribution, the site's AI-written review summary, and the reviews (rating, title, text, reviewer nickname, month, recommended flag, helpful votes, photo count). `id` is required (the product id, not a variant SKU). | Marketplace operators call reviews to get ratings and reviews of one Paris.cl product. | id, page, page_size, with_text_only, sort |
Call search from your stack
curl -X POST https://api.reefapi.com/paris-cl/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"notebook"}'import requests
r = requests.post(
"https://api.reefapi.com/paris-cl/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "notebook"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/paris-cl/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "notebook"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.paris-cl.search with {"query":"notebook"}.Who uses this API and why
- Track normal, internet and Tarjeta Cencosud prices of a product list on Paris.cl every day.
- Compare Paris prices with Falabella and Ripley for the same EAN.
- Monitor which Marketplace shops sell a brand on Paris.cl and at what price.
- Check stock and delivery options of each size in different Chilean comunas.
- Collect ratings, star distributions and written reviews for product research.
Questions developers ask before integrating
Do I need a Paris account or a Tarjeta Cencosud?
No. Everything is read logged out. The Tarjeta Cencosud price is published by Paris on every product page, and it is returned in its own field, card_price, never as price.
Which prices do I get?
product returns normal_price, internet_price and card_price, for the product and for each size or colour. On 12 products checked against their Paris.cl pages all prices matched. Search rows carry the search index's lowest price for fast comparison.
Can I tell Paris products from Marketplace products?
Yes. seller_type is paris or marketplace and seller names the shop. You can filter on it: notebook 836 results, sold by Paris 47.
Which filters are there?
brand, seller_type, min_price, max_price and category, each measured against the unfiltered count in the same run: notebook 836, Lenovo 212, sold by Paris 47, 300,000-500,000 CLP 271. Brand names are case-sensitive at the source (Lenovo 212, lenovo 0); copy them from facets.
Does stock depend on where I am?
Stock depends on the comuna you pass, not on where the request comes from. Pass any Chilean comuna code (13114 Las Condes is the default, 1101 Iquique, 5101 Valparaíso) to see stock and delivery options there.
How many reviews do I get?
All of them: Paris returns the full set at once (241 on one fridge), with the 1-5 star distribution and the AI summary. Many are star-only ratings; with_text_only=true keeps the written ones.
How fresh is the data?
Every call reads Paris.cl live; nothing is cached. Median times in our run: product 0.9 s, stock 0.85 s, search 1.4 s, reviews 1.6 to 2.0 s.
How deep can I page?
Up to 60 products per page, until Paris's 10,000-result limit. last_page tells you where a search ends; a page past it returns no rows and beyond_last_page true.
What is the Paris.cl API?
Paris.cl API is a ReefAPI endpoint group for paris (cencosud) in chile: normal, internet and tarjeta cencosud prices kept apart, marketplace sellers, variants, stock per comuna and reviews. It returns live JSON through POST requests under /paris-cl/v1.
Is the Paris.cl API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Paris.cl calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Paris.cl login or account?
No login to Paris.cl 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 Paris.cl 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 Paris.cl API use?
Paris.cl actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Paris.cl from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call paris-cl actions with the same key, credit pool and JSON envelope used by normal REST requests.