lightinthebox.com APIlightinthebox.com ↗
Search products, fetch details, retrieve reviews, browse categories, and get flash sale data from LightInTheBox via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/e5754f89-86a1-4b6e-906a-52404c2e1860/search_products?query=dress' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword. Returns product listings with titles, prices, ratings, and image URLs from structured data embedded in search results.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'dress', 'shoes') |
{
"type": "object",
"fields": {
"query": "string, the original search query",
"total": "integer, number of products returned",
"products": "array of product objects with name, url, image, brand, description, offers, and aggregateRating"
},
"sample": {
"data": {
"query": "dress",
"total": 20,
"products": [
{
"url": "https://www.lightinthebox.com/en/p/women-s-midi-dress-shift-dress_p11519348.html",
"name": "Women's Midi Dress Shift Dress",
"@type": "Product",
"brand": "LightInTheBox",
"image": "https://litb-cgis.rightinthebox.com/images/384x500/202603/bps/product/inc/xtcwdp1774599158164.jpg",
"offers": {
"@type": "Offer",
"price": null,
"availability": "https://schema.org/InStock",
"priceCurrency": "USD"
},
"@context": "https://schema.org",
"position": 1,
"description": "$26.99 - Women's Midi Dress",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.9",
"reviewCount": "17"
}
}
]
},
"status": "success"
}
}About the lightinthebox.com API
The LightInTheBox API covers 5 endpoints that return product listings, pricing, variants, customer reviews, flash sale items, and site categories. The search_products endpoint accepts a keyword and returns an array of product objects with name, URL, image, brand, offers, and aggregate ratings. Whether you need to compare prices, monitor discounts, or pull structured review data, the API exposes the core catalog data available on LightInTheBox.
Product Search and Details
The search_products endpoint takes a required query string (e.g. 'dress' or 'shoes') and returns a products array where each item includes name, url, image, brand, description, offers, and aggregateRating. The total field tells you how many products were returned for the query.
For deeper product data, get_product_details accepts a numeric product_id and returns an info object keyed by that ID, containing name, prices, attributes, variants, and availability. A separate shipping object within the response exposes shipping_time, processing_time, and warehouse fulfillment details — useful for logistics comparisons or delivery estimation.
Reviews and Flash Sales
get_product_reviews accepts a product_id and an optional page parameter for pagination. Each review object includes reviewer, rating, text, date, is_verified, and product_id. The total field reflects the count of reviews on the current page, not the overall review count for the product.
get_flash_sale_products requires no inputs and returns an array of currently discounted items. Each object includes product_id, product_name, product_image, sale_price, original_price, discount, and is_sol (indicating sold-out status). This makes it straightforward to monitor live discount depth across the flash sale catalog.
Categories
get_categories takes no inputs and returns the top-level site navigation as an array of objects with name and url. This is useful for mapping the category hierarchy or seeding subsequent product searches by department.
- Track flash sale discount percentages across LightInTheBox using
sale_price,original_price, anddiscountfields. - Build a price comparison tool by querying
search_productsand extractingoffersdata for matched items. - Aggregate verified customer sentiment by pulling
rating,text, andis_verifiedfields fromget_product_reviews. - Enumerate available product variants and attributes using
get_product_detailsto support catalog ingestion pipelines. - Monitor estimated delivery windows by reading
shipping_timeandprocessing_timefrom the shipping object. - Populate a category navigation index by iterating the
nameandurlfields returned byget_categories. - Detect sold-out flash sale items in real time using the
is_solflag fromget_flash_sale_products.
| 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 LightInTheBox have an official developer API?+
What does `get_product_reviews` return, and how does pagination work?+
reviews array where each object includes reviewer, rating, text, date, is_verified, and product_id. The optional page parameter controls which page of results is returned. The total field reflects the number of reviews on the current page, not the cumulative review count for the product across all pages.Does the API expose seller information or individual seller ratings?+
Are product images returned for all endpoints, or only search results?+
search_products returns an image field per product, and get_flash_sale_products returns a product_image field. get_product_details does not currently include a dedicated image array in its response fields. You can fork the API on Parse and revise the details endpoint to include image data if needed.Does the API support filtering search results by price range or category?+
search_products endpoint currently accepts only a query string. It does not expose price range, category, or sort-order filters. You can fork the API on Parse and revise it to add filter parameters to the search endpoint.