rolex.com APIrolex.com ↗
Access Rolex watch models, editions, full specs, pricing, user guides, brochures, and authorized retailer locations via 8 structured API endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/34641cc6-f137-4ec1-96bc-b63affbf9cbb/get_all_watch_models' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all Rolex watch model families with their names, slugs, taglines, categories, and image URLs. Returns classic, professional, and 'find your Rolex' category models.
No input parameters required.
{
"type": "object",
"fields": {
"models": "array of model objects each containing name, tagline, slug, categories, and image_url"
},
"sample": {
"data": {
"models": [
{
"name": "Submariner",
"slug": "submariner",
"tagline": "The supreme diver’s watch",
"image_url": "https://media.rolex.com/image/upload/v1775074870/rolexcom/094398bf1f99/collection/hub/watches-2026-submariner-hub-portrait.jpg",
"categories": [
"pro"
]
}
]
},
"status": "success"
}
}About the rolex.com API
The Rolex.com API exposes 8 endpoints covering the complete Rolex catalog — from model families and individual references to specifications, pricing, and authorized retailer locations. Use get_watch_edition_detail to retrieve case, dial, bracelet, and movement specs alongside US pricing for any specific reference number, or use find_store_locator to pull geocoded retailer and service center data filtered by country.
Catalog and Model Data
The get_all_watch_models endpoint returns the full list of Rolex model families, including fields like name, tagline, slug, categories, and image_url. Models are grouped into classic, professional, and 'find your Rolex' categories. From there, get_watch_model_detail accepts a model_slug (e.g. submariner, datejust, cosmograph-daytona) and returns the full CMS page structure: breadcrumb navigation, cover media, and editorial content components.
Editions and Specifications
get_watch_editions_by_model takes a family_code and returns individual watch references with fields including reference_number, case, image_url, url, and description, plus a total count. To go deeper, pass any reference (e.g. m124060-0001) to get_watch_edition_detail, which returns a price object with formattedPrice, currency, and numeric price, plus a specs object covering case dimensions, dial color, bracelet material, and movement details.
Search and Document Access
search_watches accepts a free-text query and returns matching watches, articles, and retailer listings with title, uri, and raw metadata fields, along with a totalCount. get_user_guides_list and get_brochures_list return structured metadata for downloadable PDFs — including titles, family codes, reference numbers, and file paths — useful for building documentation or support tooling around specific references.
Store Locator
find_store_locator accepts an optional ISO 2-letter country_code and returns authorized retailers and service centers with nameTranslated, address, lat, lng, type, and hoursTranslated. This makes it straightforward to build map-based retailer finders or proximity searches for any supported country.
- Build a watch comparison tool using specs and pricing from get_watch_edition_detail across multiple reference numbers.
- Populate a retailer map with geocoded Rolex authorized dealers filtered by country via find_store_locator.
- Index the full Rolex catalog for a luxury goods search engine using get_all_watch_models and get_watch_editions_by_model.
- Generate a reference-to-spec lookup table using the case, dial, bracelet, and movement fields from get_watch_edition_detail.
- Automate download links for user guides and brochures by family code using get_user_guides_list and get_brochures_list.
- Keyword-search the catalog for specific materials or complications (e.g. 'gold bezel', 'perpetual') using search_watches.
- Track US list prices across model families by periodically calling get_watch_edition_detail for key reference numbers.
| 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 Rolex offer an official public developer API?+
What pricing data does get_watch_edition_detail return, and which market does it cover?+
price object containing formattedPrice (e.g. '$10,100'), currency ('USD'), and a numeric price value. Pricing for other markets is not currently returned. The API covers US list prices and full technical specs. You can fork it on Parse and revise to add endpoints targeting other regional pricing pages.Does the API return secondary market or pre-owned watch data?+
How does find_store_locator filter results, and what location fields are returned?+
country_code (e.g. 'US', 'JP', 'DE') to filter results. Each establishment in the establishments array includes nameTranslated, address, lat, lng, type (retailer or service center), and hoursTranslated. The country_code parameter is optional — omitting it returns all available establishments.