Piloterr

StockX Trends

GET
/v2/stockx/trends

Retrieve trending products on StockX by category, with options to sort by featured, most active, or release date.

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

StockX product category to retrieve trending items for.

Accepted values:

  • sneakers: Trending sneakers
  • streetwear: Trending streetwear
  • electronics: Trending electronics
  • trading cards: Trending trading cards
  • collectibles: Trending collectibles
  • apparel: Trending apparel
  • handbags: Trending handbags
  • watches: Trending watches
sort_by?string

Sort order for trending results.

  • featured: Featured/curated items (default)
  • most_active: Most actively traded items
  • release_date: Newest releases first
Default"featured"
country?string

Country code for localized trending data.

  • US: United States
  • FR: France
  • GB: United Kingdom
Default"US"
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.piloterr.com/v2/stockx/trends?query=string'
Example Response
[  {    "id": "6693bae8-39f1-4809-a6a3-b26c91a7aa5a",    "sku": "1J30-291-025/1J30-191-025",    "name": "A Bathing Ape Bape SK8 Sta Grey Gold White",    "slug": "a-bathing-ape-bape-sk8-sta-grey-gold-white",    "brand": "bape",    "image": "https://images.stockx.com/images/A-Bathing-Ape-Bape-SK8-Sta-Grey-Gold-White.jpg",    "category": "sneakers",    "release_date": "2023-04-14"  },  {    "id": "0b450075-9f93-4423-8677-4d8029ff7348",    "sku": "DZ5485-612",    "name": "Jordan 1 Retro High OG Chicago 2022",    "slug": "air-jordan-1-high-og-chicago-2022",    "brand": "Jordan",    "image": "https://images.stockx.com/images/Air-Jordan-1-Retro-High-OG-Chicago-2022.jpg",    "category": "sneakers",    "release_date": "2023-05-06"  }]