# Wallapop Product Search (`alvaraaz/wallapop-product-search`) Actor

Wallapop Scraper extracts product listings from the Spain's leading second-hand marketplace. Fetch prices, descriptions, images, locations and filter by keyword, category, province, price, condition.

- **URL**: https://apify.com/alvaraaz/wallapop-product-search.md
- **Developed by:** [Jose Fernando Álvarez Romero](https://apify.com/alvaraaz) (community)
- **Categories:** Automation, E-commerce, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Wallapop Product Scraper

![Apify](https://img.shields.io/badge/Apify-Actor-blue)
![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)
![Bun](https://img.shields.io/badge/Bun-1.0+-yellow)
![API](https://img.shields.io/badge/Wallapop-API-green)
![Zod](https://img.shields.io/badge/Zod-Schema%20Validation-purple)

**Last updated: 30 March 2026** | [Apify Platform](https://apify.com) | [Documentation](https://docs.apify.com)

---

### What is Wallapop Product Scraper?

Wallapop Product Scraper is an [Apify Actor](https://apify.com) that extracts product listings from Wallapop, a popular Spanish marketplace for second-hand items. It uses the official Wallapop API to retrieve product titles, prices, images, locations, and shipping availability information.

This tool is designed for e-commerce researchers, price comparison analysts, developers, and businesses that need to collect Wallapop product data programmatically. It efficiently collects up to 40 products per API request with pagination support.

---

### Quick Start

1. Open on [Apify Console](https://console.apify.com)
2. Enter your search keyword
3. Click **Run**
4. Download results from the **Dataset** tab

```json
{
  "keyword": "iphone",
  "orderBy": "newest",
  "maxResults": 200
}
````

***

### Input Parameters

| Parameter        | Type    | Required | Default        | Description                                                                                       |
| ---------------- | ------- | -------- | -------------- | ------------------------------------------------------------------------------------------------- |
| `keyword`        | string  | Yes      | -              | Search keyword for Wallapop products                                                              |
| `location`       | string  | No       | -              | Province coordinates (latitude,longitude) for local results, e.g., "41.3851,2.1734" for Barcelona |
| `category`       | string  | No       | -              | Category ID (e.g., 12800 for móviles, 24200 for tecnología)                                       |
| `subcategory`    | string  | No       | -              | Subcategory ID (requires category to be selected)                                                 |
| `orderBy`        | string  | No       | most\_relevance | Sort order: newest, price\_low\_to\_high, price\_high\_to\_low, most\_relevance, closest                 |
| `condition`      | string  | No       | -              | Filter by condition: un\_opened, new, as\_good\_as\_new, good, fair, has\_given\_it\_all                 |
| `publishedSince` | string  | No       | -              | Filter by publish date: today, lastWeek, lastMonth                                                |
| `shipOnly`       | boolean | No       | false          | Show only items with shipping available (Envío disponible)                                        |
| `minPrice`       | integer | No       | -              | Minimum price in euros                                                                            |
| `maxPrice`       | integer | No       | -              | Maximum price in euros                                                                            |
| `maxResults`     | integer | No       | 120            | Maximum products to retrieve (minimum 40, maximum 10000)                                          |

***

### Output Example

```json
{
  "id": "pj94qq340v6e",
  "userId": "vjrdxnwko46k",
  "title": "iPhone 11 128GB Negro",
  "description": "Teléfono móvil iPhone 11 en color negro...",
  "categoryId": 24200,
  "price": 125,
  "currency": "EUR",
  "imageUrl": "https://cdn.wallapop.com/images/10420/km/3x/__/c10420p1246458561/i6395530780.jpg?pictureSize=W800",
  "images": [
    {
      "id": "qzm9pny8x9y6",
      "averageColor": "13C1AC",
      "urls": {
        "small": "https://cdn.wallapop.com/...",
        "medium": "https://cdn.wallapop.com/...",
        "big": "https://cdn.wallapop.com/..."
      }
    },
    { "id": "xzol70rqm87z", "urls": {...} },
    { "id": "ejkx5rkq7xy6", "urls": {...} },
    { "id": "wmpn5slq8yz5", "urls": {...} },
    { "id": "klnm4rjs9zxa", "urls": {...} },
    { "id": "lomp3oika0wy", "urls": {...} }
  ],
  "productUrl": "https://es.wallapop.com/item/iphone-11-128gb-negro-pj94qq340v6e",
  "location": {
    "latitude": 40.416775,
    "longitude": -3.70379,
    "postalCode": "28013",
    "city": "Madrid",
    "region": "Comunidad de Madrid",
    "region2": "Madrid",
    "countryCode": "ES"
  },
  "shipping": {
    "itemIsShippable": true,
    "userAllowsShipping": false
  },
  "reserved": { "flag": false },
  "favorited": { "flag": false },
  "bump": { "type": "city" },
  "webSlug": "iphone-11-128gb-negro-pj94qq340v6e",
  "createdAt": 1774793921401,
  "modifiedAt": 1774800470626,
  "taxonomy": [
    { "id": 24200, "name": "Tecnología y electrónica", "icon": "robot" },
    { "id": 24201, "name": "Telefonía: móviles y smartwatches", "icon": null },
    { "id": 9447, "name": "Smartphones", "icon": null }
  ],
  "isFavoriteable": { "flag": true },
  "isRefurbished": { "flag": false },
  "isTopProfile": { "flag": false },
  "hasWarranty": { "flag": false }
}
```

#### Output Fields

| Field                         | Type     | Description                                |
| ----------------------------- | -------- | ------------------------------------------ |
| `id`                          | string   | Unique product identifier                  |
| `userId`                      | string   | Seller identifier                          |
| `title`                       | string   | Product title                              |
| `description`                 | string?  | Product description                        |
| `categoryId`                  | number   | Category identifier                        |
| `price`                       | number   | Product price in EUR                       |
| `currency`                    | string   | Currency code (EUR)                        |
| `imageUrl`                    | string   | Primary product image URL (big size)       |
| `images`                      | array?   | All product images (6 images typically)    |
| `images[].id`                 | string   | Image identifier                           |
| `images[].averageColor`       | string?  | Average color of the image                 |
| `images[].urls`               | object   | Image URLs for different sizes             |
| `images[].urls.small`         | string?  | Small size (320px)                         |
| `images[].urls.medium`        | string?  | Medium size (640px)                        |
| `images[].urls.big`           | string?  | Big size (800px)                           |
| `productUrl`                  | string   | Full URL to Wallapop product page          |
| `location`                    | object?  | Seller's location details                  |
| `location.latitude`           | number   | Location latitude                          |
| `location.longitude`          | number   | Location longitude                         |
| `location.postalCode`         | string?  | Postal code                                |
| `location.city`               | string?  | City name                                  |
| `location.region`             | string?  | Region name                                |
| `location.region2`            | string?  | Secondary region name                      |
| `location.countryCode`        | string?  | Country code                               |
| `shipping`                    | object?  | Shipping options                           |
| `shipping.itemIsShippable`    | boolean? | Item can be shipped                        |
| `shipping.userAllowsShipping` | boolean? | Seller allows shipping                     |
| `reserved`                    | object?  | Reserved status: `{ flag: boolean }`       |
| `favorited`                   | object?  | Favorited status: `{ flag: boolean }`      |
| `bump`                        | object?  | Bump info: `{ type: string }`              |
| `webSlug`                     | string?  | URL-friendly slug                          |
| `createdAt`                   | number?  | Unix timestamp when listing created        |
| `modifiedAt`                  | number?  | Unix timestamp when listing modified       |
| `taxonomy`                    | array?   | Category hierarchy (3 levels)              |
| `taxonomy[].id`               | number   | Category ID                                |
| `taxonomy[].name`             | string   | Category name                              |
| `taxonomy[].icon`             | string?  | Category icon                              |
| `isFavoriteable`              | object?  | Can be favorited: `{ flag: boolean }`      |
| `isRefurbished`               | object?  | Is refurbished: `{ flag: boolean }`        |
| `isTopProfile`                | object?  | Seller is top profile: `{ flag: boolean }` |
| `hasWarranty`                 | object?  | Has warranty: `{ flag: boolean }`          |

***

### Features

| Feature                  | Description                                                             |
| ------------------------ | ----------------------------------------------------------------------- |
| **Product Extraction**   | Full product data: title, description, price, images, location, seller  |
| **API-Based**            | Uses official Wallapop API for reliable data extraction                 |
| **Shipping Detection**   | Identifies products with "Envío disponible"                             |
| **Multiple Images**      | Extracts all product images with different sizes                        |
| **Location Details**     | Full location data: city, region, postal code, coordinates              |
| **Pagination**           | Automatically fetches multiple pages (40 products per page)             |
| **Multiple Sort Orders** | newest, price\_low\_to\_high, price\_high\_to\_low, most\_relevance, closest   |
| **Location Filter**      | Search by province with coordinates for localized results               |
| **Condition Filter**     | Filter by: un\_opened, new, as\_good\_as\_new, good, fair, has\_given\_it\_all |
| **Price Filter**         | Filter by minimum and maximum price in euros                            |
| **Shipping Filter**      | Filter by shipping availability (Envío disponible)                      |
| **Data Validation**      | Zod schemas ensure structured output                                    |
| **Product Status**       | Tracks reserved, bumped, favorited status                               |
| **Seller Info**          | Seller ID and top profile indicator                                     |
| **Category Taxonomy**    | Full category hierarchy from API                                        |

***

### Use Cases

#### Market Research

```json
{
  "keyword": "iphone",
  "orderBy": "newest",
  "maxResults": 500
}
```

Analyze pricing trends, product availability, and market demand for specific categories.

#### Price Comparison

```json
{
  "keyword": "macbook air",
  "orderBy": "price_low_to_high",
  "maxResults": 200
}
```

Compare prices across multiple listings to find the best deals.

#### Local Search

```json
{
  "keyword": "bicicleta",
  "location": "41.3851,2.1734",
  "orderBy": "closest",
  "maxResults": 100
}
```

Find products near Barcelona (or any other province with coordinates).

#### Inventory Monitoring

```json
{
  "keyword": "playstation 5",
  "location": "40.4168,-3.7038",
  "orderBy": "closest",
  "maxResults": 100
}
```

Track available inventory for high-demand products in your area.

***

### Comparison: Wallapop Scraper vs. Other Methods

| Feature     | This Actor           | Manual Search     | Web Scraping       |
| ----------- | -------------------- | ----------------- | ------------------ |
| Cost        | $0.002 per product   | Free (labor cost) | Variable           |
| Speed       | 1000+ products/min   | 1 product/min     | 20-40 products/min |
| Reliability | API (stable)         | N/A               | DOM-dependent      |
| Data depth  | Full product details | Limited           | Often limited      |
| Shipping    | Yes (boolean)        | Manual check      | Sometimes          |
| Location    | Yes (with proximity) | Manual check      | Sometimes          |
| Data format | Clean JSON           | Copy-paste        | Varies             |

***

### Tech Stack

- [**Apify SDK**](https://docs.apify.com/sdk) — Actor platform for cloud execution
- [**Bun**](https://bun.sh/) — JavaScript runtime for fast performance
- [**Wallapop API**](https://api.wallapop.com) — Official marketplace API
- [**TypeScript**](https://www.typescriptlang.org/) — Type safety and better developer experience
- [**Zod**](https://zod.dev/) — Schema validation for data integrity

***

### Frequently Asked Questions

#### How does this scraper work?

The actor uses the official Wallapop API (`api.wallapop.com/api/v3/search`) to query product listings. It sends HTTP requests with the search parameters and parses the JSON response. Pagination is handled automatically by following the `next_page` token returned by the API.

#### Is this legal?

This tool uses Wallapop's public API to retrieve product listings. It should be used for legitimate data collection purposes only. Ensure compliance with Wallapop's Terms of Service. This is not affiliated with Wallapop.

#### How many products can I collect?

The `maxResults` parameter allows you to set a limit between 40 and 10000. The default is 120 products. The API returns 40 products per request, so larger result sets require multiple API calls.

#### Does this work with private seller accounts?

The API accesses public product listings only. Private seller information is not accessible.

#### How fast is the actor?

The actor processes approximately 1000+ products per minute, depending on network speed and API response times. Each page request returns 40 products.

#### What provinces are available for location search?

The input schema includes all 50 Spanish provinces with their coordinates. Select a province from the dropdown to search for products near that location. Use "closest" as the orderBy to get products nearest to the coordinates.

***

### Related Tools

- [Wallapop](https://es.wallapop.com) — Official Wallapop website
- [Apify Platform](https://apify.com) — Actor hosting platform
- [Apify SDK Documentation](https://docs.apify.com) — Actor development

***

### Pricing

This actor supports pay-per-event pricing. Each scraped product charges for the event (configured as `products` event).

***

### Legal Notice

This tool is for legitimate data collection purposes only. Ensure compliance with Wallapop's Terms of Service. This tool is not affiliated with, endorsed by, or connected to Wallapop.

# Actor input Schema

## `keyword` (type: `string`):

Keyword to search for products on Wallapop

## `location` (type: `string`):

Province to search in (uses coordinates for local results)

## `category` (type: `string`):

Category to search in

## `subcategory` (type: `string`):

Subcategory to search in (requires category to be selected)

## `orderBy` (type: `string`):

How to order the results

## `condition` (type: `string`):

Filter by product condition

## `publishedSince` (type: `string`):

Filter by when the item was published

## `shipOnly` (type: `boolean`):

Show only items with shipping available (Envío disponible)

## `minPrice` (type: `integer`):

Minimum price in euros

## `maxPrice` (type: `integer`):

Maximum price in euros

## `maxResults` (type: `integer`):

Maximum number of products to retrieve (40-10000)

## Actor input object example

```json
{
  "keyword": "iphone",
  "location": "",
  "category": "",
  "subcategory": "",
  "orderBy": "most_relevance",
  "condition": "",
  "shipOnly": false,
  "maxResults": 120
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keyword": "iphone"
};

// Run the Actor and wait for it to finish
const run = await client.actor("alvaraaz/wallapop-product-search").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keyword": "iphone" }

# Run the Actor and wait for it to finish
run = client.actor("alvaraaz/wallapop-product-search").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keyword": "iphone"
}' |
apify call alvaraaz/wallapop-product-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=alvaraaz/wallapop-product-search",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Wallapop Product Search",
        "description": "Wallapop Scraper extracts product listings from the Spain's leading second-hand marketplace. Fetch prices, descriptions, images, locations and filter by keyword, category, province, price, condition.",
        "version": "0.0",
        "x-build-id": "QnOanEq6L0FdJb3AA"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/alvaraaz~wallapop-product-search/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-alvaraaz-wallapop-product-search",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/alvaraaz~wallapop-product-search/runs": {
            "post": {
                "operationId": "runs-sync-alvaraaz-wallapop-product-search",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/alvaraaz~wallapop-product-search/run-sync": {
            "post": {
                "operationId": "run-sync-alvaraaz-wallapop-product-search",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "keyword"
                ],
                "properties": {
                    "keyword": {
                        "title": "Search Keyword",
                        "minLength": 1,
                        "type": "string",
                        "description": "Keyword to search for products on Wallapop"
                    },
                    "location": {
                        "title": "Location",
                        "enum": [
                            "",
                            "40.4168,-3.7038",
                            "43.3623,-8.3963",
                            "38.3452,-0.4831",
                            "36.5271,-6.2886",
                            "37.3891,-5.9845",
                            "41.3851,2.1734",
                            "43.2630,-2.9350",
                            "37.7642,-3.7900",
                            "40.5428,-4.9315",
                            "42.5987,-5.5701",
                            "37.2614,-6.9447",
                            "39.4699,-0.3763",
                            "36.7213,-4.4214",
                            "42.8125,-1.6458",
                            "37.9834,-1.1301",
                            "43.3603,-5.8448",
                            "41.6528,-4.7236",
                            "40.9429,-4.1084",
                            "42.4631,-2.4450",
                            "41.6488,-0.8891",
                            "41.1189,1.2449",
                            "41.6176,0.6203",
                            "41.9794,2.8134",
                            "37.1773,-3.5986",
                            "38.8783,-6.9703",
                            "39.4765,-6.3722",
                            "42.3439,-3.6969",
                            "43.0121,-7.5558",
                            "42.3359,-7.8652",
                            "40.6319,-3.1663",
                            "40.0681,-2.1348",
                            "38.9942,-1.8588",
                            "38.9862,-3.9291",
                            "37.8845,-4.7796",
                            "41.7637,-2.4689",
                            "41.5033,-5.5766",
                            "42.0096,-4.5240",
                            "40.3457,-1.1147",
                            "39.8628,-4.0273",
                            "42.8782,-8.5448",
                            "43.4623,-3.8099",
                            "36.5101,-4.8826",
                            "38.2622,-0.6981",
                            "38.9667,-0.1833",
                            "36.8340,-2.4637",
                            "37.6257,-0.9930",
                            "39.9864,-0.0513",
                            "42.8467,-2.6726",
                            "28.1235,-15.4363",
                            "28.2916,-16.6291",
                            "42.1365,-0.4083"
                        ],
                        "type": "string",
                        "description": "Province to search in (uses coordinates for local results)",
                        "default": ""
                    },
                    "category": {
                        "title": "Category",
                        "enum": [
                            "",
                            "100",
                            "14000",
                            "12800",
                            "12465",
                            "200",
                            "24200",
                            "12579",
                            "17000",
                            "12467",
                            "13100",
                            "12463",
                            "12461",
                            "18000",
                            "19000",
                            "20000",
                            "21000",
                            "13200",
                            "12485"
                        ],
                        "type": "string",
                        "description": "Category to search in",
                        "default": ""
                    },
                    "subcategory": {
                        "title": "Subcategory",
                        "enum": [
                            "",
                            "10167",
                            "10164",
                            "10165",
                            "10168",
                            "10166",
                            "11002",
                            "11003",
                            "10436",
                            "10156",
                            "10437",
                            "10206",
                            "24149",
                            "10200",
                            "24201",
                            "24202",
                            "24203",
                            "10125",
                            "10120",
                            "10122",
                            "10124",
                            "10118",
                            "10081",
                            "10082",
                            "10083",
                            "10084",
                            "10085",
                            "10086",
                            "10450",
                            "10451",
                            "10452",
                            "10453",
                            "10454",
                            "10420",
                            "10421",
                            "10422",
                            "10008"
                        ],
                        "type": "string",
                        "description": "Subcategory to search in (requires category to be selected)",
                        "default": ""
                    },
                    "orderBy": {
                        "title": "Order By",
                        "enum": [
                            "newest",
                            "price_low_to_high",
                            "price_high_to_low",
                            "most_relevance",
                            "closest"
                        ],
                        "type": "string",
                        "description": "How to order the results",
                        "default": "most_relevance"
                    },
                    "condition": {
                        "title": "Condition",
                        "enum": [
                            "",
                            "un_opened",
                            "new",
                            "as_good_as_new",
                            "good",
                            "fair",
                            "has_given_it_all"
                        ],
                        "type": "string",
                        "description": "Filter by product condition",
                        "default": ""
                    },
                    "publishedSince": {
                        "title": "Published Since",
                        "enum": [
                            "",
                            "today",
                            "lastWeek",
                            "lastMonth"
                        ],
                        "type": "string",
                        "description": "Filter by when the item was published"
                    },
                    "shipOnly": {
                        "title": "Ship Only",
                        "type": "boolean",
                        "description": "Show only items with shipping available (Envío disponible)",
                        "default": false
                    },
                    "minPrice": {
                        "title": "Min Price (€)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum price in euros"
                    },
                    "maxPrice": {
                        "title": "Max Price (€)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum price in euros"
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 40,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of products to retrieve (40-10000)",
                        "default": 120
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
