> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kicks.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# v3.1.0

> Changelog from 2025-02-14 to 2025-08-06

# Changelog v3.1.29 (2025-08-06)

**Fixes**

* "Fear of Gods" products not being matched in Unified API.
* Normalized SKUs for Kicks Crew and Stadium Goods in GTIN API.
* GOAT products not being updated due to API changes.
* StockX Realtime API improvements.
* **Breaking change:** GOAT Realtime search endpoint was fixed, response structure changed.
* Increased refresh rate for Kicks Crew.

# Changelog v3.1.28 (2025-07-25)

**Features**

* Added [Unified API](/api-reference-v3/unified/product) endpoint, combining products from multiple sources by using multiple criteria to identify similar products.

**Fixes**

* Shopify data was not being updated correctly.

# Changelog v3.1.27 (2025-07-21)

**Fixes**

* Fixed `display[prices]` parameter not working correctly on `/api/v3/stockx/products/{id}` endpoint.

**Misc**

* Improved [KicksDB Explorer](https://explorer.kicks.dev):
  * Added express prices in the variant price chart.
  * Added 3 months and annual statistics cards.

# Changelog v3.1.26 (2025-07-18)

**Features**

* Added `display[statistics]` parameter to the [StockX Product Search](/api-reference-v3/stockx/search) and [StockX Product Detail](/api-reference-v3/stockx/product) endpoints.

**Fixes**

* Product updating and discovery was not working correctly for StockX.

# Changelog v3.1.25 (2025-07-09)

**Features**

* StockX real-time API is now available again! Important notes:
  * It's available only in the Standard, previous plans are not supported (expect Enterprise).
  * It's now limited to 60 requests per minute instead of 120, this might be raised in the future.
  * We are still testing it and we don't guarantee it'll stay available.

**Misc**

* Refreshed documentation for [Real-time Data](/documentation-v3/real-time).

# Changelog v3.1.24 (2025-07-07)

**Features**

* Added [Sales Chart](/api-reference-v3/stockx/chart) endpoint to the StockX API.

# Changelog v3.1.23 (2025-06-27)

**Features**

* Added new search engine with advanced filtering capabilities to [GOAT Search](/api-reference-v3/goat/search) endpoint.
* Added a more detailed `categories` field to StockX API endpoints, with filtering capabilities.

**Deprecations**

* GOAT Search: `slugs` and `sku` parameters are deprecated, use `filters` instead.

**Misc**

* Added possibility to pay by crypto via Coinbase.

# Changelog v3.1.22 (2025-06-22)

**Features**

* Express Standard and Express Expedited prices are now available for StockX products. Enable them with the `display[prices]` parameter in the [StockX Product Search](/api-reference-v3/stockx/search) endpoint and the [StockX Product Detail](/api-reference-v3/stockx/product) endpoint.
* Added `cursor` parameter to [Shopify API endpoints](/api-reference-v3/shopify/search), allowing to paginate through the results and bypass the 50 page limit.
* GOAT variants (with lowest price) are now available via StockX API (see [StockX Product Detail](/api-reference-v3/stockx/product)).
* Added `position` to StockX variants, allowing to have sizes in the correct order.

**Bug fixes**

* StockX search engine was not correctly configured and was returning imprecise results.

**Improvements**

* StockX products with empty `gallery` field will be filled with default `image_url` when provided.

# Changelog v3.1.21 (2025-06-17)

**Improvements**

* Shopify API is now using the new search engine, same as StockX. Advanced `filters` parameter is now supported.
* Kicks Crew and Stadium Goods API endpoints are now deprecated, use [Shopify API](/api-reference-v3/shopify/search) instead.

**Bug fixes**

* Shopify scraper had some issues fetching products, it's now fixed.

# Changelog v3.1.20 (2025-06-12)

**Features**

* Added complex queries support to the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.

**Deprecations**

* Every pre-defined filters of [StockX Product Search](/api-reference-v3/stockx/search) endpoint are deprecated, use `filters` instead.

# Changelog v3.1.19 (2025-06-08)

**Features**

* Added enhanced coverage for CHF market for StockX. Read more about [Markets and currencies](/documentation-v3/markets).
* Added `display[hidden_variants]` parameter to the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.
* Added `display[hidden_variants]` parameter to the [StockX Product Detail](/api-reference-v3/stockx/product) endpoint.

**Improvements**

* StockX contains some duplicate/inactive variants, they are now hidden by default and can be shown with the `display[hidden_variants]` parameter.

# Changelog v3.1.18 (2025-06-06)

**Features**

* Added 8 new stores on our Shopify integration, cumulating to 35 stores.

**Bug fixes**

* Repaired every GOAT realtime endpoints and added them into our status page for better monitoring.

**Improvements**

* V2 and RapidAPI search endpoints was reworked to use new search engine.
* Added `gallery_360` to search results in v3.

**Removals**

* `size` parameter is removed from the [Products Search (v2)](/api-reference-v2/endpoint/products) endpoint.
* `under_price` parameter is removed from the [Products Search (v2)](/api-reference-v2/endpoint/products) endpoint.

# Changelog v3.1.17 (2025-06-03)

**Features**

* Rewritten search engine for StockX products:
  * Results are now much more accurate.
  * Performance is also greatly improved.
  * The `total` count returned is limited to 1000, even if there are more products, this is the only trade-off of this solution, it might change in the future.

**Improvements**

* Improved `display[variants]` performance for StockX products.

**Removals**

* `size` and `max_price` parameters are removed from the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.

# Changelog v3.1.16 (2025-06-02)

**New features**

* Added Shopify integration:
  * Added [Shopify](/api-reference-v3/shopify/shops) endpoint to get all shops.
  * Added [Shopify](/api-reference-v3/shopify/product) endpoint to get a product.
  * Added [Shopify](/api-reference-v3/shopify/search) endpoint to search products.

**Bug fixes**

* StockX:
  * `FR` and `DE` markets had only 30% of products being daily-updated.
  * Some SKUs were not extracted correctly due to `traits` vs `styleId` difference.

# Changelog v3.1.15 (2025-05-27)

**Performance**

* Greatly improved price retrieval performance for StockX products.
* Sales count (15, 30, 60 days) is now pre-aggregated and cached.
* Sizes retrieval performance is improved.

**Improvements**

* `display[sizes]` parameter is removed and enabled by default for following endpoints:
  * [StockX Product Search](/api-reference-v3/stockx/search)
  * [StockX Product Detail](/api-reference-v3/stockx/product)

# Changelog v3.1.14 (2025-05-21)

**Features**

* Re-added `total_asks` support.
* Re-added `subtotal` support for StockX via `display[subtotal]` parameter:
  * [StockX Product Search](/api-reference-v3/stockx/search)
  * [StockX Product Detail](/api-reference-v3/stockx/product)
* Added `FI.vat-registered` market data.

**Removals**

* `display[market_germany]` parameter is removed, use `currency` and `market` query parameters instead.
* `display[price_gbp]` parameter is removed, use `currency` and `market` query parameters instead.
* `display[asks]` parameter is removed.

# Changelog v3.1.13 (2025-05-20)

**Features**

* Added support for France/EUR market.
* Added `currency` and `market` query parameters to:
  * [StockX Product Search](/api-reference-v3/stockx/search)
  * [StockX Product Detail](/api-reference-v3/stockx/product)

**Deprecation notice**

* `display[market_germany]` parameter is deprecated, use `currency` and `market` query parameters instead.
* `display[price_gbp]` parameter is deprecated, use `currency` and `market` query parameters instead.
* `subtotal` might be removed in the future, please avoid relying on it.
* `previous_*` fields might be removed in the future, please avoid relying on them.

# Changelog v3.1.12 (2025-05-15)

**Features**

* Introduced a new way to update products' prices:
  * Working on three markets: US (USD), UK (GBP) and Germany (EUR).
  * Updated between 2 and 4 times per day.
  * **You can ask for a specific market, we can add it.**
  * This is supposed to replace realtime API which is actually down.
* Added `display[market_germany]` parameter to the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.
* Added `display[market_germany]` parameter to the [StockX Product Detail](/api-reference-v3/stockx/product) endpoint.
* Added `subcategory` parameter to the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.
* Inverted `category` and `product_type` parameters to match correctly the response.

**Bug fixes**

* SKU, category and traits are now updated correctly, based on StockX API response.
* Reduced number of products returned in GOAT webhooks, causing too large payloads.

# Changelog v3.1.11 (2025-05-11)

**Features**

* Added `gender` parameter to the [StockX Product Search](/api-reference-v3/stockx/search) endpoint.

# Changelog v3.1.10 (2025-04-26)

**Features**

* Added `display[variants]` parameter to the [GOAT Product Search](/api-reference-v3/goat/search) endpoint.
* Added [product detail route for GOAT](/api-reference-v3/goat/product).

**Improvements**

* Added `country` support for GOAT sales history.
* Added numbers of asks and product type for StockX webhooks.

**Bug fixes**

* Fixed potential issue with GOAT Realtime API.

# Changelog v3.1.9 (2025-04-23)

**Features**

* Added [GOAT monitoring via webhooks for GBP prices](/webhooks-v3/events/goat-price-updated-gbp).

# Changelog v3.1.8 (2025-04-13)

**Improvements**

* Added `gender` to StockX product listing.

**Bug fixes**

* Webhooks for `GBP` price change can prepare up to 1500 products at once, was 50 before.
* Due to pipeline migration, gathering new StockX products was not migrated yet, it's now done.

# Changelog v3.1.7 (2025-04-03)

**New features**

* Added the [Get recent orders (Alias)](/api-reference-v3/realtime/alias-recent-orders) endpoint to the Realtime API, allowing to gather recent orders for a product from Alias.

**Bug fixes**

* Parameter `display[sizes]` alone was returning an error on StockX Product Search.

# Changelog v3.1.6 (2025-04-01)

* SneakersAPI.dev is now renamed to KicksDB, with the domain being updated to kicks.dev.
  API endpoint is now `https://api.kicks.dev/v3/`. Old endpoints are still available.

# Changelog v3.1.5 (2025-03-20)

**New features**

* Added `stockx.lowest_ask.updated.usd` event to the Webhook API.

**Improvements**

* Changed the `display[price_gbp]` response structure to include `lowest_ask_gbp` in each variant instead of a sub-object.
* Processing time of webhook greatly improved.
* Processing time of general scraping improved as well.
* Improved product updating process.

**Bug fixes**

* Product rank being not updated.
* Added a new scraping job to ensure we don't miss any product from StockX.

# Changelog v3.1.4 (2025-03-12)

**New features**

* Added the `display[price_gbp]` parameter to the [Search StockX Product](/api-reference-v3/stockx/search) endpoint.
* Added the `display[price_gbp]` parameter to the [Product Detail](/api-reference-v3/stockx/product) endpoint.

**Bug fixes**

* `upcoming` field was only returned when sorting by `release_date` (StockX Product Search).

# Changelog v3.1.3 (2025-02-28)

**New features**

* Added the [GraphQL endpoint](/api-reference-v3/realtime/stockx-graphql) to the Realtime API, allowing to make any query directly on StockX without any rate-limit.

# Changelog v3.1.2 (2025-02-25)

**Improvements**

* Fixed a bug where some products are duplicated in the response.
* Improved real-time API performance.

# Changelog v3.1.1 (2025-02-24)

## Webhook Update

**New features**

* Added webhook features to the API. [Learn more](/webhooks-v3/introduction).
  * Added the `stockx.price.updated.usd` event.
  * Added the `stockx.price.updated.gbp` event.

**Improvements**

* Improved candidate selection for product updating by prioritizing every ranked product and products with a release date difference of less than 365 days

# Changelog v3.1.0 (2025-02-21)

## Dashboard Update

**New features**

* Users can now access a dashboard to monitor and manage their API usage. [Check out the dashboard](https://app.kicks.dev/dashboard).

**Bug fixes**

* Fixed our pipeline and realtime APIs not being able to fetch data for StockX products.
