# TheRealReal.com Scraper (`lexis-solutions/therealreal-com-scraper`) Actor Scrape TheRealReal.com luxury resale products (US/Global) for ecommerce analytics and price monitoring. Extract brand, title, prices, condition, images, SKU and sustainability attributes for secondhand fashion and luxury marketplace research. - **URL**: https://apify.com/lexis-solutions/therealreal-com-scraper.md - **Developed by:** [Lexis Solutions](https://apify.com/lexis-solutions) (community) - **Categories:** E-commerce, Automation, AI - **Stats:** 11 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $39.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![TheRealReal.com Scraper](https://i.postimg.cc/Df9kKvtT/therealreal.png) ### What does TheRealReal.com Scraper do? TheRealReal.com Scraper helps you search and extract product data from **therealreal.com**, a luxury resale ecommerce marketplace. You can extract product details such as title, brand, description, SKU, pricing, condition, images, and attributes (including sustainability metrics) from product listings and product pages. TheRealReal.com Scraper supports REST API access to the extracted dataset, so you can download and use the results in other tools and workflows. ### TheRealReal.com Scraper TheRealReal.com Scraper allows you to search and extract ecommerce product data from TheRealReal.com. The scraper supports REST API access for the output dataset, including multiple export formats for analytics, monitoring, and catalog enrichment use cases. ### What data can I extract from TheRealReal.com with a web scraper? With this web scraping tool, you can extract the following data from TheRealReal.com:
Product title Product description
Brand Condition
Current price Estimated retail price
SKU / item number Badge (if available)
Featured image and gallery URLs Product attributes (including sustainability metrics)
### Why scrape TheRealReal.com? TheRealReal.com is a major marketplace for authenticated luxury resale items across categories such as clothing, handbags, shoes, jewelry, and accessories. Its listings contain rich product metadata that is useful for ecommerce intelligence and resale analytics. Whether you are a reseller, pricing analyst, catalog manager, or market researcher, scraping TheRealReal.com can help you: - Monitor luxury resale pricing trends - Track inventory changes for brands and categories - Analyze condition and product metadata consistency - Collect product-level details for comparison and research - Build enriched datasets for ecommerce intelligence - Identify market opportunities in secondhand luxury ### How to use TheRealReal.com Scraper? TheRealReal.com Scraper is designed for a fast setup, even if you have never scraped ecommerce websites before. Here is how to extract data from TheRealReal.com: 1. Create a free Apify account using your email. 2. Open TheRealReal.com Scraper on the Apify platform. 3. Click on the **Try for free** button. 4. Enter one or more start URLs (search/listing pages and/or product detail pages). 5. Set `maxItems` based on how many products you want to collect. 6. Click on **Start** and wait for extraction to finish. 7. Download your data in JSON, XML, CSV, Excel, HTML, JSONL, or NDJSON. ### Input The actor accepts the following input parameters: - `startUrls` (array of objects) - **Required**. URLs to start with. You can provide both listing/search URLs and individual product detail URLs. - `maxItems` (integer) - Maximum number of products to scrape per start URL. Default: 5. - `proxyConfiguration` (object) - Proxy configuration settings for crawling. #### Supported URL Types You can use both listing/search pages and individual product detail pages: **Listing / Search Pages Examples:** - Search page: `https://www.therealreal.com/products?keywords=prada` - Category page: `https://www.therealreal.com/shop/women/clothing/designer_sweaters` **Product Detail Pages Examples:** - Detail page: `https://www.therealreal.com/products/women/handbags/totes/prada-vitello-daino-leather-dynamique-small-tktoh` Example: ```json { "startUrls": [ { "url": "https://www.therealreal.com/products?keywords=prada" }, { "url": "https://www.therealreal.com/products/men/clothing/outerwear/stussy-vintage-1992-utility-jacket-t8bul" } ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ``` #### Note: The startUrls field is required ### Output The scraped data is saved as a dataset. Each item represents one TheRealReal product. You can download the output in JSON, JSONL, HTML table, CSV, Excel spreadsheet, or NDJSON. In the output below, you can see a preview of one dataset item. Actual fields may vary by product page completeness. ```json { "url": "https://www.therealreal.com/products/men/clothing/outerwear/stussy-vintage-1992-utility-jacket-t8bul", "productBadge": "Editors' Pick", "description": "Stüssy Leather Utility JacketVintageFrom the 1992 CollectionBlack, Size not listed, estimated from measurements., Fit:Outerwear by Stüssy typically fit true to size.", "brand": "Stüssy", "title": "Vintage 1992 Utility Jacket", "imageUrls": [ "https://product-images.therealreal.com/WSTUY26335_1_enlarged.jpg?auto=webp&width=3840", "https://product-images.therealreal.com/WSTUY26335_2_enlarged.jpg?auto=webp&width=3840" ], "featuredImage": "https://product-images.therealreal.com/WSTUY26335_1_enlarged.jpg?auto=webp&width=3840", "originalPrice": "$2,525", "finalPrice": "$2,398.75", "condition": "Good", "favoriteCount": "32", "sku": "WSTUY26335", "attributes": [ { "attributeName": "Chest", "attributeValue": "43\"" }, { "attributeName": "Item #", "attributeValue": "WSTUY26335" }, { "attributeName": "L of Water Saved", "attributeValue": "350" }, { "attributeName": "Kg of Carbon Saved", "attributeValue": "12.32" } ] } ``` #### Notes and Limitations - The actor relies on the current structure of therealreal.com. If the website structure changes, the actor may need updates. - Use this actor in compliance with TheRealReal terms of service and all applicable laws. - For large-scale scraping, use Apify proxy services and tune your input settings. #### Looking to Scrape more Ecommerce Websites? In addition to this actor, you can explore our suite of dedicated ecommerce scrapers. Each scraper is optimized for its target site to provide accurate, structured, and reliable data extraction. | Scraper | Region | Description | | -------------------------------------------------------------------------------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Otto.de Scraper](https://apify.com/lexis-solutions/otto-de-scraper) | Germany | The Otto.de Apify Scraper is an automated tool for extracting valuable data from Otto.de - one of the leading e-commerce platforms in Germany. It provides businesses with insights for market analysis, competitor monitoring, and price tracking. Ideal for e-commerce and market research. | | [Poshmark.com Scraper](https://apify.com/lexis-solutions/poshmark-scraper) | Global | Scrape product listings from Poshmark.com - including item names, prices, sizes, brands, seller info, and images. Ideal for market research, trend tracking, price comparison, and inventory insights. Fast, structured, and customizable extraction from a leading social commerce platform. | | [Barnes and Noble Product Scraper](https://apify.com/lexis-solutions/barnesandnoble-scraper) | United States | Gather product details with the Barnes and Noble Product Scraper. Extract titles, authors, prices, and ISBNs directly from Barnes and Noble. Optimize your e-commerce strategy with accurate, up-to-date data. | Explore these solutions to expand your data collection capabilities across ecommerce websites. *** p.s. Got feedback or need an extension? Lexis Solutions is a [certified Apify Partner](https://apify.com/partners). We can help you with custom solutions or data extraction projects. Contact us over [Email](mailto:info@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions) ### Image Credit Image credit: https://www.therealreal.com/ # Actor input Schema ## `startUrls` (type: `array`): URLs to start with. ## `maxItems` (type: `integer`): Maximum number of products that will be extracted. ## `proxyConfiguration` (type: `object`): Select proxies to be used by your crawler. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.therealreal.com/products?keywords=prada" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "groups": [ "RESIDENTIAL" ], "countryCode": "US" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.therealreal.com/products?keywords=prada" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("lexis-solutions/therealreal-com-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.therealreal.com/products?keywords=prada" }] } # Run the Actor and wait for it to finish run = client.actor("lexis-solutions/therealreal-com-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.therealreal.com/products?keywords=prada" } ] }' | apify call lexis-solutions/therealreal-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lexis-solutions/therealreal-com-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/67HNHnE8gd7vBkKl7/builds/puIK2AsZgw0tlVXYg/openapi.json