> ## 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 **3 credits**. 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:
          $ref: '#/components/schemas/VintedPrice'
        service_fee:
          type: string
          nullable: true
          description: Buyer-protection fee as a decimal string, in price.currency_code.
        total_item_price:
          type: string
          nullable: true
          description: >-
            Price + buyer protection as a decimal string, in
            price.currency_code.
        brand_title:
          type: string
          nullable: true
          description: Brand name.
        size_title:
          type: string
          nullable: true
          description: Size label.
        status:
          type: string
          nullable: true
          description: Item condition, localized to the market.
        photo:
          $ref: '#/components/schemas/VintedPhoto'
        photos:
          type: array
          items:
            $ref: '#/components/schemas/VintedPhoto'
        url:
          type: string
          description: Full URL to the Vinted listing.
        path:
          type: string
          nullable: true
          description: Path portion of the listing URL.
        user:
          $ref: '#/components/schemas/VintedUserSummary'
        favourite_count:
          type: integer
          description: Number of users who favourited this item.
        view_count:
          type: integer
          description: Number of views.
        is_visible:
          type: boolean
          description: Whether the listing is publicly visible.
        promoted:
          type: boolean
          description: Whether the listing is a promoted/bumped placement.
        content_source:
          type: string
          nullable: true
          description: Vinted's own label for where the result came from (e.g. "search").
        seller_country_code:
          type: string
          nullable: true
          description: >-
            ISO 3166-1 alpha-2 code of the seller's physical country (e.g.
            "IT"). Populated only when seller_country filtering was requested.
        display_title:
          anyOf:
            - type: string
            - type: 'null'
          description: Vinted display text; do not interpret it as a brand or size ID.
        display_subtitle:
          anyOf:
            - type: string
            - type: 'null'
          description: Vinted display text; do not interpret it as a brand or size ID.
    VintedPrice:
      type: object
      properties:
        amount:
          type: string
          description: Decimal amount as a string (e.g. "45.0").
        currency_code:
          type: string
          description: ISO 4217 currency code (e.g. "EUR").
    VintedPhoto:
      type: object
      properties:
        id:
          type: integer
          description: Photo ID.
        url:
          type: string
          description: Photo URL.
        full_size_url:
          type: string
          nullable: true
          description: Full-resolution photo URL.
        width:
          type: integer
          nullable: true
          description: Width in pixels.
        height:
          type: integer
          nullable: true
          description: Height in pixels.
        dominant_color:
          type: string
          nullable: true
          description: Dominant colour as a hex string.
        is_main:
          type: boolean
          description: Whether this is the listing's primary photo.
    VintedUserSummary:
      type: object
      properties:
        id:
          type: integer
          description: User ID.
        login:
          type: string
          description: Username.
        photo_url:
          type: string
          nullable: true
          description: Profile photo URL.
        business:
          type: boolean
          description: Whether the seller is a business account.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````