illy.com APIilly.com ↗
Access illy.com product data via 10 endpoints. Retrieve coffee listings, machine details, availability, customer reviews, Q&A, and current promotions.
curl -X GET 'https://api.parse.bot/scraper/814611c7-b1c4-492d-8901-27443f9b4f73/list_all_coffee_products?sz=4' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve all coffee products from illy.com with pagination support. Returns product listings including name, price, thumbnail, badge, and flavor intensity.
| Param | Type | Description |
|---|---|---|
| sz | integer | Number of products per page. |
| start | integer | Offset for pagination. |
{
"type": "object",
"fields": {
"sz": "integer page size used",
"start": "integer current pagination offset",
"products": "array of product objects with id, name, url, price, thumbnail, badge, flavor_intensity",
"total_count": "integer total number of products available"
},
"sample": {
"data": {
"sz": 4,
"start": 0,
"products": [
{
"id": "8841ST",
"url": "https://www.illy.com/en-us/coffee/whole-bean-coffee/whole-bean-classico-coffee-medium-roast/8841ST.html",
"name": "Whole Bean Coffee Classico - Medium Roast",
"badge": "BEST SELLER",
"price": "$17.29",
"thumbnail": "https://www.illy.com/dw/image/v2/BBDD_PRD/on/demandware.static/-/Sites-masterCatalog_illycaffe/default/dwdaf207d6/products/sfra/coffee/Medium2x/8841ST_Medium_2x_01.png?q=75",
"flavor_intensity": "5/9"
}
],
"total_count": 117
},
"status": "success"
}
}About the illy.com API
The illy.com API provides 10 endpoints covering the full illy product catalog — coffee, machines, gifts, and accessories. Use get_product_details to pull SKU, price, description, images, currency, and schema.org availability for any product, or get_product_reviews to retrieve PowerReviews rollup data including average rating and individual review text. Category filtering, keyword search, and pagination are supported across the core listing endpoints.
Product Listings and Search
list_all_coffee_products returns paginated coffee listings with fields including id, name, url, price, thumbnail, badge, and flavor_intensity. Use the sz and start parameters to page through results. list_coffee_by_category accepts a category slug — verified values include whole-bean-coffee and iperespresso-espresso-capsules — and returns the same product object shape. search_products accepts a query string and optional sz/start pagination params, returning matching products across all categories.
Product Detail and Availability
get_product_details takes a URL path beginning with /en-us/ and returns a detailed product record: sku, name, description, price, currency, availability (as a schema.org URL), images (array), and flavor_intensity expressed as a fraction like 5/9. check_product_availability hits the same URL parameter but returns a lightweight response with just sku, name, price, and status — either in_stock or out_of_stock — making it efficient for bulk availability checks without fetching the full detail payload.
Reviews, Q&A, and Promotions
get_product_reviews accepts a product_id (the id field from any listing endpoint, e.g. 8841ST) and returns a rollup object with average_rating, rating_count, and review_count, plus an array of individual reviews each containing ugc_id, headline, comment body, reviewer nickname, and numeric rating. get_product_qa returns structured Q&A entries for the same product IDs, with each result including question text, answerer nickname, and an answer_count. get_promotions needs no inputs and returns current offers from the illy offers page: title, description, link, link_text, and section_label.
Machines and Accessories
list_coffee_machines and list_gifts_and_accessories each support sz and start pagination and return product arrays with id, name, url, price, and thumbnail. Machine listings do not include flavor_intensity, which is only present on coffee product objects.
- Monitor illy coffee product prices and availability across SKUs for price-tracking dashboards.
- Aggregate customer review ratings from
get_product_reviewsto compare illy blends by average score. - Build a catalog browser filtering coffee by category slug using
list_coffee_by_category. - Check
check_product_availabilityfor a list of SKUs to alert when out-of-stock items return to inventory. - Pull current promotions via
get_promotionsto surface illy deals in a comparison or cashback app. - Retrieve product Q&A with
get_product_qato populate a pre-purchase FAQ widget for illy products. - Extract flavor intensity ratings from
list_all_coffee_productsto build a taste-profile recommendation tool.
| 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 illy have an official public developer API?+
What does `get_product_reviews` return beyond the star rating?+
get_product_reviews returns a rollup object with average_rating, rating_count, and review_count, plus a paging object. Individual reviews each include ugc_id, a details object with comments, headline, and nickname, and a metrics object containing the numeric rating. The answered_questions count is also included in the rollup.Which product categories are supported in `list_coffee_by_category`?+
whole-bean-coffee and iperespresso-espresso-capsules. Other slugs that exist on illy.com may work but are not formally validated by the endpoint spec. Machines and accessories have their own dedicated endpoints (list_coffee_machines and list_gifts_and_accessories) rather than using a category param.Does the API cover subscription or auto-ship options available on illy.com?+
Is product data limited to the US storefront?+
/en-us/ prefix and prices are returned in USD. Other regional storefronts (e.g. UK, DE, IT) are not covered by the current endpoints. You can fork this API on Parse and revise it to point at a different regional path if you need non-US catalog data.