desertcart.com APIdesertcart.com ↗
Access Desertcart product data via API: search results, pricing breakdowns, stock status, specs, images, and variants across 9 endpoints.
curl -X GET 'https://api.parse.bot/scraper/c6ebb67e-52dd-4b6e-8939-24708464b187/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional country filter. Returns paginated results with product summaries including pricing, ratings, and delivery estimates.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'headphones'). |
| country | string | Source country filter: us, uk, india, japan. |
{
"type": "object",
"fields": {
"meta": "object containing pagination metadata",
"products": "array of product summary objects with id, title, brand_name, price, rating, reviews_count, estimated_delivery_days, main_image_url, store_name, badges"
},
"sample": {
"data": {
"meta": {},
"products": [
{
"id": 809148579,
"price": {
"plain": 4999,
"value": 499900,
"formatted": "AED 4,999",
"currency_code": "AED",
"value_usd_cents": 136120
},
"title": "Apple 2026 MacBook Air 13-inch Laptop with M5 chip",
"badges": null,
"rating": 4.7,
"brand_name": "apple",
"store_name": null,
"reviews_count": null,
"main_image_url": "https://m.media-amazon.com/images/I/71pkfQGcMKL.jpg",
"estimated_delivery_days": 5
}
]
},
"status": "success"
}
}About the desertcart.com API
The Desertcart API covers 9 endpoints for retrieving product data from desertcart.com, including search, full product details, pricing breakdowns, stock availability, technical specifications, images, and variant configurations. The search_products endpoint returns paginated summaries with pricing, ratings, and estimated delivery days, while get_product_pricing exposes a granular price breakdown including duty charges, local shipping, and grand total.
Search and Product Lookup
The search_products endpoint accepts a required query string and an optional country parameter (values: us, uk, india, japan) to filter results by source store. Responses include paginated arrays of product summaries with fields for id, title, brand_name, price, rating, reviews_count, estimated_delivery_days, and main_image_url, plus a meta object for pagination state. Product IDs from search results feed directly into the detail endpoints.
Product Detail Endpoints
get_product_details returns the full product record for a given product_id, including description, features_list, tech_specs, and image_urls. get_product_specifications returns a dedicated array of key-value spec pairs — useful when you need structured technical data separately from the prose description. Note that not every product carries specifications; the endpoint returns an empty array when none are available. get_product_images returns both a main_image URL and an all_images array for gallery use.
Pricing and Availability
get_product_pricing goes beyond a single price field: it returns a price object (with currency_code, value in subunits, plain decimal, formatted display string, and value_usd_cents), a list_price for the original price, percent_saved, and a price_breakup object detailing duty_charges, local_shipping_changes, and grand_total. get_product_availability returns in_stock (boolean), availability string, store_country, delivery_ranges as an array of YYYY-MM-DD date strings, and an eligible_for_pro flag indicating Desertcart Pro shipping eligibility.
Categories and Variants
get_categories returns a static list of 15 top-level categories, each with a name and slug. get_subcategories accepts a category_slug but currently returns a guidance message rather than a nested category tree — subcategory browsing is handled through search_products with category-specific queries. get_product_variants returns variant data keyed by ASIN, including a variations map of attribute values (e.g., Color, Size), a thumbnails map, and a variation_attributes array; single-SKU products return an empty object.
- Monitor Desertcart prices and discount percentages for cross-border product comparison tools.
- Build a delivery estimate tracker using
estimated_delivery_daysanddelivery_rangesfrom availability responses. - Aggregate technical specifications via
get_product_specificationsto populate structured product databases. - Extract full image galleries using
get_product_imagesfor product catalog or merchandising feeds. - Filter product availability by source store country using the
countryparameter insearch_products. - Map variant options (Color, Size, Configuration) from
get_product_variantsto support faceted browsing UIs. - Track landed cost estimates by capturing
duty_chargesandgrand_totalfrom theprice_breakupobject.
| 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 Desertcart have an official public developer API?+
What does `get_product_pricing` return beyond the sale price?+
price object with the current price in multiple formats (value in subunits, plain decimal, formatted string, and value_usd_cents), a list_price representing the original price, a percent_saved figure, and a price_breakup object that itemizes duty_charges, local_shipping_changes, and grand_total. The currency field reflects the applicable currency code, or null if unavailable.Does the API return seller or merchant details for each product?+
Are subcategory listings available through the categories endpoints?+
get_categories returns 15 top-level categories with name and slug. get_subcategories currently returns a guidance message rather than a nested list — it directs you to use search_products with category-specific queries instead. You can fork the API on Parse and revise it to add a dedicated subcategory listing endpoint.Do all products return populated variant data from `get_product_variants`?+
variations, thumbnails, and variation_attributes fields. Single-SKU products return an empty object. Variant data is keyed by ASIN and maps attribute names like Color or Size to their values.