ASOS: Search
Search from ASOS as JSON. 1 credit per successful call.
GET /v1/asos/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
query | string | Optional | Up to 100 characters |
category_id | integer | Optional | Any |
page | integer | Optional | Any |
sort | string | Optional | relevance, price_asc, price_desc, newest |
brand | string | Optional | Any |
colour | string | Optional | Any |
size | string | Optional | Any |
min_price | number | Optional | Any |
max_price | number | Optional | Any |
sale_only | boolean | Optional | Any |
store | string | Optional | COM, US, DE, FR, AU |
Example request
ASOS
GET/v1/asos/search?query=dress&sort=price_asc&sale_only=true
{
"success": true,
"data": {
"query": "dress",
"store": "COM",
"total_results": 11994,
"pagination": {
"page": 1,
"per_page": 72,
"total_pages": 167,
"returned": 72
},
"items": [
{
"id": 208461145,
"name": "COLLUSION 90s mini long sleeve dress in black",
"brand": "Collusion",
"colour": "BLACK",
"product_code": "145573369",
"product_type": "Product",
"price": {
"current": 3.99,
"previous": 15.99,
"currency": "GBP",
"is_on_sale": true,
"discount_percent": 75,
"lowest_price_30d": 3.99
},
"url": "https://www.asos.com/collusion/collusion-90s-mini-long-sleeve-dress-in-black/prd/208461145",
"images": [
"https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-1-black",
"https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-2",
"https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-3"
],
"video_url": "https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/208461145-catwalk",
"is_selling_fast": false,
"is_restocking_soon": false,
"is_new": false,
"is_sponsored": false,
"has_variant_colours": false,
"has_multiple_prices": false
},
{
"id": 200450391,
"name": "Brave Soul Plus stories button thru knitted dress",
"brand": "Brave Soul Plus",
"colour": "BLACK",
"product_code": "104064721",
"product_type": "Product",
"price": {
"current": 4,
"previous": 20,
"rrp": 42,
"currency": "GBP",
"is_on_sale": true,
"discount_percent": 80,
"lowest_price_30d": 4
},
"url": "https://www.asos.com/brave-soul-plus/brave-soul-plus-stories-button-thru-knitted-dress/prd/200450391",
"images": [
"https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-1-black",
"https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-2",
"https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-3"
],
"is_selling_fast": false,
"is_restocking_soon": false,
"is_new": false,
"is_sponsored": false,
"has_variant_colours": false,
"has_multiple_prices": false
},
{
"id": 205855017,
"name": "ASOS DESIGN one shoulder ruched side mini dress in black",
"brand": "ASOS DESIGN",
"colour": "BLACK",
"product_code": "133832701",
"product_type": "Product",
"price": {
"current": 4,
"previous": 18,
"currency": "GBP",
"is_on_sale": true,
"discount_percent": 78,
"lowest_price_30d": 4
},
"url": "https://www.asos.com/asos-design/asos-design-one-shoulder-ruched-side-mini-dress-in-black/prd/205855017",
"images": [
"https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-1-black",
"https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-2",
"https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-3"
],
"video_url": "https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/205855017-catwalk",
"is_selling_fast": false,
"is_restocking_soon": false,
"is_new": false,
"is_sponsored": false,
"has_variant_colours": false,
"has_multiple_prices": false
}
],
"facets": [
{
"id": "range",
"name": "Sale/New Season",
"values": [
{
"id": "new_season",
"name": "New Season",
"count": 8484,
"selected": false
},
{
"id": "sale",
"name": "Sale",
"count": 11994,
"selected": true
}
]
},
{
"id": "freshness_band",
"name": "New in date",
"values": [
{
"id": "3",
"name": "Last 7 Days",
"count": 4,
"selected": false
},
{
"id": "4",
"name": "Last 14 Days",
"count": 10,
"selected": false
},
{
"id": "5",
"name": "Last 28 Days",
"count": 33,
"selected": false
}
]
},
{
"id": "floor",
"name": "Gender",
"values": [
{
"id": "1001",
"name": "Men",
"count": 6,
"selected": false
},
{
"id": "1000",
"name": "Women",
"count": 11990,
"selected": false
},
{
"id": "2001",
"name": "Unisex",
"count": 2,
"selected": false
}
]
}
]
},
"meta": {
"endpoint_family": "search",
"request_id": "req_d2396bf39f4143d69837b5d3d44ef8e8",
"credits_charged": 1,
"credits_remaining": 1987
}
}200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.