Docs menu

Grailed API endpoint

Grailed Search Suggestions API

Returns Grailed's own search-box typeahead suggestions for a partial query -- a flat list of suggested search phrases with a popularity score and live active-listing match count, no listing data. Pass a suggestion straight through to grailed-search/grailed-sold-listings' own q parameter. A query with no genuine matches returns a well-formed empty result rather than an error.

GETapiKey3 credits/requestGrailedgrailed.suggestResponseDoc/grailed/suggest

Endpoint facts

Method: GET
API path: /grailed/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Grailed
Response schema: #/definitions/grailed.suggestResponseDoc

Grailed Scraper API Try Grailed Search Suggestions API in Playground Grailed API documentation

How this endpoint behaves

q is required, a partial search query, up to 100 characters.

Notable response behavior:

suggestions[].query is directly usable as grailed-search/grailed-sold-listings's own q parameter.
suggestions[].total_results is that suggested query's own live active-listing match count on Grailed.
A query with no genuine matches returns a well-formed empty result (suggestions: []) rather than an error.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /grailed/suggest?q=guc
Items in suggestions: 10
Fields filled in every checked item: 2
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
query	10	“gucci” and 9 other values
popularity	10	2,597 to 20,484, median 3,070
total_results	5	2,346 to 202,372, median 10,626

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Partial search query	guc
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/grailed/suggest?q=guc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "guc",
    "suggestions": [
      {
        "query": "gucci",
        "popularity": 89,
        "total_results": 259659
      },
      {
        "query": "gucci hat",
        "popularity": 40,
        "total_results": 4200
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/grailed.suggestResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	grailed.SuggestResponse	No
data.fetched_at	string	No
data.query	string	No
data.suggestions	array	No
data.suggestions[].popularity	integer	No
data.suggestions[].query	string	No
data.suggestions[].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/suggest?q=guc" \
  -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 Grailed Designer Directory API documentation Get a Grailed listing API documentation Grailed Listing Search API documentation

Open in Playground Back to group

Docs menu

Grailed API endpoint

Grailed Search Suggestions API

GETapiKey3 credits/requestGrailedgrailed.suggestResponseDoc/grailed/suggest

Endpoint facts

Method: GET
API path: /grailed/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Grailed
Response schema: #/definitions/grailed.suggestResponseDoc

Grailed Scraper API Try Grailed Search Suggestions API in Playground Grailed API documentation

How this endpoint behaves

q is required, a partial search query, up to 100 characters.

Notable response behavior:

suggestions[].query is directly usable as grailed-search/grailed-sold-listings's own q parameter.
suggestions[].total_results is that suggested query's own live active-listing match count on Grailed.
A query with no genuine matches returns a well-formed empty result (suggestions: []) rather than an error.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /grailed/suggest?q=guc
Items in suggestions: 10
Fields filled in every checked item: 2
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
query	10	“gucci” and 9 other values
popularity	10	2,597 to 20,484, median 3,070
total_results	5	2,346 to 202,372, median 10,626

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Partial search query	guc
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/grailed/suggest?q=guc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "guc",
    "suggestions": [
      {
        "query": "gucci",
        "popularity": 89,
        "total_results": 259659
      },
      {
        "query": "gucci hat",
        "popularity": 40,
        "total_results": 4200
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/grailed.suggestResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	grailed.SuggestResponse	No
data.fetched_at	string	No
data.query	string	No
data.suggestions	array	No
data.suggestions[].popularity	integer	No
data.suggestions[].query	string	No
data.suggestions[].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/suggest?q=guc" \
  -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 Search Suggestions 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 Search Suggestions 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