Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / StockX

1 credit per call3 endpoints29 datapoints

StockX API

StockX API for product search, product details and sales history with asks, bids and last sale in USD, EUR or GBP as JSON. 1 credit per successful call.

Get a free API keyRun it below
StockX
GET/v1/stockx/search?query=jordan+4&sort=lowest_ask&page=1&country=US&currency=USD
{
  "success": true,
  "data": {
    "query": "jordan 4",
    "country": "US",
    "currency": "USD",
    "sort": "lowest_ask",
    "items": [
      {
        "id": "b9dc5dd4-05ec-4f97-8fa7-6808802c0b83",
        "slug": "air-jordan-4-retro-vivid-sulfur-womens",
        "url": "https://stockx.com/air-jordan-4-retro-vivid-sulfur-womens",
        "title": "Jordan 4 Retro Vivid Sulfur (Women's)",
        "name": "Vivid Sulfur (Women's)",
        "model": "Jordan 4 Retro",
        "brand": "Jordan",
        "gender": "women",
        "category": "sneakers",
        "category_path": [
          "sneakers",
          "lifestyle"
        ],
        "condition": "New",
        "release_date": "2024-04-06",
        "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784231252",
        "image_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784231252",
        "sizes_count": 25,
        "lowest_ask": {
          "amount": 12,
          "currency": "USD"
        },
        "lowest_ask_updated_at": "2026-11-11T06:57:02Z",
        "all_in_price": {
          "amount": 18.91,
          "currency": "USD"
        },
        "highest_bid": {
          "amount": 122,
          "currency": "USD"
        },
        "ask_count": 434,
        "ask_levels": {
          "standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 434
          },
          "express_standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 117
          },
          "express_expedited": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 69
          },
          "express_next_day": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 69
          }
        },
        "last_sale": {
          "amount": 69,
          "currency": "USD"
        },
        "price_premium": -0.674,
        "volatility": 0.38852,
        "annual_average_price": {
          "amount": 132,
          "currency": "USD"
        },
        "annual_sales_count": 1515,
        "average_price_90d": {
          "amount": 124,
          "currency": "USD"
        },
        "sales_last_90d": 152,
        "sales_last_72h": 16
      },
      {
        "id": "849deb68-1e31-4fdf-a862-5f537176dd39",
        "slug": "air-jordan-4-rm-bred-td",
        "url": "https://stockx.com/air-jordan-4-rm-bred-td",
        "title": "Jordan 4 RM Bred (TD)",
        "name": "Bred (TD)",
        "model": "Jordan 4 RM",
        "brand": "Jordan",
        "gender": "kids",
        "category": "sneakers",
        "category_path": [
          "sneakers",
          "lifestyle"
        ],
        "condition": "New",
        "release_date": "2025-01-15",
        "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1739851250",
        "image_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1739851250",
        "sizes_count": 9,
        "lowest_ask": {
          "amount": 25,
          "currency": "USD"
        },
        "lowest_ask_updated_at": "2026-08-05T12:29:17Z",
        "all_in_price": {
          "amount": 31.95,
          "currency": "USD"
        },
        "ask_count": 8,
        "ask_levels": {
          "standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 8
          },
          "express_standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 1
          }
        },
        "last_sale": {
          "amount": 3,
          "currency": "USD"
        },
        "price_premium": -0.945,
        "volatility": 3.5,
        "annual_average_price": {
          "amount": 14,
          "currency": "USD"
        },
        "annual_sales_count": 6,
        "average_price_90d": {
          "amount": 12,
          "currency": "USD"
        },
        "sales_last_90d": 4
      },
      {
        "id": "5f68e07d-0496-47f2-b9f1-73de5a566f67",
        "slug": "air-jordan-4-rm-aluminum-white-womens",
        "url": "https://stockx.com/air-jordan-4-rm-aluminum-white-womens",
        "title": "Jordan 4 RM Aluminum White (Women's)",
        "name": "Aluminum White (Women's)",
        "model": "Jordan 4 RM",
        "brand": "Jordan",
        "gender": "women",
        "category": "sneakers",
        "category_path": [
          "sneakers",
          "lifestyle"
        ],
        "condition": "New",
        "release_date": "2025-04-20",
        "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1747675187",
        "image_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1747675187",
        "sizes_count": 15,
        "lowest_ask": {
          "amount": 30,
          "currency": "USD"
        },
        "lowest_ask_updated_at": "2026-10-23T20:36:45Z",
        "all_in_price": {
          "amount": 36.95,
          "currency": "USD"
        },
        "highest_bid": {
          "amount": 62,
          "currency": "USD"
        },
        "ask_count": 44,
        "ask_levels": {
          "standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 44
          },
          "express_standard": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 18
          },
          "express_expedited": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 2
          },
          "express_next_day": {
            "lowest_ask": "…",
            "all_in_price": "…",
            "ask_count": 2
          }
        },
        "last_sale": {
          "amount": 64,
          "currency": "USD"
        },
        "price_premium": -0.576,
        "volatility": 0.609315,
        "annual_average_price": {
          "amount": 69,
          "currency": "USD"
        },
        "annual_sales_count": 22,
        "average_price_90d": {
          "amount": 41,
          "currency": "USD"
        },
        "sales_last_90d": 4
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 40,
      "page_count": 25,
      "total": 1000,
      "has_more": true
    }
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_34511ce3baab4c70bcdda87da9814f30",
    "credits_charged": 1,
    "credits_remaining": 1918
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringslugstringurlurltitlestringnamestringmodelstringbrandstringgenderstringcategorystringcategory_pathstring[]conditionstringrelease_datestringthumbnail_urlurlimage_urlurlsizes_countintegerlowest_askobjectlowest_ask_updated_atstringall_in_priceobjecthighest_bidobjectask_countintegerask_levelsobjectlast_saleobjectprice_premiumnumbervolatilitynumberannual_average_priceobjectannual_sales_countintegeraverage_price_90dobjectsales_last_90dintegersales_last_72hnumber
1b9dc5dd4-05ec-4f97-8fa7-6808802c0b83air-jordan-4-retro-vivid-sulfur-womenshttps://stockx.com/air-jordan-4-retro-vivid-sulfur-womensJordan 4 Retro Vivid Sulfur (Women's)Vivid Sulfur (Women's)Jordan 4 RetroJordanwomensneakers[2 items]New2024-04-06https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784231252https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=178423125225{2 fields}2026-11-11T06:57:02Z{2 fields}{2 fields}434{4 fields}{2 fields}-0.6740.38852{2 fields}1515{2 fields}15216
2849deb68-1e31-4fdf-a862-5f537176dd39air-jordan-4-rm-bred-tdhttps://stockx.com/air-jordan-4-rm-bred-tdJordan 4 RM Bred (TD)Bred (TD)Jordan 4 RMJordankidssneakers[2 items]New2025-01-15https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1739851250https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=17398512509{2 fields}2026-08-05T12:29:17Z{2 fields}—8{2 fields}{2 fields}-0.9453.5{2 fields}6{2 fields}4—
35f68e07d-0496-47f2-b9f1-73de5a566f67air-jordan-4-rm-aluminum-white-womenshttps://stockx.com/air-jordan-4-rm-aluminum-white-womensJordan 4 RM Aluminum White (Women's)Aluminum White (Women's)Jordan 4 RMJordanwomensneakers[2 items]New2025-04-20https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1747675187https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=174767518715{2 fields}2026-10-23T20:36:45Z{2 fields}{2 fields}44{4 fields}{2 fields}-0.5760.609315{2 fields}22{2 fields}4—

Recorded from our API · 3 items shown · 29 datapoints per itemGET /v1/stockx/search?query=jordan+4&sort=lowest_ask&page=1&country=US&currency=USD

29 datapoints

Identity

  • idstring
  • slugstring
  • titlestring
  • namestring
  • brandstring
  • categorystring
  • category_pathstring[]
  • highest_bidobject

Contact

  • urlurl
  • thumbnail_urlurl
  • image_urlurl

Location

  • volatilitynumber

Price

  • all_in_priceobject
  • price_premiumnumber
  • annual_average_priceobject
  • average_price_90dobject

Other

  • modelstring
  • genderstring
  • conditionstring
  • release_datestring
  • sizes_countinteger
  • lowest_askobject
  • lowest_ask_updated_atstring
  • ask_countinteger
  • ask_levelsobject
  • last_saleobject
  • annual_sales_countinteger
  • sales_last_90dinteger
  • sales_last_72hnumber

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/stockx/search?query=jordan+4&sort=lowest_ask&page=1&country=US&currency=USD" \
  -H "X-API-Key: $API_KEY"

StockX · 3 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/stockx/product
countrycurrency+3 optional
1 credit
GET/v1/stockx/sales
productcountrycurrency+1 optional
1 credit
GET/v1/stockx/search
sortpagecountrycurrency+6 optional
1 credit

Overview

What you can get

The StockX API returns StockX market data as JSON through 3 endpoints. Each takes a country (US, DE or GB) and a currency (USD, EUR or GBP).

  • Search: search takes a sort (featured, lowest_ask, price_premium, recent_asks, volatility or average_price) and a page, with query, category, brand, gender, min_price and max_price.
  • Products: product takes a url, slug or id.
  • Sales: sales takes a product, with size.

The recorded search for "jordan 4" sorted by lowest_ask in US and USD returns items, each with id, slug, title, model, brand, gender, category, release_date, sizes_count, lowest_ask, all_in_price, highest_bid, ask_count, ask_levels, last_sale, price_premium, volatility, annual_average_price, annual_sales_count, average_price_90d, sales_last_90d and sales_last_72h. It also returns pagination with page_count and has_more.

How a call works

Search, then look up: GET /v1/stockx/search?query=jordan 4&sort=lowest_ask&page=1&country=US&currency=USD with your key in the X-API-Key header. Each result carries a slug, which product takes, and which sales takes as product, as in GET /v1/stockx/sales?product=air-jordan-4-retro-toro-bravo-2026&size=8&country=US&currency=USD. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track lowest asks and highest bids for a sneaker list

Use the StockX API to track lowest asks and highest bids for a sneaker list

Pull sales history for a product and size

Use the StockX API to pull sales history for a product and size

Find products trading above or below retail with `sort=price_premium`

Use the StockX API to find products trading above or below retail with `sort=price_premium`

Compare prices across US, DE and GB in their own currencies

Use the StockX API to compare prices across US, DE and GB in their own currencies

FAQ

Questions

How much does the StockX API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I get sales for one size?

Yes. Pass `size` to `sales`, with the product's `slug` as `product`.

Do I need a StockX account?

No. You call this StockX API with your Perceptlayer key in the `X-API-Key` header, with no StockX login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a StockX scraper instead?

You can, but a StockX scraper is code you maintain: page changes break it, requests get blocked, and StockX's terms govern how you collect data. The StockX API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the StockX API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs