{
  "openapi": "3.0.1",
  "info": {
    "title": "Wallapop Scraper: Listings, Prices, Condition and Sellers",
    "description": "Scrape Wallapop listings in Spain, Italy and Portugal by keyword, city and radius, or from search and item links: price, condition, brand, location, distance, shipping, posted date, photos, views, favourites, link and seller rating and sales. No login.",
    "version": "0.1",
    "x-build-id": "3x1N2JH1tEBkc1gKs"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~wallapop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~wallapop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-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/themineworks~wallapop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-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": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "What to search for, one per line, as you would type it in the Wallapop search box. Example: iphone 13, bicicleta, sofa. Each keyword is one search. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "ES",
              "IT",
              "PT"
            ],
            "type": "string",
            "description": "Which Wallapop market to search with your keywords: Spain, Italy or Portugal. Titles come in that country's language.",
            "default": "ES"
          },
          "location": {
            "title": "Location (city or lat,lng)",
            "type": "string",
            "description": "Where the search is centred: a city or town in the chosen country (Madrid, Barcelona, Valencia, Milano, Porto) or coordinates such as 40.4168,-3.7038. Empty means the capital (Madrid, Roma, Lisboa). Wallapop ranks nearby listings first; add a radius to keep only listings close to it."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Only listings within this many kilometres of the location. Empty means the whole country."
          },
          "minPrice": {
            "title": "Minimum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or above this, in euros."
          },
          "maxPrice": {
            "title": "Maximum price (EUR)",
            "minimum": 1,
            "type": "integer",
            "description": "Only listings priced at or below this, in euros."
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Only listings in these conditions. Empty means any condition. Wallapop applies this to categories that have a condition (electronics, fashion, home and so on).",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "as_good_as_new",
                "good",
                "fair",
                "has_given_it_all"
              ],
              "enumTitles": [
                "New",
                "As good as new",
                "Good",
                "Fair",
                "Has given it all"
              ]
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "most_relevance",
              "newest",
              "closest",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "Order of the results, as on Wallapop.",
            "default": "most_relevance"
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "any",
              "today",
              "lastWeek",
              "lastMonth"
            ],
            "type": "string",
            "description": "Only listings published in this period.",
            "default": "any"
          },
          "shippingOnly": {
            "title": "Only listings with shipping",
            "type": "boolean",
            "description": "On: only listings the seller ships through Wallapop.",
            "default": false
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "any",
              "private",
              "professional"
            ],
            "type": "string",
            "description": "Only private sellers or only professional sellers (shops and dealers). Wallapop applies this mainly in Cars and Motorbikes.",
            "default": "any"
          },
          "categoryId": {
            "title": "Category id (optional)",
            "type": "integer",
            "description": "A Wallapop category id, from the category_id column of a previous run or the category_id in a Wallapop search link. Examples: 24200 Technology and electronics, 12465 Home and garden, 100 Cars."
          },
          "startUrls": {
            "title": "Wallapop links (optional)",
            "type": "array",
            "description": "Search links copied from your browser (https://es.wallapop.com/search?keywords=ps5&min_sale_price=100&order_by=newest), which keep every filter in the link, or listing links (https://es.wallapop.com/item/iphone-12-mini-64gb-1324969841). Works for es, it and pt.wallapop.com.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max listings per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "The most listings to return for each keyword or search link, 1 to 10,000. A results page holds 40 listings.",
            "default": 100
          },
          "includeDetails": {
            "title": "Read each listing's details (condition, brand, model, views)",
            "type": "boolean",
            "description": "On: each listing's own record is read too, for the condition, brand, model, every attribute (size, colour, storage), views, favourites and chats. Off: rows come from the search results only, which is faster. Same price either way.",
            "default": true
          },
          "includeSellerInfo": {
            "title": "Add seller stats (rating, reviews, sales)",
            "type": "boolean",
            "description": "On: each seller is read once per run for private or professional, rating, number of reviews, items sold, active listings and member since. Professional sellers (shops, dealers) also get the business name, profile link, phone, website, address and description they publish on Wallapop. Same price either way.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}