Ripley.cl Product Scraper: Extract E-Commerce Search Results Data

---

What Is Ripley.cl?

Ripley.cl is the Chilean e-commerce platform of Ripley, one of Latin America's largest retail groups. The platform hosts hundreds of thousands of products across electronics, fashion, home goods, sports, and more. For businesses tracking market trends, monitoring competitor pricing, or building product databases, manually collecting this data is inefficient — the Ripley.cl Product Scraper automates the process by extracting structured product data directly from search result pages.

---

Overview

The Ripley Product Search Scraper crawls Ripley.cl search results and extracts detailed product information, transforming unstructured e-commerce listings into clean, machine-readable records. It is ideal for:

• Price comparison platforms aggregating Chilean retail data
• Market researchers analyzing product availability and pricing trends
• E-commerce analysts monitoring competitor assortments
• Inventory managers integrating external product catalogs
• Developers building Chilean retail datasets or price-tracking tools

The scraper handles pagination, multiple sellers, and dynamic pricing — delivering comprehensive product snapshots suitable for analytics, BI integration, or downstream processing.

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of Ripley.cl product search result URLs.

{
  "urls": [
    "https://simple.ripley.cl/search/lip?sort=relevance_desc&page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

2. Scrape by search filters — scrape data using a keyword and additional filters (price range, discount, sorting, etc.) instead of providing URLs.

{
  "keyword": "lip",
  "sort_by": "relevance_desc",
  "price_min": 10,
  "price_max": 100000,
  "discount": 30,
  "page": 1,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific search result URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	Links to Ripley.cl product search result pages. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. Include full URLs with query parameters (search terms, sorting, pagination).
ignore_url_failures	boolean	true	If true, the scraper continues running even if some URLs fail to load. If false, a single failure stops the entire run.

Example URLs:

• Search by keyword: https://simple.ripley.cl/search/laptop?sort=relevance_desc&page=1
• Search with filters: https://simple.ripley.cl/search/shoes?price_from=50000&price_to=150000
• Paginated results: https://simple.ripley.cl/search/electronics?page=3

Tip: Use the simple.ripley.cl subdomain for reliable scraping. Include sorting and filtering parameters to define your dataset scope.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
sort_by	string ("", price_asc, price_desc, review_desc)	—	Sort results by Relevance (empty), Price: Low to High, Price: High to Low, or Rating high to low.
price_min	number	—	The minimum price to filter items by.
price_max	number	—	The maximum price to filter items by.
discount	string ("", 10, 20, 30, 40, 50, 60)	—	Minimum discount percentage: Any, 10% and up, 20% and up, 30% and up, 40% and up, 50% and up, 60% and up.
page	integer	—	The page number to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	The maximum number of products extracted per URL/search. Useful to limit data volume or cost.
proxy	object	Apify Proxy — RESIDENTIAL group, country NL	Proxy configuration used by the scraper.

---

Output Format

Sample output

{
  "sku": "12687819",
  "parent_product_id": null,
  "code": "6be161e5-62d6-42c6-a127-4d5400180f47",
  "brand": "CATRICE",
  "description": "-",
  "primary_image": "https://rimage.ripley.cl/home.ripley/Attachment/MKP/7945/MPM10001128439/full_image-1.jpeg",
  "category_code": "R300702000000",
  "xcatentry_category": "D777",
  "product_type": "ItemBean",
  "name": "LIP JAM BRILLO DE LABIOS HIDRATANTE 10ML CATRICE",
  "images": [
    "https://rimage.ripley.cl/home.ripley/Attachment/MKP/7945/MPM10001128439/full_image-1.jpeg"
  ],
  "variants": [
    {
      "sku": "12687819",
      "primary_image": "https://rimage.ripley.cl/home.ripley/Attachment/MKP/7945/MPM10001128439/full_image-1.jpeg",
      "images": [
        "https://rimage.ripley.cl/home.ripley/Attachment/MKP/7945/MPM10001128439/full_image-1.jpeg"
      ],
      "has_ripley_points": false,
      "ripley_points": null
    }
  ],
  "colors": [],
  "sponsored": null,
  "rating_reviews": {
    "score": 0,
    "count": 0
  },
  "old_price": null,
  "price": "$6.990",
  "ripley_price": null,
  "price_number": 6990,
  "discount": 0,
  "discount_sale_price": null,
  "has_initial_price": false,
  "badges_top": [],
  "badges_middle": [],
  "badges_bottom": [
    {
      "tag": "cuatro_csi_ripley",
      "label": "4 cuotas sin interés",
      "font_color": "#000000",
      "background_color": "#efefef",
      "value": "4 cuotas sin interes",
      "type": "cuotas"
    }
  ],
  "position": 2,
  "shop": {
    "id": "7945",
    "seller_id": 7159,
    "mirakl_id": 10352,
    "legal_name": "Comercial Giacaman SpA",
    "shop_name": "BONIK"
  },
  "seller": "MARKETPLACE",
  "sponsored_type": null,
  "has_ripley_points": false,
  "ripley_points": null,
  "from_url": "https://simple.ripley.cl/search/lip?sort=relevance_desc&page=2"
}

Each product in the results returns a comprehensive record with 30+ fields:

Product Identification

Field	Meaning
SKU	Stock keeping unit — unique product identifier
Parent Product ID	ID linking to the parent product (for variants)
Code	Internal Ripley product code
Name	Product display name shown on search results
Description	Short product description

Classification & Categories

Field	Meaning
Brand	Manufacturer or brand name
Category Code	Ripley's internal category classification
Xcatentry Category	Extended category taxonomy used in product routing
Product Type	Classification (e.g., electronics, apparel, home)

Visual Assets

Field	Meaning
Primary Image	Main product image URL (highest resolution)
Images	Array of all product image URLs
Colors	Available color variants (if applicable)
Variants	Size, color, or configuration options offered

Pricing & Discounts

Field	Meaning
Price	Current listed price in CLP (Chilean Pesos)
Price Number	Price as a numeric value (for calculations)
Old Price	Original price before discount
Ripley Price	Special Ripley member pricing (if available)
Discount	Discount percentage or amount
Discount Sale Price	Price after applied discount
Has Initial Price	Boolean flag indicating if an initial price exists

Engagement & Social Proof

Field	Meaning
Rating Reviews	Customer rating and review count (e.g., 4.5/5, 127 reviews)
Has Ripley Points	Whether the product awards Ripley Points (loyalty currency)
Ripley Points	Number of Ripley Points earned on purchase

Promotions & Flags

Field	Meaning
Badges Top	Badges displayed above product (e.g., "Free Shipping")
Badges Middle	Middle section badges (e.g., "Limited Offer")
Badges Bottom	Bottom badges (e.g., "Seller Rating")
Sponsored	Boolean — whether the listing is a sponsored ad
Sponsored Type	Type of sponsorship (if applicable)

Seller & Logistics

Field	Meaning
Shop	Ripley official shop or partner name
Seller	Third-party seller username (if applicable)

Metadata

Field	Meaning
Position	Product rank on the current search results page (1st, 2nd, etc.)

---

How to Use

1. Identify search URLs — Visit Ripley.cl, perform searches, and copy the result page URLs. You can include filters (price range, brand, rating) in the URL.

2. Configure input — Paste your URLs into the urls array. Set max_items_per_url to control the volume (e.g., 50 for light sampling, 200 for comprehensive data).

3. Enable failure handling — Set ignore_url_failures: true for bulk runs to prevent interruptions if a single URL fails.

4. Execute the scraper — Start the run and monitor progress in the actor log.

5. Export results — Download data as JSON, CSV, or Excel for analysis or integration.

Best practices:

• Use the simple.ripley.cl subdomain for more stable scraping
• Combine related searches in one run to maximize efficiency
• Include max_items_per_url limits to avoid timeouts on large result sets
• Test with one URL first before scaling to multiple pages

Common troubleshooting:

• If a URL times out, reduce max_items_per_url and retry
• If you receive empty results, verify the URL structure is correct (should contain /search/ path)
• Use ignore_url_failures: true to skip problematic URLs in bulk runs

---

Use Cases & Business Applications

• Price monitoring: Track product pricing across Ripley categories hourly or daily to detect trends
• Competitor analysis: Monitor competitor inventory, ratings, and promotional strategies
• Market research: Analyze product availability, brand distribution, and customer sentiment in the Chilean market
• Product intelligence: Build catalogs for price comparison sites or retail aggregators
• Discount tracking: Identify sales, promotions, and Ripley Points opportunities

The scraper's rich output enables advanced analytics: pricing elasticity studies, brand performance benchmarking, and seasonal trend analysis — all from a single data source.

---

Conclusion

The Ripley.cl Product Scraper provides comprehensive e-commerce data extraction for anyone analyzing the Chilean retail landscape. With 30+ fields covering pricing, ratings, images, and seller information, it delivers the structured data needed for competitive intelligence, market research, and product analytics. Start today and unlock actionable insights from Ripley's extensive catalog.