Skip to main content
KicksDB relies on Meilisearch to search and filter products, our following endpoints uses Meilisearch under the hood:
  • StockX
  • GOAT
  • Shopify
These endpoints often have query parameter to search for products and filters parameter to filter products based on certain criteria. This recipe will show you how to use filters parameter.

​
Filtering products

You should consult the structure of the indexes below to understand the available filters. For example, if you want to filter products by brand, you can use the brand filter, like this: 
brand = "Nike";
Due to special characters, you might have to encode the filters to avoid errors, it should give a result like this: 
GET https://api.kicks.dev/v3/stockx/products?filters=brand%3D%22Nike%22
It’s possible to combine multiple filters, like this: 
brand = "Nike" AND product_type = "sneakers";
Finally, some filters use nested objects, like this: 
prices["USD_US"]["9.5"] < 100;
Values in quotes are not case sensitive.

Meilisearch documentation

You can consult the Meilisearch documentation for more information about the filters.

​
Indexes

Indexes are refreshed every 12 hours, you can consult the structure of the indexes below.

StockX

GOAT

Shopify

​
StockX

{
  "slug": "string",
  "brand": "string",
  "gender": "string",
  "product_type": "string",
  "category": "string",
  "secondary_category": "string",
  "categories": ["string"],
  "sku": "string",
  "rank": "number",
  "release_date": "string",
  "colorway": "string",
  "prices": {
    "currency_market": {
      // ^ Example: "USD_US"
      "size": "float"
      // ^ Example: 9.5 -- Value is the lowest price for this size
    }
  },
  "barcodes": ["string"],
  "breadcrumbs": ["string"],
  "updated_at": "date-time",
  "created_at": "date-time"
}

​
GOAT

{
  "brand": "string",
  "slug": "string",
  "sku": "string",
  "colorway": "string",
  "release_date": "string", // Format: YYYYMMDD or YYYY
  "rank": "number",
  "product_type": "string",
  "category": "string",
  "model": "string",
  "season": "string",
  "prices": {
    "<currency>": { "<size>": "float" }
    // ^ Example: "USD": { "9": 123.45 }
  }
}

​
Shopify

{
  "slug": "string",
  "brand": "string",
  "product_type": "string",
  "sku": "string",
  "prices": {
    "variant_title": "float" // variant_title -> variant price
  },
  "shop_name": "string",
  "barcodes": ["string"],
  "cursor": "number" // Used to paginate through the results
}