LightInTheBox APIlightinthebox.com ↗
Search products, fetch details, retrieve reviews, browse categories, and get flash sale data from LightInTheBox via a structured JSON API.
What is the LightInTheBox 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.
curl -X GET 'https://api.parse.bot/scraper/e5754f89-86a1-4b6e-906a-52404c2e1860/search_products?query=dress' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lightinthebox-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: LightInTheBox SDK — search products, fetch details, read reviews."""
from parse_apis.lightinthebox_api import LightInTheBox, ProductNotFound
client = LightInTheBox()
# Search for products by keyword — limit caps total items fetched.
for product in client.products.search(query="shoes", limit=3):
print(product.name, product.brand, product.url)
# Get detailed product info by ID, inspect pricing and attributes.
try:
detail = client.productdetails.get(product_id="18669138")
print(detail.name, detail.sale_price, detail.original_price, detail.is_onsale)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
# Browse reviews for a product — paginator auto-advances pages.
if detail:
for review in detail.reviews(limit=3):
print(review.reviewer, review.rating, review.date)
# List current flash sale items.
for item in client.flashsaleproducts.list(limit=5):
print(item.product_name, item.sale_price, item.discount, item.is_sold_out)
# Browse site categories.
for cat in client.categories.list(limit=5):
print(cat.name, cat.url)
print("exercised: products.search / productdetails.get / detail.reviews / flashsaleproducts.list / categories.list")
Full-text search over the LightInTheBox product catalog by keyword. Returns structured product data extracted from schema.org markup including name, brand, URL, image, pricing offers, and aggregate ratings. Results are a single page of up to ~20 items; no server-side pagination parameter is exposed.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'dress', 'shoes', 'phone case') |
{
"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_p18669138.html",
"name": "Women's Midi Dress",
"@type": "Product",
"brand": "LightInTheBox",
"image": "https://litb-cgis.rightinthebox.com/images/384x500/202604/bps/product/inc/fshjch1775014151463.jpg",
"offers": {
"@type": "Offer",
"price": null,
"priceCurrency": "USD"
},
"@context": "https://schema.org",
"position": 1,
"description": "$25.99 - Women's Midi Dress",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "17"
}
}
]
},
"status": "success"
}
}About the LightInTheBox API
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.
The LightInTheBox API is a managed, monitored endpoint for lightinthebox.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lightinthebox.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lightinthebox.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.