> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User Items

> A Wallapop seller's live listings, 40 per page, with price, condition, attributes, photos, and shipping.

The listings a Wallapop user currently has published, **40 per page**.

**Credits:** 5 per page. Empty results are not charged.

## Authorization

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Path Parameters

**user\_id** `string` *required*

The user, as an **id** — `dqjwdd53wwzo` — or a **profile slug** — `alexc-25115753`. The id is fastest.

## Query Parameters

**market** `string` (default: es)

`es`, `it`, or `pt`. Sets the host of the returned listing URLs. See [`/v1/wallapop/markets`](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/list-markets).

**next\_page** `string`

Cursor from the previous response's `next_page`.

## Response

**user\_id** `string`

The resolved user id.

**items** `UserItem[]`

The user's live listings.

**UserItem**

**id** `string`

Listing id. Use it with [`/v1/wallapop/items/{item_id}`](https://docs.scrapebadger.com/api-reference/endpoint/wallapop/get-item) for views, favorites, and the full taxonomy.

**title** `string | null`

Listing title.

**description** `string | null`

Listing description.

**price** `number | null`

Asking price.

**currency** `string | null`

ISO 4217 currency code, `EUR`.

**category\_id** `integer | null`

Category id.

**condition** `string | null`

Condition id, e.g. `good`, when set.

**attributes** `object`

Category-specific attributes as flat key/value pairs, e.g. `brand`, `condition`, `up_to_kg`.

**images** `Image[]`

Listing photos.

**Image**

**id** `string | null`

Image id.

**small** `string | null`

320 px wide URL.

**medium** `string | null`

640 px wide URL.

**large** `string | null`

800 px wide URL.

**average\_color** `string | null`

Average colour as a hex string.

**shippable** `boolean | null`

Whether the item can be shipped.

**user\_allows\_shipping** `boolean | null`

Whether the seller accepts shipping.

**is\_refurbished** `boolean | null`

Whether the item is refurbished.

**has\_warranty** `boolean | null`

Whether the item comes with a warranty.

**slug** `string | null`

Listing slug.

**url** `string | null`

Full listing URL on wallapop.com.

**result\_count** `integer`

Number of listings on this page.

**next\_page** `string | null`

Cursor for the next page. Pass it back as `next_page`; `null` when there are no more listings.

**market** `string`

The market used for the request.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/wallapop/users/dqjwdd53wwzo/items" \
  -H "X-API-Key: YOUR_API_KEY"
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/wallapop/users/dqjwdd53wwzo/items",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()
```

```javascript Node.js theme={null}
const res = await fetch("https://scrapebadger.com/v1/wallapop/users/dqjwdd53wwzo/items", {
  headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY },
});
const data = await res.json();
```

```bash CLI theme={null}
scrapebadger wallapop user-items dqjwdd53wwzo
```

```json Response theme={null}
{
  "user_id": "dqjwdd53wwzo",
  "items": [
    {
      "id": "3zlm3y52kpjx",
      "title": "Caja Cooler Master c700m",
      "description": "En buen estado, valorada en 300€, nueva 600€, le falta solo una pata de goma y una de las tiras led superiores no funciona.",
      "price": 150.0,
      "currency": "EUR",
      "category_id": 24200,
      "condition": "good",
      "attributes": {
        "brand": "Cooler Master ",
        "condition": "good",
        "up_to_kg": "30.0"
      },
      "images": [
        {
          "id": "0j2wey3lm2rj",
          "small": "https://cdn.wallapop.com/images/10420/lf/ul/__/c10420p1296410893/i6706063683.jpg?pictureSize=W320",
          "medium": "https://cdn.wallapop.com/images/10420/lf/ul/__/c10420p1296410893/i6706063683.jpg?pictureSize=W640",
          "large": "https://cdn.wallapop.com/images/10420/lf/ul/__/c10420p1296410893/i6706063683.jpg?pictureSize=W800",
          "average_color": "13C1AC"
        }
      ],
      "shippable": true,
      "user_allows_shipping": true,
      "is_refurbished": false,
      "has_warranty": false,
      "slug": "caja-cooler-master-c700m-1296410893",
      "url": "https://es.wallapop.com/item/caja-cooler-master-c700m-1296410893"
    },
    {
      "id": "mzn3d72pk0jn",
      "title": "Lego 100% original lote 3,6 kg",
      "description": "En buen estado, solo los motores ya se venden a 60€",
      "price": 70.0,
      "currency": "EUR",
      "category_id": 12461,
      "condition": "good",
      "attributes": {
        "condition": "good",
        "up_to_kg": "5.0"
      },
      "images": [
        {
          "id": "8z8qevl2x4lz",
          "small": "https://cdn.wallapop.com/images/10420/le/m2/__/c10420p1294334049/i6693385070.jpg?pictureSize=W320",
          "medium": "https://cdn.wallapop.com/images/10420/le/m2/__/c10420p1294334049/i6693385070.jpg?pictureSize=W640",
          "large": "https://cdn.wallapop.com/images/10420/le/m2/__/c10420p1294334049/i6693385070.jpg?pictureSize=W800",
          "average_color": "13C1AC"
        }
      ],
      "shippable": true,
      "user_allows_shipping": true,
      "is_refurbished": false,
      "has_warranty": false,
      "slug": "lego-100-original-lote-1294334049",
      "url": "https://es.wallapop.com/item/lego-100-original-lote-1294334049"
    }
  ],
  "result_count": 2,
  "next_page": null,
  "market": "es"
}
```

## Errors

| Status | Cause |
| - | - |
| `404` | The user does not exist. Not charged. |
| `422` | `market` is not `es`, `it`, or `pt`. |
| `502` | Wallapop did not answer after retries. Not charged — retry the request. |

> [!NOTE]
>
> Each page of listings costs **8 credits**. Empty pages and failed requests are not charged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.