> ## 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

> List all active items from a specific Vinted user.

## Path Parameters

<ParamField path="user_id" type="integer" required>
  The unique Vinted user ID.
</ParamField>

## Query Parameters

<ParamField query="market" type="string" default="fr">
  Vinted market where the user is registered.

  Examples: `fr`, `de`, `uk`, `it`, `es`, `pl`, `us`
</ParamField>

<ParamField query="page" type="integer" default={1}>
  Page number for paginated results. Starts at `1`.
</ParamField>

<ParamField query="per_page" type="integer" default={24}>
  Number of items per page. Range: `1` - `96`.
</ParamField>

## Response

<ResponseField name="items" type="array">
  Array of items listed by the user.

  <Expandable title="Item object">
    <ResponseField name="id" type="integer">Item ID.</ResponseField>
    <ResponseField name="title" type="string">Item title.</ResponseField>
    <ResponseField name="price" type="string">Price in local currency.</ResponseField>
    <ResponseField name="currency" type="string">ISO 4217 currency code.</ResponseField>
    <ResponseField name="brand_title" type="string">Brand name.</ResponseField>
    <ResponseField name="size_title" type="string">Size label.</ResponseField>
    <ResponseField name="photo" type="object">Primary photo with `url`, `width`, `height`.</ResponseField>
    <ResponseField name="url" type="string">Full URL to the Vinted listing.</ResponseField>
    <ResponseField name="favourite_count" type="integer">Number of favourites.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_entries" type="integer">
  Total number of items listed by this user.
</ResponseField>

<ResponseField name="current_page" type="integer">
  Current page number.
</ResponseField>

<ResponseField name="per_page" type="integer">
  Number of items per page.
</ResponseField>

### Example Response

```json theme={null}
{
  "items": [
    {
      "id": 4856231890,
      "title": "Nike Air Force 1 '07 White",
      "price": "45.00",
      "currency": "EUR",
      "brand_title": "Nike",
      "size_title": "42",
      "photo": {
        "url": "https://images1.vinted.net/t/...",
        "width": 800,
        "height": 600
      },
      "url": "https://www.vinted.fr/items/4856231890",
      "favourite_count": 12
    }
  ],
  "total_entries": 23,
  "current_page": 1,
  "per_page": 24
}
```

<Note>
  Each user items request costs **1 credit**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/vinted/users/{user_id}/items
openapi: 3.1.0
info:
  title: ScrapeBadger Vinted API
  version: 1.0.0
  description: >-
    Vinted marketplace scraping API for searching items, fetching details, user
    profiles, and reference data.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/vinted/users/{user_id}/items:
    get:
      summary: Get User Items
      description: List all active items from a specific Vinted user.
      operationId: getVintedUserItems
      parameters:
        - name: user_id
          in: path
          required: true
          schema:
            type: integer
          description: The unique Vinted user ID.
        - name: market
          in: query
          schema:
            type: string
            default: fr
          description: Vinted market where the user is registered (e.g. fr, de, uk).
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number for paginated results.
        - name: per_page
          in: query
          schema:
            type: integer
            default: 24
            minimum: 1
            maximum: 96
          description: Number of items per page.
      responses:
        '200':
          description: User items list
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/VintedItemSummary'
                  total_entries:
                    type: integer
                    description: Total number of items listed by this user.
                  current_page:
                    type: integer
                    description: Current page number.
                  per_page:
                    type: integer
                    description: Number of items per page.
components:
  schemas:
    VintedItemSummary:
      type: object
      properties:
        id:
          type: integer
          description: Item ID.
        title:
          type: string
          description: Item title.
        price:
          type: string
          description: Price in local currency (e.g. "15.00").
        currency:
          type: string
          description: ISO 4217 currency code (e.g. "EUR").
        brand_title:
          type: string
          nullable: true
          description: Brand name.
        size_title:
          type: string
          nullable: true
          description: Size label.
        photo:
          $ref: '#/components/schemas/VintedPhoto'
        url:
          type: string
          description: Full URL to the Vinted listing.
        user:
          $ref: '#/components/schemas/VintedUserSummary'
        favourite_count:
          type: integer
          description: Number of users who favourited this item.
    VintedPhoto:
      type: object
      properties:
        url:
          type: string
          description: Photo URL.
        width:
          type: integer
          nullable: true
          description: Width in pixels.
        height:
          type: integer
          nullable: true
          description: Height in pixels.
    VintedUserSummary:
      type: object
      properties:
        id:
          type: integer
          description: User ID.
        login:
          type: string
          description: Username.
        photo:
          type: object
          nullable: true
          properties:
            url:
              type: string
        feedback_reputation:
          type: number
          nullable: true
          description: Reputation score between 0 and 1.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````