---
title: "adidas API: Search | Perceptlayer"
description: "Search from adidas as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/adidas/search
---

[APIs](https://perceptlayer.com/apis) / [adidas](https://perceptlayer.com/apis/adidas) / Search

# adidas: Search

Search from adidas as JSON. 1 credit per successful call.

GET `/v1/adidas/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | Optional | Up to 100 characters |
| `category` | string | Optional | Up to 100 characters |
| `gender` | string | Optional | men, women, kids, unisex |
| `size` | string | Optional | Any |
| `color` | string | Optional | white, black, blue, brown, green, beige, pink, purple, silver, grey, multi, burgundy, red, yellow, gold, orange |
| `price_min` | number | Optional | Any |
| `price_max` | number | Optional | Any |
| `sale_only` | boolean | Optional | Any |
| `sort` | string | Optional | relevance, newest, price\_asc, price\_desc, top\_sellers |
| `page` | integer | Optional | Any |
| `country` | string | Optional | us |

## Example request

adidas

GET /v1/adidas/search?query=samba&gender=men&sort=price\_asc 

```
{
  "success": true,
  "data": {
    "query": "samba",
    "country": "us",
    "currency": "USD",
    "page": 1,
    "page_size": 48,
    "sort": "price_asc",
    "total": 52,
    "total_pages": 2,
    "removed_by_filter": 0,
    "items": [
      {
        "product_code": "IH6829",
        "model_code": "SAMBAU2312",
        "name": "Samba OG Shoes",
        "subtitle": "Originals",
        "division": "Originals",
        "category": "shoes",
        "sport": "Soccer",
        "unisex": true,
        "price": {
          "currency": "USD",
          "amount": 55,
          "original_amount": 110,
          "sale_amount": 55,
          "discounted": true,
          "discount_percent": 50
        },
        "rating": {
          "average": 4.82,
          "count": 3967
        },
        "sizes": [
          "M 4.5 / W 5.5",
          "M 4 / W 5"
        ],
        "color_variations": [
          "IH6816",
          "KK2280",
          "KK2278"
        ],
        "badge": "Best Seller",
        "orderable": true,
        "online_from": "2025-11-05T23:59:00.000Z",
        "url": "https://www.adidas.com/us/samba-og-shoes/IH6829.html",
        "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0337473ad2544a53b4def3374906d5b2_9366/samba-og-shoes.jpg",
        "images": [
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0337473ad2544a53b4def3374906d5b2_9366/samba-og-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/c4c7e4f172af48e4b49153519f7bca7f_9366/samba-og-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/8d647bfd45a84790a82128e09093f385_9366/samba-og-shoes.jpg"
        ]
      },
      {
        "product_code": "HQ9248",
        "model_code": "OOZ21",
        "name": "SAMBA LT SHOES",
        "subtitle": "Originals",
        "division": "Originals",
        "category": "shoes",
        "sport": "Lifestyle",
        "unisex": true,
        "price": {
          "currency": "USD",
          "amount": 65,
          "original_amount": 130,
          "sale_amount": 65,
          "discounted": true,
          "discount_percent": 50
        },
        "rating": {
          "average": 4.7,
          "count": 82
        },
        "sizes": [
          "M 6 / W 7",
          "M 5 / W 6",
          "M 4.5 / W 5.5"
        ],
        "orderable": true,
        "online_from": "2026-02-03T00:00:00.000Z",
        "url": "https://www.adidas.com/us/samba-lt-shoes/HQ9248.html",
        "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0e802cba4ae24147b6e0743ea3165740_9366/samba-lt-shoes.jpg",
        "images": [
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/0e802cba4ae24147b6e0743ea3165740_9366/samba-lt-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/4f2bf1d4cfef4ddba2c5680b2d71fba9_9366/samba-lt-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/4b2f8abe0d71436cab5010c09caeed5a_9366/samba-lt-shoes.jpg"
        ]
      },
      {
        "product_code": "KH6893",
        "model_code": "OQZ80",
        "name": "ADIDAS X COCA-COLA SAMBA OG SHOES",
        "subtitle": "Originals",
        "division": "Originals",
        "category": "shoes",
        "sport": "Lifestyle",
        "unisex": true,
        "price": {
          "currency": "USD",
          "amount": 65,
          "original_amount": 130,
          "sale_amount": 65,
          "discounted": true,
          "discount_percent": 50
        },
        "rating": {
          "average": 4.89,
          "count": 410
        },
        "sizes": [
          "M 14 / W 15",
          "M 10.5 / W 11.5",
          "M 13 / W 14"
        ],
        "orderable": true,
        "online_from": "2026-05-28T01:00:00.000Z",
        "url": "https://www.adidas.com/us/adidas-x-coca-cola-samba-og-shoes/KH6893.html",
        "image_url": "https://assets.adidas.com/images/w_2000,f_auto,q_auto/222561f2400b4c0c8ed43c1ca37de763_9366/adidas-x-coca-cola-samba-og-shoes.jpg",
        "images": [
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/222561f2400b4c0c8ed43c1ca37de763_9366/adidas-x-coca-cola-samba-og-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/b078448314034059a4d609f559c94060_9366/adidas-x-coca-cola-samba-og-shoes.jpg",
          "https://assets.adidas.com/images/w_2000,f_auto,q_auto/aca94dde0e934b8885b5a5b43431c861_9366/adidas-x-coca-cola-samba-og-shoes.jpg"
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_f2b52b8440ce4bd5a7be236c75419cdb",
    "credits_charged": 1,
    "credits_remaining": 1997
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/adidas?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.