Endpoint Playground
Returns search suggestions inside one Shop.app shop, for the shop `handle` and required `query`. `limit` defaults to 20, which is also the maximum. Suggestions are `type` term, product or collection, with text, position and a product or collection object where relevant. Unknown shops return not found.
14 Oct 2026: 13 suggestions; 4 fields had a value in every checked item and 2 varied between items.
Sample value profiles: type: term (10), product (3); position: 1 to 13, median 7; text: “loafer” and 12 other values.
curl 'https://api.crawlora.net/api/v1/shop-app/shops/marcnolan/typeahead?query=loafer' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| handle (path) | string | Yes | marcnolan | Shop handle |
| query | string | Yes | loafer | Typeahead query |
| limit | integer | No | Maximum suggestions, defaults to 20 and supports up to 20 |
{
"code": 200,
"msg": "OK",
"data": {
"shop_handle": "marcnolan",
"query": "loafer",
"suggestions": [
{
"type": "term",
"text": "loafer",
"position": 1
},
{
"type": "product",
"text": "Odell White Leather Belgian Loafer Sneakers",
"id": "7438827651151",
"position": 2
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.