How to Search Hotels Using SteadyAPI
Learn how to find hotels by destination using SteadyAPI. Resolve a place name to coordinates, then pull property names, ratings, and prices with the Booking.com hotel search endpoints.
READ MORECapabilities
Products are identified by the AliExpress product id, the number in a URL such as aliexpress.com/item/3256807406540115.html. Detail and reviews take it as productId; the description call takes a token that detail returns.
Search by keyword and narrow the results by category, price range, ship-from country, free shipping, or 4 stars and up, sorted by best match, price, or most orders. Each result has the product id, title, prices, rating, units sold, images, and URL, and meta.has_more tells you whether another page exists. See examples
Collections return AliExpress's index of search terms for one channel (popular, wholesale, promotion, cheap, or reviews), grouped by category, with each term's AliExpress URL. A term from this list works as the keyword for product search. See examples
Detail returns the title, sale and original price, currency, stock, rating, review count, units sold, images, specifications, variants, shipping origin, fee, and delivery window, and the store. It also returns the description_token used by the next call. See examples
Pass the description_token from product detail to get the seller's full description as a list of content modules, each with a type, its content, and a display style. See examples
Reviews come back a page at a time with the product's rating summary. Each review has the buyer's name and country, a rating from 1 to 5, the text and date, the variant bought, photos, and vote counts, and you can limit a page to reviews that include photos. See examples
Shortened examples
Each sample shows a few fields from one response, without the meta block that a live call also returns. The review summary and the single review both come from the reviews call.
{
"product_id": "3256806867817717",
"title": "Garden Lights-New Upgraded Solar Powered Firefly Lights Outdoor Waterproof Vibran Garden Lights for Decorationi",
"rating": 4.7,
"sold": "10,000+ sold"
}
{
"totalReviews": 10814,
"evarageStar": 4.7,
"fiveStarNum": 9269,
"totalNum": 10847
}
{
"buyerName": "c***s",
"buyerCountry": "ES",
"buyerFeedback": "Left pod didn't work",
"evalDate": "17 Aug 2023",
"skuInfo": "Color:XT80 Black"
}
{
"product_id": "3256807406540115",
"title": "(1/2/3 Pack) 3-Head Solar Outdoor Light, Motion Sensor Security Light with Wireless Remote Control",
"price": "$5.45",
"original_price": "$64.37",
"currency": "USD",
"rating": "4.8",
"reviews_count": 7
}
{
"category": "Apparel Accessories",
"search_term": "0.5 reading glasses"
}
Search, or a term from collections, gives you product ids. Pass one to product detail, then send the description_token from that response to the description call. Reviews take the product id directly, so a product page can request them at the same time as detail.
The AliExpress docs cover the search filters and sort values, the collection channels, the locale codes for detail and reviews, and how the description token passes from detail to description, with a sample response for each of the five endpoints.
Every endpoint in the documentation includes a sample request in Shell, JavaScript, PHP, and Python.
Why SteadyAPI
Search fills a grid, and the heavier reads run only for the product a user opens.
Pricing
Your plan's monthly requests work on this API and every other SteadyAPI API. Plan details, overage rates, and the Free plan's daily cap are on the pricing page. Need more volume than the largest plan? Email [email protected].
Free $0.00 per month | Starter $14.99 per month | Developer $39.99 per month | Business Popular $89.99 per month | Enterprise $299.99 per month | |
|---|---|---|---|---|---|
| Subscribe | Subscribe | Subscribe | Subscribe | Subscribe | |
| Requests per month | 500 | 10,000 | 50,000 | 250,000 | 2,500,000 |
| Stock Market API | |||||
| Options Data API | |||||
| Crypto Data API | |||||
| AliExpress API | |||||
| Reddit API | |||||
| Booking.com API | |||||
| Real Estate API | |||||
| Baseball (MLB) API | |||||
| Hockey API | |||||
| Football API | |||||
| Amazon API | |||||
| eBay API | |||||
| Walmart API | |||||
| Instagram API | |||||
| Twitter / X API | |||||
| TikTok API | |||||
| YouTube API | |||||
| AutoHub API | |||||
| ScrapeFlow | |||||
| Commercial Use | |||||
| Optional overage rate* | $1.50 per 1,000 requests | $1.05 per 1,000 requests | $0.50 per 1,000 requests | $0.09 per 1,000 requests | |
| Overage cap | up to 50,000 extra | up to 250,000 extra | up to 1,250,000 extra | up to 12,500,000 extra |
Free $0.00 per year | Starter $11.96 per month$143.52 billed yearly | Developer $32.50 per month$389.99 billed yearly | Business Popular $72.50 per month$869.99 billed yearly | Enterprise $320.83 per month$3,849.99 billed yearly | |
|---|---|---|---|---|---|
| Subscribe | Subscribe | Subscribe | Subscribe | Subscribe | |
| Requests per month | 500 | 10,000 | 50,000 | 250,000 | 2,500,000 |
| Stock Market API | |||||
| Options Data API | |||||
| Crypto Data API | |||||
| AliExpress API | |||||
| Reddit API | |||||
| Booking.com API | |||||
| Real Estate API | |||||
| Baseball (MLB) API | |||||
| Hockey API | |||||
| Football API | |||||
| Amazon API | |||||
| eBay API | |||||
| Walmart API | |||||
| Instagram API | |||||
| Twitter / X API | |||||
| TikTok API | |||||
| YouTube API | |||||
| AutoHub API | |||||
| ScrapeFlow | |||||
| Commercial Use | |||||
| Optional overage rate* | $1.50 per 1,000 requests | $1.05 per 1,000 requests | $0.50 per 1,000 requests | $0.09 per 1,000 requests | |
| Overage cap | up to 50,000 extra | up to 250,000 extra | up to 1,250,000 extra | up to 12,500,000 extra |
* Overage is optional and stays off until you turn it on in Billing. It is available on paid plans billed by card through Stripe, and not during a trial. Usage is counted in monthly periods that start on your billing day, yearly plans included. Requests past the included limit are charged at the plan's rate for each started block of 1,000, up to the overage cap, on one invoice after the period ends. Amounts under $0.50 carry over to the next invoice. If you change plans during a period, the limit and overage rate of the plan you are on when the period ends apply to the whole period.
The Free plan is also capped at 20 requests per day (New York time). Requests count by endpoint weight, and only responses with HTTP status 200 count.
Commercial use is included only on the plans that list it. If you are not sure whether your project counts as commercial use, email [email protected] before you launch.