Docs menu

Grailed API endpoint

Grailed Designer Directory API

Returns a page of Grailed's full designer/brand taxonomy (7,363 designers as of 2026-09-09) -- the value space grailed-search/grailed-sold-listings' own designer parameter accepts (by name). q is an optional free-text filter (typo-tolerant, e.g. a partial name for typeahead-style lookup); an empty q lists the full taxonomy ordered by Grailed's own default ranking (most-listed designers first).

GETapiKey1 credit/requestGrailedgrailed.designersResponseDoc/grailed/designers

Endpoint facts

Method: GET
API path: /grailed/designers
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Grailed
Response schema: #/definitions/grailed.designersResponseDoc

Grailed Scraper API Try Grailed Designer Directory API in Playground Grailed API documentation

How this endpoint behaves

page is optional, a one-based page number, defaults to 1.

limit is optional, results per page, defaults to 24, maximum 100.

Notable response behavior:

designers[].name is exactly the value grailed-search/grailed-sold-listings's own designer parameter expects.
listings_count is that designer's own live count of listings on Grailed (active and sold combined).
departments lists which of menswear/womenswear the designer has listings in.

Live monitoring

Monitored request: GET /grailed/designers?q=gucci
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.68 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /grailed/designers?q=gucci&limit=24
Items in designers: 2
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
id	2
name	2	“Gucci” and 1 other value
slug	2
listings_count	2	809 to 114,297, median 809
departments	2	median 2 entries
logo_url	1	media-assets.grailed.com

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	No		Free-text designer name filter	gucci
page	integer	No	1	One-based page number, defaults to 1	1
limit	integer	No	24	Results per page, defaults to 24, maximum 100	24
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/grailed/designers?q=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "gucci",
    "page": 1,
    "limit": 24,
    "count": 1,
    "total_results": 7363,
    "total_pages": 307,
    "designers": [
      {
        "id": 79,
        "name": "Gucci",
        "slug": "gucci",
        "listings_count": 250601,
        "departments": [
          "menswear",
          "womenswear"
        ],
        "logo_url": "https://media-assets.grailed.com/prd/detail-page/gucci-logo"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/grailed.designersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	grailed.DesignersResponse	No
data.count	integer	No
data.designers	array	No
data.designers[].departments	array	No
data.designers[].id	integer	No
data.designers[].listings_count	integer	No
data.designers[].logo_url	string	No
data.designers[].name	string	No
data.designers[].slug	string	No
data.fetched_at	string	No
data.limit	integer	No
data.page	integer	No
data.query	string	No
data.source_url	string	No
data.total_pages	integer	No
data.total_results	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/grailed/designers?q=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Grailed endpoint docs Grailed Scraper API List Grailed's facet taxonomy API documentation Grailed Collection Listings API documentation Grailed Collections API documentation Get a Grailed listing API documentation Grailed Listing Search API documentation Grailed Seller Reviews API documentation

Open in Playground Back to group

Docs menu

Grailed API endpoint

Grailed Designer Directory API

GETapiKey1 credit/requestGrailedgrailed.designersResponseDoc/grailed/designers

Endpoint facts

Method: GET
API path: /grailed/designers
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Grailed
Response schema: #/definitions/grailed.designersResponseDoc

Grailed Scraper API Try Grailed Designer Directory API in Playground Grailed API documentation

How this endpoint behaves

page is optional, a one-based page number, defaults to 1.

limit is optional, results per page, defaults to 24, maximum 100.

Notable response behavior:

designers[].name is exactly the value grailed-search/grailed-sold-listings's own designer parameter expects.
listings_count is that designer's own live count of listings on Grailed (active and sold combined).
departments lists which of menswear/womenswear the designer has listings in.

Live monitoring

Monitored request: GET /grailed/designers?q=gucci
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.68 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /grailed/designers?q=gucci&limit=24
Items in designers: 2
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
id	2
name	2	“Gucci” and 1 other value
slug	2
listings_count	2	809 to 114,297, median 809
departments	2	median 2 entries
logo_url	1	media-assets.grailed.com

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	No		Free-text designer name filter	gucci
page	integer	No	1	One-based page number, defaults to 1	1
limit	integer	No	24	Results per page, defaults to 24, maximum 100	24
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/grailed/designers?q=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "gucci",
    "page": 1,
    "limit": 24,
    "count": 1,
    "total_results": 7363,
    "total_pages": 307,
    "designers": [
      {
        "id": 79,
        "name": "Gucci",
        "slug": "gucci",
        "listings_count": 250601,
        "departments": [
          "menswear",
          "womenswear"
        ],
        "logo_url": "https://media-assets.grailed.com/prd/detail-page/gucci-logo"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/grailed.designersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	grailed.DesignersResponse	No
data.count	integer	No
data.designers	array	No
data.designers[].departments	array	No
data.designers[].id	integer	No
data.designers[].listings_count	integer	No
data.designers[].logo_url	string	No
data.designers[].name	string	No
data.designers[].slug	string	No
data.fetched_at	string	No
data.limit	integer	No
data.page	integer	No
data.query	string	No
data.source_url	string	No
data.total_pages	integer	No
data.total_results	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/grailed/designers?q=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Grailed Designer Directory API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Grailed Designer Directory API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related