# Wallapop — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Wallapop listings by category and keyword to instantly compare prices, view item condition, and check seller ratings. Track whether items are still available or already sold to make informed purchasing decisions on secondhand products.

**Category:** Marketplaces | **Website:** [fr.wallapop.com/](https://fr.wallapop.com/) | **Docs:** [parse.bot/marketplace/4e9bb0b4-7334-4589-9fa0-ce90ef7ae3b7/fr-wallapop-com-api](https://parse.bot/marketplace/4e9bb0b4-7334-4589-9fa0-ce90ef7ae3b7/fr-wallapop-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-fr-wallapop-com-api-4e9bb0b4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_item

Get full details for a single Wallapop item by its URL slug (obtainable from search_items results). Returns complete pricing, sold/reserved/expired flags, seller statistics, location, condition, images, and category-specific attributes (e.g. car specs, fashion details). One round-trip per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_slug` | string | Yes | Item URL slug from search_items results (the 'slug' field), e.g. 'iphone-14-1289989226' or 'citroen-c4-picasso-2011-1289990157'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fr-wallapop-com-api-4e9bb0b4/get_item \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_slug":"<string>"}'
```

### search_items

Browse Wallapop listings by category or keyword slug. Returns up to 80 items per call with prices and sold/reserved status. The slug corresponds to the site's SEO landing page path structure: use a category slug (e.g. 'coches-segunda-mano') or a category/keyword combination (e.g. 'moviles-telefonos/iphone'). The response includes suggested sub-keywords for further navigation. No pagination beyond the initial 80 items is available through this route.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | SEO landing page path slug. Can be a category (e.g. 'coches-segunda-mano', 'moviles-telefonos', 'moda-y-complementos') or category/keyword (e.g. 'moviles-telefonos/iphone', 'coches-segunda-mano/nissan-patrol'). Available category slugs: coches-segunda-mano, motos, motor-y-accesorios, moda-y-complementos, inmobiliaria, tv-audio-foto, moviles-telefonos, electronica, deporte-y-ocio, bicicletas, consolas-y-videojuegos, muebles-deco-y-jardin, electrodomesticos, libros-pelis-musica, ninos-y-bebes, coleccionismo, construccion-y-reformas, industria-agricultura, empleo, servicios, otros. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fr-wallapop-com-api-4e9bb0b4/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```