GET
/
search
curl --request GET \
  --url https://api.sneakersapi.dev/search \
  --header 'Authorization: <api-key>'
{
  "hits": [
    {
      "age_group": "adult",
      "availability": "in stock",
      "avg_price": 351.88,
      "base_price": 378,
      "brand": "adidas",
      "category": "Apparel \u0026 Accessories \u003e Shoes",
      "color": "Carbon/Core Black/Matte Silver",
      "condition": "new",
      "currency": "USD",
      "description": "",
      "gender": "female",
      "id": "e3864a61-5d5f-41a2-804e-777e5b65dbb0",
      "image": "https://images.stockx.com/images/adidas-Forum-XLG-Carbon-Core-Black-Matte-Silver-Womens.jpg",
      "inserted_at": "2024-09-26T17:28:12Z",
      "retail_price": "110",
      "release_date": "2024-01-01",
      "is_bundle": false,
      "labels": ["sneakers", "adidas Forum", "IG8513"],
      "link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD",
      "max_price": 399,
      "min_price": 152,
      "size_system": "",
      "sku": "IG8513",
      "slug": "adidas-forum-xlg-carbon-core-black-matte-silver-women-s-e3864",
      "title": "adidas Forum XLG Carbon Core Black Matte Silver (Women's)",
      "variants": [
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=7W",
          "price": 378,
          "size": "7W",
          "variant_id": "48836b0f-02d0-448e-8663-3dcdc0b389f6"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=11W",
          "price": 399,
          "size": "11W",
          "variant_id": "54631e00-c9e3-461f-beb0-c7cd1cf52fe8"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=5W",
          "price": 356,
          "size": "5W",
          "variant_id": "99023bc1-78ad-4f59-bd9a-82c0ce38e7a0"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=5.5W",
          "price": 399,
          "size": "5.5W",
          "variant_id": "5b0a38ba-d12d-4450-ad05-9d92fe5f243a"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=6W",
          "price": 348,
          "size": "6W",
          "variant_id": "3127e07c-6582-4795-90ee-5cd25da7e20c"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=7.5W",
          "price": 390,
          "size": "7.5W",
          "variant_id": "a4c76fb5-e3a0-482d-b43e-736af0aae03c"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=9W",
          "price": 398,
          "size": "9W",
          "variant_id": "f048123b-0b3b-4164-834e-4bf24f8abb72"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=6.5W",
          "price": 347,
          "size": "6.5W",
          "variant_id": "24d0ecda-77c0-46e7-9afe-6a288201effb"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=8.5W",
          "price": 152,
          "size": "8.5W",
          "variant_id": "76394418-4582-4ca9-a7b4-804552bd5283"
        }
      ]
    }
  ],
  "estimatedTotalHits": 1000,
  "limit": 20,
  "processingTimeMs": 2,
  "query": "Adidas Forum"
}
​
query
string
required

Search query. This can be product title, id, GTIN, link, description, etc…

​
page
integer

Page

​
gtin
string

Perform exact match search by GTIN.

​
sku
string

Perform exact match search by SKU.

​
country
string

Perform search on specific country data, currency and price will be affected. Only FR is available for now. Leave empty for US dataset. API key (Pro or Ultra) is required to access non-US data.

Due to technical limitation of our search engine, the pagination count should not be trusted.

The search is score based, product containing fields near to the query will always be first.

Some fields are not guaranteed to be present in the response.

For example:

  • description
  • gtin
{
  "hits": [
    {
      "age_group": "adult",
      "availability": "in stock",
      "avg_price": 351.88,
      "base_price": 378,
      "brand": "adidas",
      "category": "Apparel \u0026 Accessories \u003e Shoes",
      "color": "Carbon/Core Black/Matte Silver",
      "condition": "new",
      "currency": "USD",
      "description": "",
      "gender": "female",
      "id": "e3864a61-5d5f-41a2-804e-777e5b65dbb0",
      "image": "https://images.stockx.com/images/adidas-Forum-XLG-Carbon-Core-Black-Matte-Silver-Womens.jpg",
      "inserted_at": "2024-09-26T17:28:12Z",
      "retail_price": "110",
      "release_date": "2024-01-01",
      "is_bundle": false,
      "labels": ["sneakers", "adidas Forum", "IG8513"],
      "link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD",
      "max_price": 399,
      "min_price": 152,
      "size_system": "",
      "sku": "IG8513",
      "slug": "adidas-forum-xlg-carbon-core-black-matte-silver-women-s-e3864",
      "title": "adidas Forum XLG Carbon Core Black Matte Silver (Women's)",
      "variants": [
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=7W",
          "price": 378,
          "size": "7W",
          "variant_id": "48836b0f-02d0-448e-8663-3dcdc0b389f6"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=11W",
          "price": 399,
          "size": "11W",
          "variant_id": "54631e00-c9e3-461f-beb0-c7cd1cf52fe8"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=5W",
          "price": 356,
          "size": "5W",
          "variant_id": "99023bc1-78ad-4f59-bd9a-82c0ce38e7a0"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=5.5W",
          "price": 399,
          "size": "5.5W",
          "variant_id": "5b0a38ba-d12d-4450-ad05-9d92fe5f243a"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=6W",
          "price": 348,
          "size": "6W",
          "variant_id": "3127e07c-6582-4795-90ee-5cd25da7e20c"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=7.5W",
          "price": 390,
          "size": "7.5W",
          "variant_id": "a4c76fb5-e3a0-482d-b43e-736af0aae03c"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=9W",
          "price": 398,
          "size": "9W",
          "variant_id": "f048123b-0b3b-4164-834e-4bf24f8abb72"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=6.5W",
          "price": 347,
          "size": "6.5W",
          "variant_id": "24d0ecda-77c0-46e7-9afe-6a288201effb"
        },
        {
          "gtin": "",
          "variant_link": "https://stockx.com/adidas-forum-xlg-carbon-core-black-matte-silver-womens?country=US&currencyCode=USD&size=8.5W",
          "price": 152,
          "size": "8.5W",
          "variant_id": "76394418-4582-4ca9-a7b4-804552bd5283"
        }
      ]
    }
  ],
  "estimatedTotalHits": 1000,
  "limit": 20,
  "processingTimeMs": 2,
  "query": "Adidas Forum"
}