Ray-Ban Sunglasses Scraper

Extract structured sunglasses product data from Ray-Ban using the internal products API. The actor fetches product metadata and stores it in a ready-to-use dataset API format.

---

Features

• Fast API-based extraction — no browser overhead
• Extracts 15 structured fields per product including title, URL, price, description, model details, colors, and images
• Supports any Ray-Ban listing URL (sunglasses, eyeglasses, categories)
• Automatic pagination through all available products
• Deduplication built in
• Outputs clean structured data for analytics, monitoring, and integrations

---

Use Cases

• Track catalog pricing and assortment changes over time
• Build product intelligence datasets for market research
• Monitor competitor collections and merchandising updates
• Feed product data into dashboards and BI tools

---

Input Parameters

Field	Type	Description
startUrl	string	Ray-Ban listing URL to scrape (default: View All sunglasses)
results_wanted	integer	Maximum number of products to collect (default: 20)
max_pages	integer	Maximum number of listing pages to process (default: 10)
proxyConfiguration	object	Proxy settings for reliable requests

---

Output Data

Field	Type	Description
title	string	Product title
url	string	Product detail page URL
price	string	Product price with currency
description	string	Product description with attributes
model_name	string	Model name
model_family	string	Model family (e.g. Wayfarer, Aviator)
product_type	string	Product type (SUN, Optical, etc.)
frame_shape	string	Frame shape (Square, Round, etc.)
front_color	string	Front frame color
lens_color	string	Lens color
gender	string	Target gender
image_url	string	Product image URL
product_id	string	Unique product identifier
source_url	string	Listing URL where product was found
scraped_at	string	ISO timestamp of extraction

---

Usage Examples

{
  "startUrl": "https://www.ray-ban.com/usa/sunglasses/view-all",
  "results_wanted": 20,
  "max_pages": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

Sample Output

{
  "title": "ORIGINAL WAYFARER CLASSIC",
  "url": "https://www.ray-ban.com/sunglasses/RB2140original%20wayfarer%20classic-black/805289126577",
  "price": "USD 191",
  "description": "Legacy | ORIGINAL WAYFARER CLASSIC | WAYFARER | SUN | Square | Black | G-15 Green | Unisex",
  "model_name": "ORIGINAL WAYFARER CLASSIC",
  "model_family": "WAYFARER",
  "product_type": "SUN",
  "frame_shape": "Square",
  "front_color": "Black",
  "lens_color": "G-15 Green",
  "gender": "Unisex",
  "image_url": "https://www.ray-ban.com/prod-onecp-record-files/pieyewear/9cd2c330-b771-4dc5-95b9-b35d00c65f18/0RB2140__901__P21__shad__cfr.png",
  "product_id": "805289126577",
  "source_url": "https://www.ray-ban.com/usa/sunglasses/view-all",
  "scraped_at": "2026-07-08T12:46:52.556Z"
}

---

Tips

• Keep results_wanted aligned with your workflow to reduce run time
• Use proxy configuration for better consistency at larger scale
• Start from category URLs when you need targeted subsets

---

Integrations

• Export dataset via API for ETL pipelines
• Connect output to Make, Zapier, n8n, or custom automations
• Schedule recurring runs to maintain fresh product snapshots

---

FAQ

Why are fewer products returned than requested?

The listing may expose fewer products based on category size or pagination limits.

Can I scrape other Ray-Ban categories?

Yes. Set startUrl to any Ray-Ban listing URL.

Does it scrape product detail pages?

This version focuses on listing-level product data for speed and scale.

---

Legal Notice

Use this actor responsibly and ensure your usage complies with applicable laws and the target website terms.