caratlane.com APIcaratlane.com ↗
Access Caratlane jewelry data: search products, browse categories, get detailed specs, pricing in INR, gold purity, and customer reviews via 4 API endpoints.
curl -X GET 'https://api.parse.bot/scraper/4d96531c-c3a6-4177-bc3f-31c2fe9455d9/search_products?limit=2&query=earrings&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for jewellery products by keyword. Returns paginated results with product summaries including pricing, media, and material details.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return per page. |
| queryrequired | string | Search keyword (e.g. 'diamond ring', 'earrings', 'gold necklace'). |
| offset | integer | Results offset for pagination. |
{
"type": "object",
"fields": {
"count": "total number of matching products",
"products": "array of product summaries with sku, name, price, special_price, formatted_price, formatted_special_price, url, media, purity, metal, and material"
},
"sample": {
"data": {
"count": 3827,
"products": [
{
"sku": "UE08066-1Y00CY",
"url": "/jewellery/cubical-green-gemstone-drop-earrings-ue08066-1y00cy.html",
"name": "Cubical Green Gemstone Drop Earrings",
"media": [
{
"url": "https://cdn.caratlane.com/media/catalog/product/U/E/UE08066-1Y00CY_3_lar.jpg",
"type": ""
}
],
"metal": "14 KT Yellow",
"price": 35237,
"purity": "14 KT",
"material": [
"Gemstone"
],
"special_price": null,
"formatted_price": "₹35,237",
"formatted_special_price": null
}
]
},
"status": "success"
}
}About the caratlane.com API
The Caratlane API provides 4 endpoints covering product search, category listings, individual product details, and homepage featured collections from caratlane.com. The get_product_detail endpoint returns full product data including SKU, gold purity, material composition, INR pricing, a media gallery, and a customer review array — all from a single product URL slug passed as input.
Search and Category Browsing
The search_products endpoint accepts a query string (e.g. 'diamond ring', 'gold necklace') along with optional limit and offset integers for pagination. It returns a count of total matches plus a products array. Each product summary includes sku, name, price, special_price, formatted_price, formatted_special_price, url, media, purity, and met. The get_category_listings endpoint follows the same response shape but takes a category slug instead — valid values include 'rings', 'earrings', 'necklaces-pendants', and 'bangles-bracelets'.
Product Detail
Pass any relative product URL from search_products or get_category_listings results to get_product_detail via the product_url parameter. The response expands the summary into full product data: a media array with typed objects (image URLs and media type), a metal description, a material array listing stone and metal types (e.g. ['Diamond', 'Gold']), purity in KT format ('14 KT' or '18 KT'), a reviews array with per-review author, rating, body, and date fields, and a reviews_summary object with aggregate count and rating.
Homepage Featured Collections
The get_homepage_featured endpoint takes no inputs and returns an array of homepage section objects. Each section exposes an attributes object containing title, name, Section_Type, and s_4_banner_items — a nested structure with banner name, text, url, and desktop_image fields. This is useful for tracking which collections or promotions Caratlane is currently featuring.
- Build a jewelry price comparison tool using
priceandspecial_pricefields from search results - Monitor Caratlane's current homepage promotions and featured collections with
get_homepage_featured - Filter diamond jewelry by purity using the
purityfield returned in category and search results - Aggregate customer review ratings across multiple products using
reviews_summary.ratingandreviews_summary.count - Sync a jewelry catalog with product names, SKUs, media URLs, and material types for a retail or affiliate site
- Track price changes on specific products over time by polling
get_product_detailwith saved URL slugs
| 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 Caratlane offer an official public developer API?+
What pricing data does the API return, and does it include metal weight or making charges?+
search_products, get_category_listings, and get_product_detail endpoints all return price, special_price, formatted_price, and formatted_special_price fields in INR. Granular pricing breakdown — such as metal weight, stone weight, making charges, or GST components — is not currently exposed. The API covers summary and display pricing. You can fork it on Parse and revise to add a dedicated pricing-breakdown endpoint if that structure is available on specific product pages.How does pagination work across search and category endpoints?+
search_products and get_category_listings accept limit and offset integer parameters. The response includes a count field representing total matching products, which you can use to calculate how many pages exist for a given query or category slug.Does the API cover product availability or stock status?+
Can I retrieve products filtered by metal type or stone type directly?+
search_products endpoint accepts a free-text query (e.g. 'gold earrings', 'diamond pendant'), and get_category_listings accepts a category slug. Once results are returned, each product includes purity and material fields you can use to filter client-side. You can fork this API on Parse and revise it to expose dedicated filter parameters if the underlying category pages support faceted filtering.