GET
/
api
/
v1
/
sneakers
curl --location --request GET 'https://app.retailed.io/api/v1/sneakers?name=Jordan 4 Retro Where the Wild Things Are&extended=true' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <token>' \

{
    "count": 3,
    "data": [
        {
            "id": "33cab71a-3dc0-478b-a269-de7c9d4273c0",
            "name": "Jordan 4 Retro Where the Wild Things Are (GS)",
            "image": "https://retailed.fra1.digitaloceanspaces.com/product/jordan-4-retro-where-the-wild-things-are-gs.webp",
            "releasedAt": "2021-11-05",
            "sizing": "gradeschool",
            "initialPrice": 140,
            "colorway": "Pearl White/Dark Driftwood-Gym Red",
            "sku": "DH0572-264",
            "createdAt": "2022-12-09T19:31:39.911013+00:00",
            "updatedAt": null,
            "brand": {
                "id": "8560ea3d-0d41-4e9e-ba8f-6b19022841da",
                "name": "Jordan"
            }
        },
        {
            "id": "3ab41d09-b200-4472-bce5-51fbb50c173c",
            "name": "Jordan 4 Retro Where the Wild Things Are (PS)",
            "image": "https://retailed.fra1.digitaloceanspaces.com/product/jordan-4-retro-where-the-wild-things-are-ps.webp",
            "releasedAt": "2021-11-05",
            "sizing": "primaryschool",
            "initialPrice": 85,
            "colorway": "Pearl White/Dark Driftwood-Gym Red",
            "sku": "DH0573-264",
            "createdAt": "2022-12-24T10:00:15.862658+00:00",
            "updatedAt": null,
            "brand": {
                "id": "8560ea3d-0d41-4e9e-ba8f-6b19022841da",
                "name": "Jordan"
            }
        },
        {
            "id": "e07bb4ec-0410-438b-b250-b13397ea8000",
            "name": "Jordan 4 Retro Where the Wild Things Are (TD)",
            "image": "https://retailed.fra1.digitaloceanspaces.com/product/jordan-4-retro-where-the-wild-things-are-td.webp",
            "releasedAt": "2021-11-05",
            "sizing": "toddler",
            "initialPrice": 65,
            "colorway": "Pearl White/Dark Driftwood-Gym Red",
            "sku": "DH0571-264",
            "createdAt": "2023-02-24T21:07:22.387386+00:00",
            "updatedAt": null,
            "brand": {
                "id": "8560ea3d-0d41-4e9e-ba8f-6b19022841da",
                "name": "Jordan"
            }
        }
    ],
    "error": null,
    "usage": {
        "plan": "API",
        "remaining": "unlimited"
    }
}

We provide our database in .csv export or available on a hyper-relevant search engine with Meilisearch. Contact us if you wish to synchronise with us.

x-api-key
string
required

Parameter defines the Retailed private key to use.

​
Query Parameters

id
string

Retailed internal ID

name
string

Sneaker name

sku
string

Sneaker code SKU

colorway
string

Sneaker colorway

initial_price
integer

Sneaker initial price

sizing
string

Sneaker sizing: newbalance(w), newbalance, woman, gradeschool, primaryschool, man, yeezy, yeezykids, crocs, converse, adidas, puma.

brand_id
string

Retailed internal brand ID

released_at
string

Sneaker released at.

extended
boolean

Show more informations about the sneakers

csv
boolean

Export results to csv

​
Response

count
number

Indicates the number of sneakers returned

data
object

Array of sneakers

error
object

Not empty if an error occured

usage
object

API usage

Was this page helpful?

PlatformsReleases