Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Grailed

1 credit per call4 endpoints27 datapoints

Grailed API

Grailed API for listing search by designer, size and condition, sold listings, listing details, users and designers as JSON. 1 credit per successful call.

Get a free API keyRun it below
Grailed
GET/v1/grailed/search?query=undercover+jacket&designer[]=Undercover&price_max=1500&sort=newest
{
  "success": true,
  "items": [
    {
      "id": 112096050,
      "url": "https://www.grailed.com/listings/112096050",
      "title": "Sz 2 Undercover 15AW Ghost Hand Coat mojos13491027",
      "designers": [
        {
          "id": 10,
          "name": "Undercover"
        }
      ],
      "category": "outerwear",
      "category_path": "outerwear.heavy_coats",
      "department": "menswear",
      "size": "m",
      "color": "black",
      "condition": {
        "key": "is_gently_used",
        "label": "Gently Used"
      },
      "price": {
        "amount": 1299,
        "currency": "USD"
      },
      "pricing": {
        "price_drop_count": 0
      },
      "sold": false,
      "location": "Asia",
      "shipping": {
        "us": {
          "amount": 60,
          "enabled": true
        },
        "ca": {
          "amount": 60,
          "enabled": true
        },
        "uk": {
          "amount": 60,
          "enabled": true
        },
        "eu": {
          "amount": 60,
          "enabled": false
        },
        "asia": {
          "amount": 60,
          "enabled": true
        },
        "au": {
          "amount": 60,
          "enabled": true
        },
        "other": {
          "amount": 60,
          "enabled": true
        }
      },
      "cover_photo": {
        "url": "https://media-assets.grailed.com/prd/listing/temp/5c6024caf66c44eb83fe4388d7930adc",
        "width": 1206,
        "height": 1608
      },
      "photo_count": 7,
      "measurement_count": 0,
      "likes": 0,
      "buy_now": true,
      "make_offer": true,
      "market": "grailed",
      "traits": [
        {
          "name": "color",
          "value": "black"
        },
        {
          "name": "country_of_origin",
          "value": "JP"
        }
      ],
      "seller": {
        "id": 319028,
        "username": "MOJOs",
        "avatar_url": "https://media-assets.grailed.com/prd/avatar/319028/254106e53f5641188f6ae801f47caf12",
        "rating": {
          "average": 4.91,
          "count": 488
        },
        "items_bought_and_sold": 1369,
        "trusted_seller": true
      },
      "created_at": "2026-11-12T11:14:32.574Z",
      "bumped_at": "2026-11-12T11:14:24.537Z",
      "price_updated_at": "2026-11-12T11:14:32.574Z"
    },
    {
      "id": 112094581,
      "url": "https://www.grailed.com/listings/112094581",
      "title": "Vintage Japanese Brand DAILY TOPICS Chore Denim Jacket",
      "designers": [
        {
          "id": 431,
          "name": "Comme des Garcons"
        },
        {
          "id": 10,
          "name": "Undercover"
        }
      ],
      "category": "outerwear",
      "category_path": "outerwear.denim_jackets",
      "department": "menswear",
      "size": "m",
      "color": "blue",
      "condition": {
        "key": "is_gently_used",
        "label": "Gently Used"
      },
      "price": {
        "amount": 199,
        "currency": "USD"
      },
      "pricing": {
        "price_drop_count": 0
      },
      "sold": false,
      "location": "Asia",
      "shipping": {
        "us": {
          "amount": 25,
          "enabled": true
        },
        "ca": {
          "amount": 25,
          "enabled": true
        },
        "uk": {
          "amount": 25,
          "enabled": true
        },
        "eu": {
          "amount": 25,
          "enabled": true
        },
        "asia": {
          "amount": 25,
          "enabled": true
        },
        "au": {
          "amount": 25,
          "enabled": true
        },
        "other": {
          "amount": 25,
          "enabled": true
        }
      },
      "cover_photo": {
        "url": "https://media-assets.grailed.com/prd/listing/29548583/d6f2f53e4fc446c1af094f526e809694",
        "width": 3024,
        "height": 4032
      },
      "photo_count": 14,
      "measurement_count": 4,
      "likes": 6,
      "buy_now": true,
      "make_offer": true,
      "market": "grailed",
      "styles": [
        "avant-garde"
      ],
      "traits": [
        {
          "name": "color",
          "value": "blue"
        },
        {
          "name": "country_of_origin",
          "value": "JP"
        }
      ],
      "seller": {
        "id": 892097,
        "username": "OneLegend",
        "avatar_url": "https://media-assets.grailed.com/prd/avatar/892097/06ccd3a054544df295b5cec5dbaded72",
        "rating": {
          "average": 4.8,
          "count": 1001
        },
        "items_bought_and_sold": 2619,
        "trusted_seller": false
      },
      "created_at": "2026-11-12T10:44:22.218Z",
      "bumped_at": "2026-11-12T10:44:22.218Z",
      "price_updated_at": "2026-11-12T10:44:22.218Z"
    },
    {
      "id": 112083095,
      "url": "https://www.grailed.com/listings/112083095",
      "title": "AW16 Jacket",
      "designers": [
        {
          "id": 10,
          "name": "Undercover"
        }
      ],
      "category": "outerwear",
      "category_path": "outerwear.heavy_coats",
      "department": "menswear",
      "size": "l",
      "color": "blue",
      "condition": {
        "key": "is_gently_used",
        "label": "Gently Used"
      },
      "price": {
        "amount": 375,
        "currency": "USD"
      },
      "pricing": {
        "price_drop_count": 0
      },
      "sold": false,
      "location": "Asia",
      "shipping": {
        "us": {
          "amount": 30,
          "enabled": true
        },
        "ca": {
          "amount": 30,
          "enabled": true
        },
        "uk": {
          "amount": 35,
          "enabled": true
        },
        "eu": {
          "amount": 35,
          "enabled": true
        },
        "asia": {
          "amount": 35,
          "enabled": true
        },
        "au": {
          "amount": 35,
          "enabled": true
        },
        "other": {
          "amount": 40,
          "enabled": true
        }
      },
      "cover_photo": {
        "url": "https://media-assets.grailed.com/prd/listing/temp/224de82f396d404a90e7035e6ea2ddbb",
        "width": 900,
        "height": 1200
      },
      "photo_count": 8,
      "measurement_count": 4,
      "likes": 0,
      "buy_now": true,
      "make_offer": true,
      "market": "grailed",
      "traits": [
        {
          "name": "color",
          "value": "blue"
        }
      ],
      "seller": {
        "id": 8645176,
        "username": "pony_express",
        "avatar_url": "https://media-assets.grailed.com/prd/avatar/8645176/0eb92ddfe7d647f49f726e4695360e6c",
        "rating": {
          "average": 4.95,
          "count": 679
        },
        "items_bought_and_sold": 1927,
        "trusted_seller": true
      },
      "created_at": "2026-11-12T07:20:47.451Z",
      "bumped_at": "2026-11-12T07:20:37.145Z",
      "price_updated_at": "2026-11-12T07:20:47.451Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 40,
    "total_results": 5060,
    "reachable_results": 1000,
    "total_pages": 25,
    "has_more": true
  },
  "filters_applied": {
    "query": "undercover jacket",
    "price_max": "1500",
    "sort": "newest",
    "designer": [
      "Undercover"
    ],
    "status": "for_sale"
  },
  "meta": {
    "endpoint_family": "search",
    "filtered_out": 0,
    "request_id": "req_de3338db23e34ae2abd3eb34dc3ea922",
    "credits_charged": 1,
    "credits_remaining": 1919
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerurlurltitlestringdesignersobject[]categorystringcategory_pathstringdepartmentstringsizestringcolorstringconditionobjectpriceobjectpricingobjectsoldbooleanlocationstringshippingobjectcover_photoobjectphoto_countintegermeasurement_countintegerlikesintegerbuy_nowbooleanmake_offerbooleanmarketstringtraitsobject[]sellerobjectcreated_atstringbumped_atstringprice_updated_atstring
1112096050https://www.grailed.com/listings/112096050Sz 2 Undercover 15AW Ghost Hand Coat mojos13491027[1 item]outerwearouterwear.heavy_coatsmenswearmblack{2 fields}{2 fields}{1 fields}falseAsia{7 fields}{3 fields}700truetruegrailed[2 items]{6 fields}2026-11-12T11:14:32.574Z2026-11-12T11:14:24.537Z2026-11-12T11:14:32.574Z
2112094581https://www.grailed.com/listings/112094581Vintage Japanese Brand DAILY TOPICS Chore Denim Jacket[2 items]outerwearouterwear.denim_jacketsmenswearmblue{2 fields}{2 fields}{1 fields}falseAsia{7 fields}{3 fields}1446truetruegrailed[2 items]{6 fields}2026-11-12T10:44:22.218Z2026-11-12T10:44:22.218Z2026-11-12T10:44:22.218Z
3112083095https://www.grailed.com/listings/112083095AW16 Jacket[1 item]outerwearouterwear.heavy_coatsmenswearlblue{2 fields}{2 fields}{1 fields}falseAsia{7 fields}{3 fields}840truetruegrailed[1 item]{6 fields}2026-11-12T07:20:47.451Z2026-11-12T07:20:37.145Z2026-11-12T07:20:47.451Z

Recorded from our API · 3 items shown · 27 datapoints per itemGET /v1/grailed/search?query=undercover+jacket&designer[]=Undercover&price_max=1500&sort=newest

27 datapoints

Identity

  • idinteger
  • titlestring
  • categorystring
  • category_pathstring

Contact

  • urlurl
  • sellerobject

Location

  • locationstring

Reputation

  • cover_photoobject
  • photo_countinteger

Price

  • priceobject
  • price_updated_atstring

Other

  • designersobject[]
  • departmentstring
  • sizestring
  • colorstring
  • conditionobject
  • pricingobject
  • soldboolean
  • shippingobject
  • measurement_countinteger
  • likesinteger
  • buy_nowboolean
  • make_offerboolean
  • marketstring
  • traitsobject[]
  • created_atstring
  • bumped_atstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/grailed/search?query=undercover+jacket&designer[]=Undercover&price_max=1500&sort=newest" \
  -H "X-API-Key: $API_KEY"

Grailed · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/grailed/designers
query+1 optional
1 credit
GET/v1/grailed/listing
none+2 optional
1 credit
GET/v1/grailed/search
none+12 optional
1 credit
GET/v1/grailed/user
username+3 optional
1 credit

Overview

What you can get

The Grailed API returns Grailed marketplace data as JSON through 4 endpoints.

  • Search: search takes a query, with department (menswear or womenswear), price_min, price_max, status (for_sale or sold), sort (relevance, newest, price_asc, price_desc, heat, heat_recency, most_liked or quality) and page. designer[], category[], size[], condition[] (new, gently_used, used or worn) and location[] (United States, Canada, United Kingdom, Europe, Asia, Australia/NZ or Other) are repeatable.
  • Designers: designers takes a query, with limit.
  • Listings: listing takes an id or a url.
  • Users: user takes a username, with status (for_sale or sold), page and a repeatable include[] (ratings).

The recorded search for "undercover jacket" with designer[]=Undercover, price_max=1500 and sort=newest returns items, each with id, url, title, designers, category, department, size, color, condition, price, sold, location, shipping, likes, buy_now, make_offer, seller (with username, rating and items_bought_and_sold), created_at and price_updated_at. It also returns pagination with total_results (5,060 in that recording), total_pages and has_more.

How a call works

Search a designer: GET /v1/grailed/search?query=undercover jacket&designer[]=Undercover&price_max=1500&sort=newest with your key in the X-API-Key header. Use designers to find a designer's name first. Each result carries an id, which listing takes, and a seller username, which user takes. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track what a designer's pieces sell for with `status=sold`

Use the Grailed API to track what a designer's pieces sell for with `status=sold`

Watch new listings for a designer with `sort=newest`

Use the Grailed API to watch new listings for a designer with `sort=newest`

Compare asking prices by size, condition and location

Use the Grailed API to compare asking prices by size, condition and location

Check a seller's listings and ratings before buying

Use the Grailed API to check a seller's listings and ratings before buying

FAQ

Questions

How much does the Grailed API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I get sold listings?

Yes. Pass `status=sold` to `search` or `user`.

Do I need a Grailed account?

No. You call this Grailed API with your Perceptlayer key in the `X-API-Key` header, with no Grailed login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Grailed scraper instead?

You can, but a Grailed scraper is code you maintain: page changes break it, requests get blocked, and Grailed's terms govern how you collect data. The Grailed API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Grailed API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs