GET
Search
/api/therealreal/search
Search by keyword or category with filters and facets
The RealReal API
The RealReal API for Luxury Consignment Search, Filters, Facets, and Item Details
Scrappa's The RealReal API returns structured JSON from The RealReal, the US luxury consignment marketplace. Search by keyword or category with designer, condition, size, color and price filters, and read the filter facets in the same response. Read one item with description, measurements and condition notes.
500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
2
Endpoints
120
Items per page
3-6
Credits per request
Try it now
Make one request. Inspect structured JSON.
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
Request preview
Request
curl -X GET "https://scrappa.co/api/therealreal/search?query=gucci%20bag&condition=very-good&price_max=500" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
JSON response
{
"success": true,
"items": [
{
"sku": "GUC2115290",
"name": "GG Signature Shoulder Bag",
"brand": "Gucci",
"price": 322.5,
"original_price": 645.0,
"currency": "USD",
"discount_percent": 50.0,
"availability": "available",
"condition": "Very Good"
}
],
"pagination": { "page": 1, "per_page": 120, "total": 10355, "reachable": 2000, "returned": 1, "filtered_out": 0, "has_next_page": true },
"facets": [{ "name": "Designers", "parameter": "designer", "buckets": [{ "id": "544", "name": "Gucci", "count": 37451 }] }],
"meta": { "endpoint_family": "search", "billable": true, "credits": 6 }
}What you can build
Structured data for real applications. Here are some ideas.
Luxury Resale Price Monitoring
Track prices, price drops and availability for a designer, category or SKU over time.
Assortment and Trend Analysis
Read facet counts for designers, categories, conditions and colors to see what is listed.
Resale Arbitrage
Compare The RealReal prices with Vestiaire, Poshmark and Vinted to find items priced low.
Condition and Authenticity Checks
Read the condition grade, condition notes and measurements of an item before you buy.
The RealReal scraper API
The RealReal API for luxury resale search and item details
The RealReal API is built for price monitoring, assortment analysis and resale research. Every item carries the price as a number with currency, the original price, the discount and its availability.
Filter by designer, condition, size, color, price and category. A filter the site did not apply returns an error, never unfiltered items.
Every search response carries the filter facets with ids and counts.
A search costs 6 credits, an item lookup by url 3 credits. Failed requests and empty pages are not billed.
The site serves the first 2000 items of a listing. Sorting is not available.
Only public data is returned. No login is needed on your side.
Choose the right The RealReal API endpoint
Use Search to find items and facets
Send a query or a category path. Use the facet ids of the response for the next, narrower search.
Open The RealReal Search API docsUse Item to read one item
Send the product url of a search row to get the description, measurements and condition notes.
Open The RealReal Item API docsAvailable endpoints
Everything you need in one API.
GET
Item
/api/therealreal/product
Get one item with description, measurements and condition
Scrappa vs ScrapingBee / ScraperAPI
See how Scrappa compares to ScrapingBee / ScraperAPI.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| The RealReal data as JSON | Build your own parser | |
| Filters that are always honoured | Typed parameters | Build the query yourself |
| Bot protection handled | Often blocked | |
| Unified API key | Yes (350+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
The RealReal data as JSON
- Scrappa
- ScrapingBee / ScraperAPI
- Build your own parser
Filters that are always honoured
- Scrappa
- Typed parameters
- ScrapingBee / ScraperAPI
- Build the query yourself
Bot protection handled
- Scrappa
- ScrapingBee / ScraperAPI
- Often blocked
Unified API key
- Scrappa
- Yes (350+ APIs)
- ScrapingBee / ScraperAPI
- Scraping only
Free tier
- Scrappa
- 500 credits/month
- ScrapingBee / ScraperAPI
- Trial credits
Key features
Search by keyword or category with designer, condition, size, color and price filters
Filter facets with ids and counts in every search response
Prices as numbers with currency, original price and discount
Description, measurements, condition notes and return policy per item
Public data only. Failed requests are never billed
Frequently asked questions
No. Scrappa is an independent service and is not affiliated with or endorsed by The RealReal. The API returns structured JSON from public The RealReal pages.
A search costs 6 credits. An item lookup by product url costs 3 credits, and by SKU 6 credits. Every Scrappa account includes 500 free credits each month. Failed requests are not billed.
No. The site shows the first 2000 items of a listing in its own order. Narrow the search with filters to reach other items.
No. The RealReal does not show sold prices or sellers. Sold items show availability sold when they are still listed.