Search StockX products

Try in Playground

Search StockX products by keyword, as stockx.com search does, and narrow the results by category, brand, gender, color, lowest-ask price range or below-retail pricing, sorted by featured, top selling, price, highest bid, release date, recent activity, last sale, price premium or sales. Each product returns its title, brand, model, category, release date, images and live market data: lowest ask, highest bid, last sale, active asks, recent sales counts, 90-day and annual averages, volatility and price premium. Pages of 40 products; choose the market to price in.

GET/v1/stockx/searchx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

querystringrequiredquery

Search keywords, up to 100 characters.

min 1 chars · max 100 chars

Examplejordan 4

pageintegerdefault: 1query

Result page, 1 to 25 (40 products a page, default 1).

default: 1 · 1 – 25

marketenumdefault: "us"query

Market whose prices are returned: us (USD, default), gb (GBP), de or fr (EUR), ca (CAD), au (AUD) or jp (JPY).

one of: us, gb, de, fr, ca, au, jp · default: "us"

sortenumquery

featured (default), most-active (top selling), lowest_ask, highest_bid, release_date, recent_asks, recent_bids, last_sale, price_premium or deadstock_sold.

one of: featured, most-active, lowest_ask, highest_bid, release_date, recent_asks, recent_bids, last_sale, price_premium, deadstock_sold

Examplelowest_ask

categorystringquery

One category alias from StockX's category tree, for example sneakers, apparel, trading-cards, tops or sealed-boxes.

max 80 chars

brandstringquery

Up to 10 comma-separated brand aliases, for example nike,jordan or new-balance.

max 400 chars

genderstringquery

Comma-separated: men, women, kids or unisex.

max 400 chars

Examplewomen

colorstringquery

Comma-separated: black, white, grey, brown, red, pink, orange, yellow, green, blue, purple or multi.

max 400 chars

price_minintegerquery

Optional.

0 – 1000000

price_maxintegerquery

Optional.

0 – 1000000

below_retailstringquery

true returns only products whose lowest ask is below retail.

Response fields

requestIdstring

Request correlation UUID.

Upstream requests, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned; inspect status and coverage for omissions.

statusenum

success, partial, failed or challenged. HTTP 200 can be partial.

one of: success, partial

sourceUrlstring

The stockx.com page the data describes.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

Retrieval coverage and warning codes: filter_not_applied when StockX did not apply a requested filter value (for example an unknown brand or category), malformed_products_omitted when a result could not be read.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsenum[]

Always included.

querystring

Search keywords, up to 100 characters.

marketenum

Market whose prices are returned: us (USD, default), gb (GBP), de or fr (EUR), ca (CAD), au (AUD) or jp (JPY).

one of: us, gb, de, fr, ca, au, jp

currencystring

Currency of every price in the response.

sortenumnullable

featured (default), most-active (top selling), lowest_ask, highest_bid, release_date, recent_asks, recent_bids, last_sale, price_premium or deadstock_sold.

The filters and sort as sent: category, brand, gender, color, priceMin, priceMax and belowRetail, with the sort id or null.

filters.categorystringnullable

Always included.

filters.brandstring[]

Always included.

filters.genderstring[]

Always included.

filters.colorstring[]

Always included.

filters.priceMinnumbernullable

Always included.

filters.priceMaxnumbernullable

Always included.

filters.belowRetailboolean

Always included.

pageinteger

Result page, 1 to 25 (40 products a page, default 1).

≥ 1

pageCountinteger

Always included.

≥ 0

totalCountintegernullable

Always included.

≥ 0

hasMoreboolean

Always included.

nextPageintegernullable

Always included.

≥ 2

Always included.

up to 40 items

products.idstring

Always included.

min 1 chars · max 100 chars

products.slugstring

Always included.

products.urlstring

Always included.

absolute HTTPS URL

products.titlestring

Always included.

products.namestringnullable

Always included.

products.brandstringnullable

Always included.

products.modelstringnullable

Always included.

products.genderstringnullable

Always included.

products.productCategorystringnullable

Always included.

products.primaryCategorystringnullable

Always included.

products.categoriesstring[]

Always included.

products.conditionstringnullable

Always included.

products.listingTypestringnullable

Always included.

products.releaseDatestringnullable

Always included.

products.imagestringnullable

Always included.

products.thumbnailstringnullable

Always included.

products.sizeCountinteger

Always included.

≥ 0

products.isAdboolean

Always included.

products.market.lowestAsknumbernullable

Always included.

≥ 0

products.market.highestBidnumbernullable

Always included.

≥ 0

products.market.lastSalenumbernullable

Always included.

≥ 0

products.market.askCountintegernullable

Always included.

≥ 0

products.market.salesLast72Hoursintegernullable

Always included.

≥ 0

Always included.

products.market.last90Days.averagePricenumbernullable

Always included.

≥ 0

products.market.last90Days.salesCountintegernullable

Always included.

≥ 0

Always included.

products.market.annual.averagePricenumbernullable

Always included.

≥ 0

products.market.annual.salesCountintegernullable

Always included.

≥ 0

products.market.annual.volatilitynumbernullable

Always included.

products.market.annual.pricePremiumnumbernullable

Always included.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with filter_not_applied, malformed_products_omitted, sizes_truncated, market_history_unavailable or size_labels_unavailable warnings.
400	`invalid_request`	Missing, duplicate, malformed or unsupported parameters, both or neither of slug and url, both size and size_id, a link outside stockx.com product pages, a page outside 1–25, price_min above price_max, or an unknown sort, gender or color.
401	`unauthorized`	Missing or invalid worker API key.
404	`not_found`	Unknown product, or a size the product does not have.
429	`upstream_rate_limited`	StockX rate limited the request.
502	`upstream_challenged`	StockX's edge refused the request or its challenge did not clear (status challenged).
502	`unsupported_page`	Malformed or mismatched source data, or StockX changed its web client queries.
502	`response_too_large`	A response exceeded 4 MiB.
502	`request_limit`	The upstream request budget was exhausted.
502	`upstream_error`	Network failure, GraphQL error or an unexpected upstream status after one retry.
503	`busy`	Both retrieval slots and the queue are occupied, or the wait for a slot expired.
504	`timeout`	The 45-second deadline elapsed.

Code example

curl "https://api.scrapeatlas.com/v1/stockx/search?query=jordan+4&gender=women&sort=lowest_ask" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/stockx/search?query=jordan+4&gender=women&sort=lowest_ask",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/stockx/search?query=jordan+4&gender=women&sort=lowest_ask",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`StockX request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/stockx/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "jordan 4",
        "gender": "women",
        "sort": "lowest_ask"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/stockx/search?query=jordan+4&gender=women&sort=lowest_ask", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/stockx/search?query=jordan+4&gender=women&sort=lowest_ask"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://stockx.com/search?s=jordan+4&gender=women&sort=lowest_ask",
  "fetchedAt": "2026-10-27T12:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 224376,
    "durationMs": 2100
  },
  "query": "jordan 4",
  "market": "us",
  "currency": "USD",
  "sort": "lowest_ask",
  "filters": {
    "category": null,
    "brand": [],
    "gender": [
      "women"
    ],
    "color": [],
    "priceMin": null,
    "priceMax": null,
    "belowRetail": false
  },
  "page": 1,
  "pageCount": 25,
  "totalCount": 1000,
  "hasMore": true,
  "nextPage": 2,
  "products": [
    {
      "id": "9acafeb5-bc4a-4d66-bc3a-4899d2e64775",
      "slug": "air-jordan-4-retro-toro-bravo-2026",
      "url": "https://stockx.com/air-jordan-4-retro-toro-bravo-2026",
      "title": "Jordan 4 Retro Toro Bravo (2026)",
      "name": "Toro Bravo (2026)",
      "brand": "Jordan",
      "model": "Jordan 4 Retro",
      "gender": "men",
      "productCategory": "sneakers",
      "primaryCategory": "Air Jordan",
      "categories": [
        "sneakers",
        "lifestyle"
      ],
      "condition": "New",
      "listingType": "STANDARD",
      "releaseDate": "2026-05-30",
      "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?w=300",
      "thumbnail": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?w=140",
      "sizeCount": 26,
      "isAd": false,
      "market": {
        "lowestAsk": 164,
        "highestBid": 421,
        "lastSale": 169,
        "askCount": 1889,
        "salesLast72Hours": 194,
        "last90Days": {
          "averagePrice": 178,
          "salesCount": 13025
        },
        "annual": {
          "averagePrice": 181,
          "salesCount": 37750,
          "volatility": 0.108184,
          "pricePremium": -0.232
        }
      }
    }
  ]
}

Missing, duplicate, malformed or unsupported parameters, both or neither of slug and url, both size and size_id, a link outside stockx.com product pages, a page outside 1–25, price_min above price_max, or an unknown sort, gender or color.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}