# StockX Trends

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/stockx/trends` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/stockx-trends |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/stockx/trends' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Get trending sneakers sorted by release date

```json
[
  {
    "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"
  }
]
```

## Documentation

## Overview
The StockX Trends endpoint returns currently trending products on StockX by category, sortable by featured, most active, or release date.

## Quickstart
```
GET https://api.piloterr.com/v2/stockx/trends?query=sneakers&sort_by=most_active&country=US
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Category name |
| `sort_by` | string | no | `featured`, `most_active`, or `release_date` |
| `country` | string | no | Country code |

## Response fields
| Field | Type | Description |
|---|---|---|
| `[].slug` | string | Product slug |
| `[].name` | string | Product name |
| `[].brand` | string | Brand |
| `[].release_date` | string | Release date |

## Main use cases
- Track trending sneakers for resale market analysis
- Monitor new releases and post-release trading momentum
- Build sneaker trend dashboards by category and country
- Automate alerts for high-demand product releases