{
  "openapi": "3.0.1",
  "info": {
    "title": "Wallapop Monitor & Listings API: Price Alerts, Wallapop Italy",
    "description": "Wallapop scraper, Wallapop API and Wallapop alerts: Wallapop listings: used items, Wallapop cars (make, model, year, km) by keyword, any Wallapop Spain, Wallapop Italy, Wallapop Portugal city. Wallapop price filters, Wallapop monitor, price drop alerts, deal score. Wallapop export, Wallapop dataset.",
    "version": "0.1",
    "x-build-id": "bUgo7Pvj4jkyd2yTD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/euroscrape~wallapop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-euroscrape-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/euroscrape~wallapop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-euroscrape-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/euroscrape~wallapop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-euroscrape-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": {
          "searches": {
            "title": "Searches",
            "type": "array",
            "description": "What to look for: plain text (\"iphone 13\", \"bicicleta eléctrica\"), a Wallapop search URL copied from the site with your filters, or an item URL (es.wallapop.com/item/…) to follow one listing. Leave empty to browse a category or a car make.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "ES",
              "IT",
              "PT"
            ],
            "type": "string",
            "description": "Wallapop market: Spain, Italy or Portugal.",
            "default": "ES"
          },
          "location": {
            "title": "Around (city or postal code)",
            "type": "string",
            "description": "Optional, e.g. \"Valencia\", \"08001\", \"Torino\". Results are ranked and measured (distanceKm) from here. Without it, the whole country is searched from its main city."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Optional, with a location: only listings within this distance."
          },
          "category": {
            "title": "Category",
            "enum": [
              "cars",
              "motorbikes",
              "motorAccessories",
              "fashion",
              "realEstate",
              "electronics",
              "sports",
              "bikes",
              "homeGarden",
              "appliances",
              "moviesBooksMusic",
              "babyChild",
              "collectibles",
              "construction",
              "agricultureIndustrial",
              "jobs",
              "services",
              "other"
            ],
            "type": "string",
            "description": "Optional. Wallapop's top-level categories."
          },
          "maxItemsPerSearch": {
            "title": "Maximum listings per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "You pay per listing delivered. Up to 1,000 per search.",
            "default": 100
          },
          "order": {
            "title": "Sort",
            "enum": [
              "newest",
              "relevance",
              "priceLowToHigh",
              "priceHighToLow",
              "closest"
            ],
            "type": "string",
            "description": "Order of the site's results: it decides which listings are read first.",
            "default": "newest"
          },
          "priceMin": {
            "title": "Minimum price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional."
          },
          "priceMax": {
            "title": "Maximum price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional."
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Optional, one or more. \"New\" also covers \"in box\" and \"unopened\".",
            "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"
              ]
            }
          },
          "onlyShippable": {
            "title": "Only listings with shipping",
            "type": "boolean",
            "description": "Keep only listings that can be shipped (Wallapop Envíos), for buyers outside the seller's city.",
            "default": false
          },
          "strictMatching": {
            "title": "Only listings whose title matches the search",
            "type": "boolean",
            "description": "Wallapop also returns related items (\"iphone 13\" brings batteries, cases, iPhone 12). On: the title must contain the model numbers and the words of your search.",
            "default": true
          },
          "excludeAccessoriesAndBroken": {
            "title": "Exclude accessories, broken items and wanted ads",
            "type": "boolean",
            "description": "Off: they are kept and flagged (looksLikeAccessory, looksBroken, isWantedAd). On: they are left out.",
            "default": false
          },
          "carMake": {
            "title": "Car make",
            "type": "string",
            "description": "Cars only, e.g. \"volkswagen\", \"seat\", \"toyota\". Sets the category to Cars."
          },
          "carModel": {
            "title": "Car model",
            "type": "string",
            "description": "Cars only, e.g. \"golf\", \"ibiza\"."
          },
          "carMinYear": {
            "title": "From year",
            "minimum": 1950,
            "maximum": 2100,
            "type": "integer",
            "description": "Cars only."
          },
          "carMaxYear": {
            "title": "To year",
            "minimum": 1950,
            "maximum": 2100,
            "type": "integer",
            "description": "Cars only."
          },
          "carMaxKm": {
            "title": "Maximum mileage (km)",
            "minimum": 1,
            "type": "integer",
            "description": "Cars only."
          },
          "dealAnalysis": {
            "title": "Deal score (free)",
            "type": "boolean",
            "description": "Compares each price with the median of the most similar listings of the same search: marketMedianPrice, priceVsMarketPct and a dealScore from 0 to 100 (100 = far below the market).",
            "default": true
          },
          "minDealScore": {
            "title": "Only deals scoring at least",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Optional, e.g. 65 keeps listings priced ~15% or more below their market."
          },
          "includeDetails": {
            "title": "Full details and seller rating",
            "type": "boolean",
            "description": "Opens each listing: condition, brand, model, color, size or storage, views, favorites, chats, full description, all photos, and the seller's rating, reviews, sales and member-since date (never the seller's name). Billed as \"listing with details\".",
            "default": false
          },
          "includeSummary": {
            "title": "Free summary per search",
            "type": "boolean",
            "description": "One extra free row per search: median and quartile prices, share of listings with shipping, top cities, best 5 deals.",
            "default": true
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name this search and schedule the Actor (e.g. every hour): each run then returns only NEW listings and PRICE DROPS since the previous run, and alerts you. The first run is the baseline."
          },
          "alertOnPriceDropPct": {
            "title": "Price drop that counts (%)",
            "minimum": 0,
            "maximum": 90,
            "type": "integer",
            "description": "Monitoring: a listing comes back when its price falls by at least this percentage.",
            "default": 5
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Alerts on Telegram: create a bot with @BotFather and paste its token."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Your chat ID (send a message to your bot, then open api.telegram.org/bot<token>/getUpdates)."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Channel settings → Integrations → Webhooks."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook URL."
          },
          "webhookUrl": {
            "title": "Webhook URL (JSON)",
            "type": "string",
            "description": "Receives one POST per run with the new listings and price drops (Make, Zapier, n8n…)."
          },
          "maxNotifications": {
            "title": "Maximum alerts per run",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Extra items are summarized in one message.",
            "default": 30
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}