Docs menu

Depop API endpoint

Depop search facets API

Returns result-count breakdowns per department/category/subcategory for a search query, via Depop's dedicated aggregates API -- a distinct upstream call from search itself, not embedded in its response. Public data sourced from Depop's own search-aggregates API.

GETapiKey3 credits/requestDepopdepop.searchFacetsResponseDoc/depop/search/facets

Endpoint facts

Method: GET
API path: /depop/search/facets
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.searchFacetsResponseDoc

Depop Scraper API Try Depop search facets API in Playground Depop API documentation

How this endpoint behaves

Query parameters:

query (required) — free-text keyword search, same value you'd pass to /depop/search.

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.
departments is sorted alphabetically by department name; each department's categories/subcategories are sorted alphabetically by id for a deterministic order.
categories/subcategories are already department-scoped — unlike /depop/search's own category/subcategory filters, which apply across all departments, a facet's count here only covers listings within that specific department.
subcategories are omitted (not an empty array) for a department with no subcategory breakdown in the upstream response.
A missing query returns 400 before any upstream request is made.

Sampled response

Request, 14 Oct 2026: GET /depop/search/facets?query=bandage+dress
Items in departments: 4
Fields filled in every checked item: 2
Fields empty in some or all items: 2

Field	Filled in, of 4 checked	Values in the sample
department	4	“everything_else” and 3 other values
count	4	37 to 27,079, median 72
categories	3	median 10 entries
subcategories	3	median 26 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Free-text keyword search	bandage dress
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/depop/search/facets?query=bandage+dress" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "bandage dress",
    "departments": [
      {
        "department": "menswear",
        "count": 39,
        "categories": [
          {
            "id": "coats-jackets",
            "count": 4
          },
          {
            "id": "fancy-dress",
            "count": 14
          },
          {
            "id": "tops",
            "count": 12
          }
        ],
        "subcategories": [
          {
            "id": "jackets",
            "count": 4
          },
          {
            "id": "tshirts",
            "count": 5
          }
        ]
      },
      {
        "department": "womenswear",
        "count": 23744,
        "categories": [
          {
            "id": "dresses",
            "count": 22504
          },
          {
            "id": "tops",
            "count": 509
          }
        ],
        "subcategories": [
          {
            "id": "shift-dresses",
            "count": 22
          },
          {
            "id": "wedding-dresses",
            "count": 7
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/depop.searchFacetsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	depop.SearchFacetsResponse	No
data.departments	array	No
data.departments[].categories	array	No
data.departments[].categories[].count	integer	No
data.departments[].categories[].id	string	No
data.departments[].count	integer	No
data.departments[].department	string	No
data.departments[].subcategories	array	No
data.departments[].subcategories[].count	integer	No
data.departments[].subcategories[].id	string	No
data.query	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/search/facets?query=bandage+dress" \
  -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 search facets API

GETapiKey3 credits/requestDepopdepop.searchFacetsResponseDoc/depop/search/facets

Endpoint facts

Method: GET
API path: /depop/search/facets
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.searchFacetsResponseDoc

Depop Scraper API Try Depop search facets API in Playground Depop API documentation

How this endpoint behaves

Query parameters:

query (required) — free-text keyword search, same value you'd pass to /depop/search.

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.
departments is sorted alphabetically by department name; each department's categories/subcategories are sorted alphabetically by id for a deterministic order.
categories/subcategories are already department-scoped — unlike /depop/search's own category/subcategory filters, which apply across all departments, a facet's count here only covers listings within that specific department.
subcategories are omitted (not an empty array) for a department with no subcategory breakdown in the upstream response.
A missing query returns 400 before any upstream request is made.

Sampled response

Request, 14 Oct 2026: GET /depop/search/facets?query=bandage+dress
Items in departments: 4
Fields filled in every checked item: 2
Fields empty in some or all items: 2

Field	Filled in, of 4 checked	Values in the sample
department	4	“everything_else” and 3 other values
count	4	37 to 27,079, median 72
categories	3	median 10 entries
subcategories	3	median 26 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Free-text keyword search	bandage dress
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/depop/search/facets?query=bandage+dress" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "bandage dress",
    "departments": [
      {
        "department": "menswear",
        "count": 39,
        "categories": [
          {
            "id": "coats-jackets",
            "count": 4
          },
          {
            "id": "fancy-dress",
            "count": 14
          },
          {
            "id": "tops",
            "count": 12
          }
        ],
        "subcategories": [
          {
            "id": "jackets",
            "count": 4
          },
          {
            "id": "tshirts",
            "count": 5
          }
        ]
      },
      {
        "department": "womenswear",
        "count": 23744,
        "categories": [
          {
            "id": "dresses",
            "count": 22504
          },
          {
            "id": "tops",
            "count": 509
          }
        ],
        "subcategories": [
          {
            "id": "shift-dresses",
            "count": 22
          },
          {
            "id": "wedding-dresses",
            "count": 7
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/depop.searchFacetsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	depop.SearchFacetsResponse	No
data.departments	array	No
data.departments[].categories	array	No
data.departments[].categories[].count	integer	No
data.departments[].categories[].id	string	No
data.departments[].count	integer	No
data.departments[].department	string	No
data.departments[].subcategories	array	No
data.departments[].subcategories[].count	integer	No
data.departments[].subcategories[].id	string	No
data.query	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/search/facets?query=bandage+dress" \
  -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 search facets API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Depop search facets API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related