Ripley API

Ripley Chile and Peru products with all three prices, sellers, stock and reviews

Ripley is a department-store chain in Chile and Peru, and its websites sell both Ripley's own stock and the products of Mercado Ripley marketplace shops.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Ripley endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
R
/ripley/v1

5 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/ripley/v1/search
  • POST/ripley/v1/category
  • POST/ripley/v1/categories
  • POST/ripley/v1/product
  • POST/ripley/v1/reviews

What Ripley endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

5 endpoints

search

3 cr

Search Ripley (simple.ripley.cl Chile or simple.ripley.com.pe Peru).

required
query
optional
country, page, sort, brand, seller_type, min_price, max_price

category

3 cr

Browse one Ripley category by its path (e.g.

required
category
optional
country, page, sort, brand, seller_type, min_price, max_price

categories

3 cr

The Ripley category tree (Chile or Peru).

required
—
optional
country, depth

product

2 cr

One Ripley product by SKU (a search row's id), parent id or product URL.

required
—
optional
id, url, country, commune

reviews

1 cr

Customer reviews of one Ripley product.

required
id
optional
country, page, limit, sort

Every parameter, every allowed value →

Ripley API

5 of 5 endpoints, ready to run

View docs ↗

Notebooks on Ripley Chile

3 credits1 required · 0 optional
POST/ripley/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Ripley API works

Ripley is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 530 engines.

02
Call
POST /ripley/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a search to prices, sellers and reviews

Find products, read the three prices and the stock of the ones that matter, then read what buyers say.

01search?query=notebook
GET/ripley/v1/search?query=notebook

48 products with id, brand, the three prices, discount, seller, rating and variant SKUs, plus brand counts and filters.

02product?id=2000403871267
GET/ripley/v1/product?id=2000403871267

Normal, internet and Tarjeta Ripley prices, stock, EAN, seller, specification sheet and warranties.

03product?id=2000403871267&commune=13101
GET/ripley/v1/product?id=2000403871267&commune=13101

The same product with the delivery options for Santiago.

04reviews?id=2000403871267
GET/ripley/v1/reviews?id=2000403871267

Average rating, star histogram and the reviews.

A dated Ripley price feed for Chile or Peru with the card price kept apart, sellers, stock and review counts.

request
curl -X POST https://api.reefapi.com/ripley/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"notebook"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "ripley",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What a Ripley field actually contains

Fields that read differently from how they look. Every row was measured against live Ripley answers on 2026-10-15.

FieldWhat it holds
priceWhat a shopper without the Ripley card pays: the internet price. Chile in whole pesos (Ripley writes $729.990 for 729,990 CLP), Peru in soles (S/ 4,649.00).
normal_price, internet_price, card_priceThe three prices Ripley shows, kept apart: the crossed normal price, the internet price and the price only for Tarjeta Ripley holders. Search rows and the product record agreed on all three for 10 of 10 products. card_price is null when there is no card price (154 of 288 search rows had one).
seller, seller_typeripley when Ripley sells it, marketplace for a Mercado Ripley shop, with the shop's name (ASUS Tienda Oficial, Acer Store) and, in product, its legal name and tax id.
in_stock_index (search) vs in_stock (product)Search rows carry the search index's stock flag; product carries the product record's. They can differ: one notebook listed as in stock in search was out of stock on its product page. Use product for stock.
sponsoredPaid listings shown above the results. They are returned separately because Ripley does not apply your filters to them.
id, default_variant_skuid is the SKU you asked for (a search row's id opens the same product). For clothing and shoes, default_variant_sku is the size Ripley shows first.
totalRipley's own count of matches for the query and filters.

Brand names are case-sensitive at the source: HP returns 390 notebooks, hp returns 0. Copy brands from facets.brands.

Ripley coverage, measured

Every number below was read from live Ripley answers on 2026-10-15, in two consecutive runs of 43 calls each.

Actions

search, category, categories, product, reviews. Chile (simple.ripley.cl) and Peru (simple.ripley.com.pe).

Filters that bite

notebook 3,055 → HP 390, sold by Ripley 178, marketplace 2,882, 300,000-500,000 CLP 194. Same totals in both runs.

Price accuracy

Normal, internet and card price in search rows equal to the product record on 10 of 10 products (Chile) and 1 of 1 (Peru).

Field fill

On 288 search rows from 6 searches: id, name, brand, prices, seller and image 288/288, card price 154, rating 127. On 10 products: model 9, card price 5, EAN 4.

Search to product

10 of 10 ids from search rows opened in product with the same id and seller type, variant SKUs included.

Limits

Stock in search rows can be stale; product has the current stock. Sponsored listings ignore filters and come separately. Brand names are case-sensitive. Each listing answer is large (about 1 MB).

What people build with Ripley

The jobs this data is most often used for.

5

endpoints

1/2/3

credits per call

01

Track normal, internet and Tarjeta Ripley prices of a product list in Chile or Peru every day.

02

Compare Ripley prices with Falabella and Paris for the same EAN.

03

Monitor which Mercado Ripley shops sell a brand and at what price.

04

Check stock and delivery options of a product for a Chilean commune.

What Ripley data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 530 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/ripley/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"notebook"}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/ripley/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "notebook"
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Ripley.

Get a free key →
Do I need a Ripley account or a Tarjeta Ripley?▾

No. Everything is read logged out. The Tarjeta Ripley price is published by Ripley on its pages and comes back in its own field, card_price, never as price.

Does it cover Peru?▾

Yes. country=pe reads simple.ripley.com.pe with prices in soles; country=cl (the default) reads simple.ripley.cl in pesos. A notebook search returned 3,055 results in Chile and 413 in Peru.

Can I tell Ripley products from Mercado Ripley products?▾

Yes. seller_type is ripley or marketplace and seller names the shop. Filtering works: notebook 3,055 results, sold by Ripley 178, marketplace 2,882.

Which filters are there?▾

brand, seller_type, min_price, max_price, sort and page, each measured against the unfiltered count in the same run: notebook 3,055, HP 390, sold by Ripley 178, 300,000-500,000 CLP 194. Sorting by lowest price returned the page in ascending order.

Are the prices right?▾

Normal, internet and card prices in search rows matched the product record on 10 of 10 products in our check. Stock is the exception: use product, because the search index can still list an item that is out of stock.

Can I get delivery options for an address?▾

Pass a commune code to product (13101 is Santiago) and it returns the delivery and pickup options Ripley offers there, such as same-day delivery.

How fresh is the data?▾

Every call reads Ripley live; nothing is cached. Median times in our run: search 1.9 s, category 1.7 s, product 2.6 s, reviews 3.0 s.

How many results per page?▾

48 products per page plus the sponsored list. last_page and has_more tell you where a search ends.

What is the Ripley API?▾

Ripley API is a ReefAPI endpoint group for ripley in chile and peru: normal, internet and tarjeta ripley prices kept apart, ripley or mercado ripley seller, specs, stock and reviews. It returns live JSON through POST requests under /ripley/v1.

Is the Ripley API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Ripley calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Ripley login or account?▾

No login to Ripley 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 Ripley 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 Ripley API use?▾

Ripley 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 Ripley from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call ripley actions with the same key, credit pool and JSON envelope used by normal REST requests.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 529 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-15.