Kylie Cosmetics API endpoint
Returns recommended products for one Kylie Cosmetics (https://www.kyliecosmetics.com) product handle. The storefront URL is fixed server-side.
/kyliecosmetics/products/{handle}/recommendationsReturns recommended products from Kylie Cosmetics.
This is a brand-pinned endpoint: the storefront URL (https://www.kyliecosmetics.com) is fixed server-side, so unlike the generic /shopify/* family this wraps, there is no url request parameter. The same storefront is reachable through the generic family by passing url=https://www.kyliecosmetics.com directly.
Path parameters:
handle: required. Product handle, such as example-product-handle.Query parameters:
limit: optional. Defaults to 10, maximum 20.intent: optional. Allowed values: related, complementary. Defaults to related.Notable response behavior:
404 when Shopify returns not found while resolving the seed product.200 with an empty products array.transport_mode: "ssr_embedded", with the same additive product fields documented for the products endpoint.transport_mode allowed values: ssr_embedded (only ever present, never any other value; omitted for the classic transport).
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| handle | 10 | |
| title | 10 | “Plumping Matte Lip Kit” and 9 other values |
| url | 10 | kyliecosmetics.com |
| vendor | 10 | kylie-cosmetics in all 10 |
| product_type | 10 | Lip Kit (6), Lip Gloss (1), Accessory (1) and 2 more |
| published_at | 10 | 2022-12-07 to 2026-07-27 |
| created_at | 10 | 2022-12-07 to 2026-05-29 |
| price | 10 | 19 to 600, median 35 |
| available | 10 | true in 10 of 10 |
| options | 10 | median 1 entry |
| variants | 10 | median 4 entries |
| images | 10 | median 18 entries |
| featured_image | 10 | cdn.shopify.com |
| description | 6 | median 198 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| handle (path) | string | Yes | Product handle | product-handle | |
| limit | integer | No | 10 and supports up to 20 | Maximum products, defaults to 10 and supports up to 20 | 10 |
| intent | string | No | Recommendation intent. Allowed values: related, complementary Allowed values: related, complementary. | related | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/kyliecosmetics/products/product-handle/recommendations?limit=10&intent=related" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"store_url": "https://www.kyliecosmetics.com",
"source_url": "https://www.kyliecosmetics.com",
"handle": "example-product-handle",
"product_id": "6616124981328",
"intent": "related",
"limit": 10,
"products": [
{
"handle": "example-related-product",
"title": "Example Related Product"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/shopifybrands.productRecommendationsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | shopify.ProductRecommendationsResponse | No | ||||
| data.handle | string | No | mens-wool-runners | Handle of the product the recommendations are based on. | ||
| data.intent | string | No | related | Recommendation type returned: `related` or `complementary`. | ||
| data.limit | integer | No | 10 | Maximum number of recommended products returned. | ||
| data.product_id | string | No | 6616124981328 | Shopify id of the product the recommendations are based on. | ||
| data.products | array | No | Recommended products, one item per product. ProductItem record, 57 fields: available, canonical_colour, collection_tags, colour, compare_at_price, condition, created_at, description, discount_percentage, featured_image, handle, id and 14 more. Described under Kylie Cosmetics Products API. | |||
| data.source_url | string | No | https://www.allbirds.com | URL the data was read from. | ||
| data.store_url | string | No | https://www.allbirds.com | Base URL of the Shopify storefront that was queried. | ||
| data.transport_mode | string | No | ssr_embedded | ssr_embedded | Set only for headless storefronts that do not expose Shopify's standard catalogue; the value is `ssr_embedded`. Omitted otherwise. | |
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/kyliecosmetics/products/product-handle/recommendations?limit=10&intent=related" \
-H "x-api-key: $CRAWLORA_API_KEY"