Endpoint Playground

Try the Shopify Product Recommendations API

Returns recommended products from Shopify's product recommendations.

What a live request returned

14 Oct 2026: 10 products; 14 fields had a value in every checked item and 2 varied between items.

Observed request: GET /shopify/products/mens-tree-runner-nz-natural-white/recommendations?url=https%3A%2F%2Fwww.allbirds.com&limit=10
Fields with a value in every checked item: id, handle, title, url, vendor, product_type, published_at, created_at

Sample value profiles: published_at: 2026-06-11 to 2026-09-25; vendor: Allbirds (9), re:do (1); price: 14 to 100, median 100.

Request: GET /shopify/products/{handle}/recommendations
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 2.51 s
Monitored request: GET /shopify/products/mens-tree-runner-nz-natural-white/recommendations?limit=2&url=https%3A%2F%2Fwww.allbirds.com

Shopify Product Recommendations API documentation Shopify platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shopify/products/mens-wool-runners/recommendations?url=https%3A%2F%2Fwww.allbirds.com&intent=related' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
handle (path)	string	Yes	mens-wool-runners	Product handle
url	string	Yes	https://www.allbirds.com	Shopify storefront URL
limit	integer	No		Maximum products, defaults to 10 and supports up to 20
intent	string	No	related	Recommendation intent. Allowed values: related, complementary

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_url": "https://www.allbirds.com",
    "source_url": "https://www.allbirds.com",
    "handle": "mens-wool-runners",
    "product_id": "6616124981328",
    "intent": "related",
    "limit": 10,
    "products": [
      {
        "handle": "mens-tree-runners",
        "title": "Men's Tree Runners"
      }
    ]
  }
}

More Shopify endpoints

List Shopify collections List Shopify collection products List Shopify pages Get Shopify page List Shopify products Get Shopify product Get Shopify search suggestions List Shopify sitemap URLs List Shopify sitemaps Get Shopify store metadata

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestshopify.productRecommendationsResponseDocShopify

GET /shopify/products/{handle}/recommendations

List Shopify product recommendations

Returns recommended products from Shopify's product recommendations.

Response behavior

- Missing product handles return `404` when Shopify returns not found while resolving the seed product. - Valid empty recommendation arrays return `200` with an empty `products` array. - Blocked pages, malformed JSON, and missing Shopify roots return upstream errors. - For some storefronts, the response includes `transport_mode: "ssr_embedded"`, and each product may include the same additive fields documented for `/shopify/products`: `colour`, `canonical_colour`, `discount_percentage`, `rating`, `rating_count`, `collection_tags`, `labels`, and per-variant `inventory_quantity`. `transport_mode` is omitted entirely for other stores. `transport_mode` allowed values: `ssr_embedded` (only ever present, never any other value; omitted for the classic transport).

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

handle

requiredstring

Product handle

Required query parameters

url

requiredstring

Shopify storefront URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_url": "https://www.allbirds.com",
    "source_url": "https://www.allbirds.com",
    "handle": "mens-wool-runners",
    "product_id": "6616124981328",
    "intent": "related",
    "limit": 10,
    "products": [
      {
        "handle": "mens-tree-runners",
        "title": "Men's Tree Runners"
      }
    ]
  }
}

Endpoint Playground

Try the Shopify Product Recommendations API

Returns recommended products from Shopify's product recommendations.

What a live request returned

14 Oct 2026: 10 products; 14 fields had a value in every checked item and 2 varied between items.

Observed request: GET /shopify/products/mens-tree-runner-nz-natural-white/recommendations?url=https%3A%2F%2Fwww.allbirds.com&limit=10
Fields with a value in every checked item: id, handle, title, url, vendor, product_type, published_at, created_at

Sample value profiles: published_at: 2026-06-11 to 2026-09-25; vendor: Allbirds (9), re:do (1); price: 14 to 100, median 100.

Request: GET /shopify/products/{handle}/recommendations
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 2.51 s
Monitored request: GET /shopify/products/mens-tree-runner-nz-natural-white/recommendations?limit=2&url=https%3A%2F%2Fwww.allbirds.com

Shopify Product Recommendations API documentation Shopify platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shopify/products/mens-wool-runners/recommendations?url=https%3A%2F%2Fwww.allbirds.com&intent=related' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
handle (path)	string	Yes	mens-wool-runners	Product handle
url	string	Yes	https://www.allbirds.com	Shopify storefront URL
limit	integer	No		Maximum products, defaults to 10 and supports up to 20
intent	string	No	related	Recommendation intent. Allowed values: related, complementary

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_url": "https://www.allbirds.com",
    "source_url": "https://www.allbirds.com",
    "handle": "mens-wool-runners",
    "product_id": "6616124981328",
    "intent": "related",
    "limit": 10,
    "products": [
      {
        "handle": "mens-tree-runners",
        "title": "Men's Tree Runners"
      }
    ]
  }
}

More Shopify endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestshopify.productRecommendationsResponseDocShopify

GET /shopify/products/{handle}/recommendations

List Shopify product recommendations

Returns recommended products from Shopify's product recommendations.

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

handle

requiredstring

Product handle

Required query parameters

url

requiredstring

Shopify storefront URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "store_url": "https://www.allbirds.com",
    "source_url": "https://www.allbirds.com",
    "handle": "mens-wool-runners",
    "product_id": "6616124981328",
    "intent": "related",
    "limit": 10,
    "products": [
      {
        "handle": "mens-tree-runners",
        "title": "Men's Tree Runners"
      }
    ]
  }
}