ripley.com APIripley.com ↗
Access Ripley.cl product search and detailed product data including prices, availability, images, and specs via two simple API endpoints.
curl -X GET 'https://api.parse.bot/scraper/494f7d69-d0b5-4931-8535-8e23dc9e40ee/search_products?query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Ripley.cl by keyword. Returns up to 48 products per request sorted by relevance.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'televisores', 'laptop', 'Samsung') |
{
"type": "object",
"fields": {
"count": "integer total number of matching products",
"products": "array of product summaries with name, sku, part_number, brand, url, image, list_price, offer_price, card_price, discount_percentage, and is_available"
},
"sample": {
"data": {
"count": 79,
"products": [
{
"sku": "2000410378872",
"url": "https://simple.ripley.cl/smart-tv-hisense-qled-full-hd-43-43q4sv-2000410378872p",
"name": "SMART TV HISENSE QLED FULL HD 43” 43Q4SV",
"brand": "HISENSE",
"image": "https://rimage.ripley.cl/home.ripley/Attachment/WOP/1/2000410378872/full_image-2000410378872",
"card_price": 189990,
"list_price": 239990,
"offer_price": 199990,
"part_number": "2000410378872P",
"is_available": true,
"discount_percentage": 21
}
]
},
"status": "success"
}
}About the ripley.com API
The Ripley.cl API exposes 2 endpoints for accessing product data from one of Chile's largest department store retailers. Use search_products to query the catalog by keyword and retrieve up to 48 results per request, each including list price, offer price, card price, and discount percentage. Use get_product_details to pull full product records by SKU, covering availability, color variants, shipping methods, category paths, and an HTML description.
Product Search
The search_products endpoint accepts a single query string (e.g., 'televisores', 'laptop', 'Samsung') and returns a count of total matching products along with an array of up to 48 product summaries. Each summary includes name, sku, part_number, brand, url, image, list_price, offer_price, card_price, and discount_percentage. The sku field from these results is the key input for the detail endpoint.
Product Details
The get_product_details endpoint takes a sku string and returns a full product record. Price data is structured as a prices object containing list_price, offer_price, card_price, discount_percentage, formatted_list_price, and formatted_offer_price — useful for distinguishing between standard retail price and Ripley card holder pricing. The availability object includes an in_stock boolean and a shipping_methods array. Additional fields include colors (array of color name strings), images (array of objects with src), categories (array of category name strings), and description (HTML string).
Coverage and Scope
Both endpoints target the Ripley.cl Chilean catalog. Results reflect Ripley's own inventory and pricing tiers, including their Ripley card promotional pricing alongside standard offer prices. The categories array reflects the full category path for each product, making it straightforward to group or filter retrieved items by department.
- Track price changes across list_price, offer_price, and card_price for specific SKUs over time
- Build a product comparison tool using brand, specifications, and formatted prices from get_product_details
- Monitor in_stock availability and shipping_methods for restock alerting
- Aggregate category-level inventory data using the categories array across multiple search queries
- Sync Ripley.cl product images and descriptions into a third-party catalog or CMS
- Identify discount_percentage trends across product segments by running keyword searches periodically
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ripley have an official public developer API?+
What is the difference between list_price, offer_price, and card_price in the response?+
prices object returned by get_product_details, list_price is the standard retail price, offer_price is a promotional or sale price available to any customer, and card_price is a lower price exclusive to Ripley card holders. The discount_percentage reflects the reduction from list price to offer price. All three values are also available in formatted string form.Does the API return customer reviews or seller ratings for products?+
Is pagination supported for search results beyond 48 products?+
search_products endpoint returns up to 48 products per request and exposes a total count field, but there is no offset or page parameter in the current spec. The API covers the top relevance-ranked results for a given query. You can fork it on Parse and revise to add pagination support.