# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/wallapop/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/wallapop/get-item \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/wallapop/search-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.