{
  "openapi": "3.0.1",
  "info": {
    "title": "Wallapop Scraper — Listings, Prices & Sellers",
    "description": "Scrape Wallapop listings (second-hand items on Wallapop.com) by keyword, category or search URL: title, price, condition, location, seller, posted date, shipping, photos and listing URL, with optional item details and seller ratings. No login needed.",
    "version": "0.1",
    "x-build-id": "wpjCWi8xobrtPWUkr"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tortuga~wallapop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tortuga-wallapop-scraper",
        "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/tortuga~wallapop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tortuga-wallapop-scraper",
        "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/tortuga~wallapop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tortuga-wallapop-scraper",
        "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",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords as you would type them into the Wallapop search box, one search per line, e.g. \"bicicleta\", \"iphone 15\", \"ps5\". Each term is searched with the filters below (category, price, condition, shipping, location).",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Wallapop search pages copied from the browser with the filters and sort you set, e.g. https://es.wallapop.com/app/search?keywords=iphone&min_sale_price=100&max_sale_price=500&order_by=newest or https://es.wallapop.com/search?category_id=17000&subcategory_ids=10214. Searches on it.wallapop.com, pt.wallapop.com and uk.wallapop.com work too. Single item pages (/item/...) cannot be read through Wallapop's API: search for the listing instead, or give its id in Item IDs.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "categoryId": {
            "title": "Category",
            "enum": [
              "",
              "100",
              "14000",
              "12800",
              "12465",
              "200",
              "12545",
              "16000",
              "15000",
              "12579",
              "17000",
              "12900",
              "12467",
              "13100",
              "12463",
              "12461",
              "18000",
              "19000",
              "20000",
              "13200"
            ],
            "type": "string",
            "description": "Used with the search terms, or alone to browse the whole category. Other categories (e.g. Empleo = 21000, Otros = 12485) and subcategories: paste the search URL into Start URLs.",
            "default": ""
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "number",
            "description": "Used with the search terms: lowest price, in the currency of the country searched (EUR; GBP on uk.wallapop.com)."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "number",
            "description": "Used with the search terms: highest price."
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Used with the search terms: only listings in these conditions. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "as_good_as_new",
                "good",
                "fair",
                "has_given_it_all"
              ],
              "enumTitles": [
                "Nuevo (new, unopened or unworn)",
                "Como nuevo (as good as new)",
                "En buen estado (good)",
                "Aceptable (fair)",
                "Lo ha dado todo (heavily used)"
              ]
            }
          },
          "onlyShippable": {
            "title": "Only listings with shipping",
            "type": "boolean",
            "description": "Used with the search terms: only listings the seller is willing to ship (Wallapop Envíos)."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Where to search from: a big city of Spain, Italy, Portugal or the UK (Madrid, Barcelona, Valencia, Sevilla, Bilbao, Milano, Roma, Lisboa, London, ...) or \"latitude, longitude\". The country of the point decides which Wallapop country you search. Default: central Madrid, the point Wallapop uses for visitors without a location. Relevance and \"closest\" sorting prefer nearby listings; the newest and price sorts cover the whole country unless you set a distance."
          },
          "latitude": {
            "title": "Latitude",
            "type": "number",
            "description": "Alternative to Location: the latitude of the point to search from (e.g. 41.3874 for Barcelona). Give longitude too."
          },
          "longitude": {
            "title": "Longitude",
            "type": "number",
            "description": "Alternative to Location: the longitude of the point to search from (e.g. 2.1686 for Barcelona)."
          },
          "distanceKm": {
            "title": "Distance (km)",
            "minimum": 1,
            "type": "integer",
            "description": "Only listings within this many km of the location. Empty = no limit (relevance still ranks nearby listings first)."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "newest",
              "most_relevance",
              "price_low_to_high",
              "price_high_to_low",
              "closest"
            ],
            "type": "string",
            "description": "Order of the search results. Newest first is the best choice for monitoring new listings (country-wide unless you set a distance); relevance and closest rank by distance from the location. Start URLs keep the order_by in their own URL.",
            "default": "newest"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many listings in total (across all searches). Keeps the cost predictable. A search page holds 40 listings.",
            "default": 100
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 1,
            "maximum": 250,
            "type": "integer",
            "description": "How many result pages (40 listings each) to read for each search term or URL, so one busy search does not use up Max items for the others. Up to 250.",
            "default": 5
          },
          "includeDetails": {
            "title": "Include item and seller details",
            "type": "boolean",
            "description": "Also open every listing for its condition, car / property attributes, view and favourite counts and hashtags, and the seller's public profile (display name, private or professional, verified, rating, review and sold counts, member since). One item request per listing plus two small requests per distinct seller; charged as an extra 'detail' event per listing (see pricing).",
            "default": false
          },
          "itemIds": {
            "title": "Item IDs",
            "type": "array",
            "description": "Wallapop item ids to fetch directly, e.g. \"pj94opempv6e\" (the itemId column of an earlier run). Each is one detail request (charged as a listing plus a detail event); useful to watch specific listings for price drops or reservations with Only new or changed items.",
            "items": {
              "type": "string"
            }
          },
          "onlyNewOrChanged": {
            "title": "Only new or changed items",
            "type": "boolean",
            "description": "Remember what earlier runs of this search returned and output only new listings or listings whose price or availability (available / reserved / sold) changed. Use with a Schedule; unchanged listings are not charged. With this on, Max items is the number of listings checked per run (e.g. the newest 100).",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify Proxy (datacenter) is the default and is enough: Wallapop's API answers datacenter IPs. Each search page is about 100 KB; traffic is small.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}