Docs menu

Wallapop API endpoint

Wallapop remote filter options API

Returns one page from a remote option list advertised by /wallapop/filters. Use its exact filter_id and category_id. brand/model lists use a root category ID; category-specific lists use the selected category ID. Model discovery requires brand. Multi-select options such as size map to the live search parameter fashion_size. q and sort provide listing context; options_query narrows the option list. Follow next_cursor while repeating the same context; an empty terminal page has no next_cursor. Option IDs are accepted by /wallapop/search's filter parameter.

GETapiKey2 credits/requestWallapopwallapop.filterOptionsResponseDoc/wallapop/filter-options

Endpoint facts

Method: GET
API path: /wallapop/filter-options
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Wallapop
Response schema: #/definitions/wallapop.filterOptionsResponseDoc

Wallapop Listings API Try Wallapop remote filter options API in Playground Wallapop API documentation

How this endpoint behaves

Returns one page from a remote option list advertised by /wallapop/filters. Use each option's id as the corresponding filter value in /wallapop/search. Remote filter IDs are category-dependent; get the exact filter_id and category context from a filter's options_endpoint.

Parameters

filter_id (required): a remote filter ID from /wallapop/filters (observed examples include brand, model, and category-specific item_language and size).
category_id (required): a live search category ID from /wallapop/categories. Use a root category for brand and model; for category-specific remote lists, use the category ID whose filter definition advertises this endpoint.
brand (required for filter_id=model): a brand option ID from a prior brand response. It is invalid for other filter IDs.
q (optional): listing search context used by Wallapop to scope options.
sort (optional): one of closest, most_relevance, newest, price_low_to_high, price_high_to_low, matching the listing search context.
options_query (optional): search text inside the remote option list, such as BMW, 3, or English. This matches the site's own filter-picker search box.
cursor (optional): next_cursor from the previous options response. Repeat filter_id, category_id, brand, q, sort, and options_query when following it.

options are paginated by Wallapop's own options_page_key; follow next_cursor until it is omitted to enumerate the current option set. Some category-specific lists can produce an empty terminal page because Wallapop emits a redundant upstream cursor; the API omits next_cursor after that empty page. This endpoint does not pin a sample list into the API contract.

The size options use IDs accepted by the fashion_size search parameter and are multi-select. Pass each selected ID in the search filter, for example filter=fashion_size:3,4.

Request parameters

Parameter	Type	Required	Description	Example
filter_id	string	Yes	Remote filter ID advertised by /wallapop/filters for this category	item_language
category_id	integer	Yes	Live category ID from /wallapop/categories. Use a root for brand/model or the selected category for category-specific remote options.	24100
brand	string	No	Required with filter_id=model; a brand option ID	BMW
q	string	No	Optional listing search context	iphone
sort	string	No	Optional listing sort context Allowed values: closest, most_relevance, newest, price_low_to_high, price_high_to_low.	most_relevance
options_query	string	No	Optional text search inside the dynamic option list	BMW
cursor	string	No	Opaque next_cursor returned by this endpoint
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wallapop/filter-options?filter_id=item_language&category_id=24100&q=coffee&sort=closest" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "filter_id": "item_language",
    "category_id": 24100,
    "options": [
      {
        "id": "english",
        "title": "English"
      },
      {
        "id": "spanish",
        "title": "Spanish"
      }
    ],
    "page_size": 45,
    "next_cursor": "opaque-next-cursor"
  }
}

Request schema

No body schema

Response schema

#/definitions/wallapop.filterOptionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wallapop.FilterOptionsResponse	No
data.brand	string	No
data.category_id	integer	No
data.fetched_at	string	No
data.filter_id	string	No
data.next_cursor	string	No
data.options	array	No
data.options[].id	string	No
data.options[].title	string	No
data.options_query	string	No
data.page_size	integer	No
data.q	string	No
data.sort	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/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/wallapop/filter-options?filter_id=item_language&category_id=24100&q=coffee&sort=closest" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Wallapop endpoint docs Wallapop Listings API Wallapop search categories API documentation Wallapop search filter metadata API documentation Wallapop item detail API documentation Wallapop public listing search API documentation

Open in Playground Back to group

Docs menu

Wallapop API endpoint

Wallapop remote filter options API

GETapiKey2 credits/requestWallapopwallapop.filterOptionsResponseDoc/wallapop/filter-options

Endpoint facts

Method: GET
API path: /wallapop/filter-options
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Wallapop
Response schema: #/definitions/wallapop.filterOptionsResponseDoc

Wallapop Listings API Try Wallapop remote filter options API in Playground Wallapop API documentation

How this endpoint behaves

Parameters

filter_id (required): a remote filter ID from /wallapop/filters (observed examples include brand, model, and category-specific item_language and size).
category_id (required): a live search category ID from /wallapop/categories. Use a root category for brand and model; for category-specific remote lists, use the category ID whose filter definition advertises this endpoint.
brand (required for filter_id=model): a brand option ID from a prior brand response. It is invalid for other filter IDs.
q (optional): listing search context used by Wallapop to scope options.
sort (optional): one of closest, most_relevance, newest, price_low_to_high, price_high_to_low, matching the listing search context.
options_query (optional): search text inside the remote option list, such as BMW, 3, or English. This matches the site's own filter-picker search box.
cursor (optional): next_cursor from the previous options response. Repeat filter_id, category_id, brand, q, sort, and options_query when following it.

The size options use IDs accepted by the fashion_size search parameter and are multi-select. Pass each selected ID in the search filter, for example filter=fashion_size:3,4.

Request parameters

Parameter	Type	Required	Description	Example
filter_id	string	Yes	Remote filter ID advertised by /wallapop/filters for this category	item_language
category_id	integer	Yes	Live category ID from /wallapop/categories. Use a root for brand/model or the selected category for category-specific remote options.	24100
brand	string	No	Required with filter_id=model; a brand option ID	BMW
q	string	No	Optional listing search context	iphone
sort	string	No	Optional listing sort context Allowed values: closest, most_relevance, newest, price_low_to_high, price_high_to_low.	most_relevance
options_query	string	No	Optional text search inside the dynamic option list	BMW
cursor	string	No	Opaque next_cursor returned by this endpoint
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wallapop/filter-options?filter_id=item_language&category_id=24100&q=coffee&sort=closest" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "filter_id": "item_language",
    "category_id": 24100,
    "options": [
      {
        "id": "english",
        "title": "English"
      },
      {
        "id": "spanish",
        "title": "Spanish"
      }
    ],
    "page_size": 45,
    "next_cursor": "opaque-next-cursor"
  }
}

Request schema

No body schema

Response schema

#/definitions/wallapop.filterOptionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wallapop.FilterOptionsResponse	No
data.brand	string	No
data.category_id	integer	No
data.fetched_at	string	No
data.filter_id	string	No
data.next_cursor	string	No
data.options	array	No
data.options[].id	string	No
data.options[].title	string	No
data.options_query	string	No
data.page_size	integer	No
data.q	string	No
data.sort	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/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/wallapop/filter-options?filter_id=item_language&category_id=24100&q=coffee&sort=closest" \
  -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

Wallapop remote filter options API

Endpoint facts

How this endpoint behaves

Parameters

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Wallapop remote filter options API

Endpoint facts

How this endpoint behaves

Parameters

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related