Adidas API endpoint
Returns the top matching products for a partial query, the same search-as-you-type preview Adidas's own search box shows. Adidas has no separate term-autocomplete index, so each suggestion is a matching product (id, title, url, image, price) rather than a completed search phrase. Best-effort relevance: an obscure query returns whatever Adidas's own search surfaces.
/adidas/suggestquery is required, 1 to 200 characters.
Notable response behavior:
suggestions[] entry is a matching product (id, title, url, image_url, price) rather than a completed search phrase.query returns whatever Adidas's own search surfaces, not a guaranteed prefix match.id is the SKU to pass as product_id to adidas-product for full detail.| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| id | 10 | |
| title | 10 | SAMBA OG SHOES (4), Samba OG Shoes (3), SAMBA JANE SHOES (2) and 1 more |
| url | 10 | adidas.com |
| image_url | 10 | assets.adidas.com |
| price | 10 | 55 to 130, median 100 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Partial search query | samba | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/adidas/suggest?query=samba" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "samba",
"count": 10,
"suggestions": [
{
"id": "KJ7435",
"title": "SAMBA OG SHOES",
"url": "https://www.adidas.com/samba-og-shoes/KJ7435.html",
"image_url": "https://assets.adidas.com/images/w_280,h_280,f_auto,q_auto:sensitive/f88fdc6701a845be8fa1b2d0656b4ab0_9366/samba-og-shoes.jpg",
"price": 120
}
]
}
}Request schema
No body schema
Response schema
#/definitions/adidas.suggestResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | adidas.SuggestResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.query | string | No | ||||
| data.source_url | string | No | ||||
| data.suggestions | array | No | ||||
| data.suggestions[].id | string | No | ||||
| data.suggestions[].image_url | string | No | ||||
| data.suggestions[].price | number | No | ||||
| data.suggestions[].title | string | No | ||||
| data.suggestions[].url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/adidas/suggest?query=samba" \
-H "x-api-key: $CRAWLORA_API_KEY"