Docs menu

Depop API endpoint

Depop suggest API

Returns Depop's own search-box autocomplete suggestions for a partial query, including the category a suggestion maps to when relevant. Public data sourced from Depop's own search-suggestions API.

GETapiKey3 credits/requestDepopdepop.suggestResponseDoc/depop/suggest

Endpoint facts

Method: GET
API path: /depop/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Depop
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/depop.suggestResponseDoc

Depop Scraper API Try Depop suggest API in Playground Depop API documentation

How this endpoint behaves

Query parameters:

query (required) — partial search query to autocomplete.

Notable response behavior:

Depop's JSON API sits behind a stricter bot-protection tier than its product pages. Calls first try a fast direct request and then fall back to a rendered browser fetch, so responses can take 20-60 seconds; 503 means both paths were blocked. Retry later.
value is the suggested phrase with Depop's own bold-match markup stripped (the upstream API wraps the substring matching query in **...** for highlighting; this endpoint returns the plain text).
group, suggested_filter_label, and gender are present when the suggestion maps to a specific Depop category/department (e.g. group tops, suggested_filter_label "in Women's Tops", gender female) — all three omitted for a plain free-text suggestion with no category match.
A missing query returns 400 before any upstream request is made.
Suggestions with no results return 200 with "suggestions": [].

Sampled response

Request, 14 Oct 2026: GET /depop/suggest?query=red+corte
Items in suggestions: 7
Fields filled in every checked item: 1
Fields empty in some or all items: 3

Field	Filled in, of 7 checked	Values in the sample
value	7	“red corset” and 4 other values
group	2	“tops” and 1 other value
suggested_filter_label	2	“in Women's Tops” and 1 other value
gender	2

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Partial search query to autocomplete	red corte
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/depop/suggest?query=red+corte" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "red corte",
    "suggestions": [
      {
        "value": "red corset",
        "group": "tops",
        "suggested_filter_label": "in Women's Tops",
        "gender": "female"
      },
      {
        "value": "red corset"
      },
      {
        "value": "red corset top"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/depop.suggestResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	depop.SuggestResponse	No
data.query	string	No
data.suggestions	array	No
data.suggestions[].gender	string	No
data.suggestions[].group	string	No		Group and SuggestedFilterLabel are present when the suggestion maps to a specific category (e.g. Group "tops", SuggestedFilterLabel "in Women's Tops") -- both omitted for a plain free-text suggestion.
data.suggestions[].suggested_filter_label	string	No
data.suggestions[].value	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/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/depop/suggest?query=red+corte" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Depop endpoint docs Depop Scraper API Depop brands API documentation Depop categories API documentation Depop item API documentation Depop item similar API documentation Depop search sellers API documentation Depop search API documentation

Open in Playground Back to group

Docs menu

Depop API endpoint

Depop suggest API

Returns Depop's own search-box autocomplete suggestions for a partial query, including the category a suggestion maps to when relevant. Public data sourced from Depop's own search-suggestions API.

GETapiKey3 credits/requestDepopdepop.suggestResponseDoc/depop/suggest

Endpoint facts

Method: GET
API path: /depop/suggest
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Depop
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/depop.suggestResponseDoc

Depop Scraper API Try Depop suggest API in Playground Depop API documentation

How this endpoint behaves

Query parameters:

query (required) — partial search query to autocomplete.

Notable response behavior:

Depop's JSON API sits behind a stricter bot-protection tier than its product pages. Calls first try a fast direct request and then fall back to a rendered browser fetch, so responses can take 20-60 seconds; 503 means both paths were blocked. Retry later.
value is the suggested phrase with Depop's own bold-match markup stripped (the upstream API wraps the substring matching query in **...** for highlighting; this endpoint returns the plain text).
group, suggested_filter_label, and gender are present when the suggestion maps to a specific Depop category/department (e.g. group tops, suggested_filter_label "in Women's Tops", gender female) — all three omitted for a plain free-text suggestion with no category match.
A missing query returns 400 before any upstream request is made.
Suggestions with no results return 200 with "suggestions": [].

Sampled response

Request, 14 Oct 2026: GET /depop/suggest?query=red+corte
Items in suggestions: 7
Fields filled in every checked item: 1
Fields empty in some or all items: 3

Field	Filled in, of 7 checked	Values in the sample
value	7	“red corset” and 4 other values
group	2	“tops” and 1 other value
suggested_filter_label	2	“in Women's Tops” and 1 other value
gender	2

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Partial search query to autocomplete	red corte
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/depop/suggest?query=red+corte" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "red corte",
    "suggestions": [
      {
        "value": "red corset",
        "group": "tops",
        "suggested_filter_label": "in Women's Tops",
        "gender": "female"
      },
      {
        "value": "red corset"
      },
      {
        "value": "red corset top"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/depop.suggestResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	depop.SuggestResponse	No
data.query	string	No
data.suggestions	array	No
data.suggestions[].gender	string	No
data.suggestions[].group	string	No		Group and SuggestedFilterLabel are present when the suggestion maps to a specific category (e.g. Group "tops", SuggestedFilterLabel "in Women's Tops") -- both omitted for a plain free-text suggestion.
data.suggestions[].suggested_filter_label	string	No
data.suggestions[].value	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/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/depop/suggest?query=red+corte" \
  -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

Depop suggest API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Depop suggest API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related