GET
/
v3
/
realtime
/
alias
/
products
/
{id}
/
recent-orders
curl --request GET \
  --url https://api.kicks.dev/v3/realtime/alias/products/{id}/recent-orders \
  --header 'Authorization: <api-key>'
{
  "status": "success",
  "query": {
    "condition": "1",
    "consigned": "false",
    "packaging_condition": "1",
    "region_id": "2",
    "size": "6.5"
  },
  "data": {
    "recent_sales": [
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-31T20:20:43.351Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-31T20:13:26.918Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-30T03:46:02.629Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-30T01:00:14.065Z",
        "size": 6.5
      },
      {
        "price_cents": "9700",
        "purchased_at": "2025-03-27T20:23:05.312Z",
        "size": 6.5
      },
      {
        "price_cents": "9900",
        "purchased_at": "2025-03-25T19:26:28.374Z",
        "size": 6.5
      },
      {
        "price_cents": "9500",
        "purchased_at": "2025-03-23T03:12:18.008Z",
        "size": 6.5
      },
      {
        "price_cents": "9300",
        "purchased_at": "2025-03-22T20:45:42.568Z",
        "size": 6.5
      },
      {
        "price_cents": "9000",
        "purchased_at": "2025-03-21T23:01:23.686Z",
        "size": 6.5
      },
      {
        "price_cents": "8900",
        "purchased_at": "2025-03-21T21:02:03.652Z",
        "size": 6.5
      }
    ]
  },
  "meta": {
    "execution_time": 404
  }
}

Notice

This endpoint allows 120 requests per minute per API key.

This endpoint is in beta.

Membership

This endpoint is available in the pro tier.

Path parameters

id
string
required

The product slug, compatible with GOAT slugs. The product ID is not supported.

Parameters

size
number

The size of the product.

region_id
number
default:"0"

The region ID of the product. By default, the region ID is 0 (global). 2 is Europe.

condition
number
default:"1"

The product condition. 1 is new, 2 is used, 3 is new with defects. The size must be specified.

packaging_condition
number
default:"1"

The packaging condition. 1 is good condition, 2 is missing lid, 3 is badly damaged, 4 is no original box. The size must be specified.

consigned
boolean
default:"false"

Whether the product is consigned. The size must be specified.

{
  "status": "success",
  "query": {
    "condition": "1",
    "consigned": "false",
    "packaging_condition": "1",
    "region_id": "2",
    "size": "6.5"
  },
  "data": {
    "recent_sales": [
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-31T20:20:43.351Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-31T20:13:26.918Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-30T03:46:02.629Z",
        "size": 6.5
      },
      {
        "price_cents": "9600",
        "purchased_at": "2025-03-30T01:00:14.065Z",
        "size": 6.5
      },
      {
        "price_cents": "9700",
        "purchased_at": "2025-03-27T20:23:05.312Z",
        "size": 6.5
      },
      {
        "price_cents": "9900",
        "purchased_at": "2025-03-25T19:26:28.374Z",
        "size": 6.5
      },
      {
        "price_cents": "9500",
        "purchased_at": "2025-03-23T03:12:18.008Z",
        "size": 6.5
      },
      {
        "price_cents": "9300",
        "purchased_at": "2025-03-22T20:45:42.568Z",
        "size": 6.5
      },
      {
        "price_cents": "9000",
        "purchased_at": "2025-03-21T23:01:23.686Z",
        "size": 6.5
      },
      {
        "price_cents": "8900",
        "purchased_at": "2025-03-21T21:02:03.652Z",
        "size": 6.5
      }
    ]
  },
  "meta": {
    "execution_time": 404
  }
}