# Wallapop Listings Scraper

> Wallapop Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured listing data from Wallapop (search results, item details, or seller inventories) and returns structured product records.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/wallapop?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallapop-listings-scraper-14444609
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q8363moOLFjOdjLV-RRXa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wallapop-listings-scraper-14444609 -d '<json body>'
```

Example prompt: Search Wallapop for used road bikes in Spain, collect up to 50 listings including their details like price, description, and location, and give me the structured results.

## When to prefer this

Choose this endpoint when you need structured, machine-readable data from Wallapop — Europe's leading second-hand marketplace — including search result pages, specific item detail records, or seller inventories. It supports location-based and URL-based searches, and is pay-per-successful-call, making it cost-efficient for exploratory or sparse queries.

## Known failure modes

- Search URL fails if Wallapop's public search endpoint ignores filters — returns empty or partial results
- Invalid or non-existent item IDs return no data for those entries
- Coordinates outside valid lat/lon ranges (-90 to 90, -180 to 180) cause validation errors
- Unsupported country enum values are rejected
- If the run fails or returns empty, no charge is applied

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object with a count of results and an array of item records, each containing fields such as title, itemId, slug, listingUrl, shareUrl, category, categoryId, and description. Optionally includes additional detail-level fields like location and engagement metrics when includeDetails is true.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "enum": [
    "Spain",
    "France",
    "Italy",
    "Portugal",
    "United Kingdom",
    "Germany"
   ],
   "type": "string",
   "default": "Spain",
   "description": "Default search centre when a search URL has no coordinates."
  },
  "itemIds": {
   "type": "array",
   "description": "Internal public item IDs for specific listings. Numeric item URL slugs are different from these IDs."
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Optional search centre latitude; provide longitude as well."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum dataset items across all sources. Zero removes the total cap."
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Optional search centre longitude; provide latitude as well."
  },
  "sellerIds": {
   "type": "array",
   "description": "Public Wallapop seller IDs. Collects the first inventory page, up to 40 listings per seller."
  },
  "startUrls": {
   "type": "array",
   "description": "Wallapop search or item URLs. Search may fail when the public search endpoint ignores filters; item URLs require an internal item ID as the last path segment."
  },
  "includeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Fetch each item's public detail record for specifications, location and engagement metrics. Inventory summaries are used if an item detail fails."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "slug": null,
    "title": null,
    "itemId": null,
    "category": null,
    "shareUrl": null,
    "categoryId": null,
    "listingUrl": null,
    "description": null
   }
  ],
  "product": "wallapop"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallapop-listings-scraper-14444609/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)