--- title: "Grailed API: JSON data, 4 endpoints, 1 credit per call" description: "Grailed API for listing search by designer, size and condition, sold listings, listing details, users and designers as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/grailed --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Grailed 1 credit per call 4 endpoints 27 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | title string | designers object\[\] | category string | category\_path string | department string | size string | color string | condition object | price object | pricing object | sold boolean | location string | shipping object | cover\_photo object | photo\_count integer | measurement\_count integer | likes integer | buy\_now boolean | make\_offer boolean | market string | traits object\[\] | seller object | created\_at string | bumped\_at string | price\_updated\_at string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 112096050 | https://www.grailed.com/listings/112096050 | Sz 2 Undercover 15AW Ghost Hand Coat mojos13491027 | \[1 item\] | outerwear | outerwear.heavy\_coats | menswear | m | black | {2 fields} | {2 fields} | {1 fields} | false | Asia | {7 fields} | {3 fields} | 7 | 0 | 0 | true | true | grailed | \[2 items\] | {6 fields} | 2026-11-12T11:14:32.574Z | 2026-11-12T11:14:24.537Z | 2026-11-12T11:14:32.574Z | | 2 | 112094581 | https://www.grailed.com/listings/112094581 | Vintage Japanese Brand DAILY TOPICS Chore Denim Jacket | \[2 items\] | outerwear | outerwear.denim\_jackets | menswear | m | blue | {2 fields} | {2 fields} | {1 fields} | false | Asia | {7 fields} | {3 fields} | 14 | 4 | 6 | true | true | grailed | \[2 items\] | {6 fields} | 2026-11-12T10:44:22.218Z | 2026-11-12T10:44:22.218Z | 2026-11-12T10:44:22.218Z | | 3 | 112083095 | https://www.grailed.com/listings/112083095 | AW16 Jacket | \[1 item\] | outerwear | outerwear.heavy\_coats | menswear | l | blue | {2 fields} | {2 fields} | {1 fields} | false | Asia | {7 fields} | {3 fields} | 8 | 4 | 0 | true | true | grailed | \[1 item\] | {6 fields} | 2026-11-12T07:20:47.451Z | 2026-11-12T07:20:37.145Z | 2026-11-12T07:20:47.451Z | Recorded from our API · 3 items shown · 27 datapoints per item GET /v1/grailed/search?query=undercover+jacket&designer\[\]=Undercover&price\_max=1500&sort=newest 27 datapoints ### Identity - id integer - title string - category string - category\_path string ### Contact - url url - seller object ### Location - location string ### Reputation - cover\_photo object - photo\_count integer ### Price - price object - price\_updated\_at string ### Other - designers object\[\] - department string - size string - color string - condition object - pricing object - sold boolean - shipping object - measurement\_count integer - likes integer - buy\_now boolean - make\_offer boolean - market string - traits object\[\] - created\_at string - bumped\_at string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/grailed/designers`](https://perceptlayer.com/apis/grailed/designers) | `query` +1 optional | 1 credit | | [GET `/v1/grailed/listing`](https://perceptlayer.com/apis/grailed/listing) | none +2 optional | 1 credit | | [GET `/v1/grailed/search`](https://perceptlayer.com/apis/grailed/search) | none +12 optional | 1 credit | | [GET `/v1/grailed/user`](https://perceptlayer.com/apis/grailed/user) | `username` +3 optional | 1 credit | Overview ## About the Grailed API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)