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

# List seller listings

> Costs 2 credit per request.



## OpenAPI

````yaml /openapi.json get /v1/vinted/users/{id}/items
openapi: 3.1.0
info:
  title: Nephia API
  description: >-
    B2B API for structured data from live Sources (Vinted, X, Reddit).
    Authenticate with an API key on your Account. Pull endpoints charge credits
    per request. Watches poll on an interval and deliver webhook events. Product
    request quota is per Account (all API keys share one bucket), by Plan: Free
    60/min, Starter 350/min, Growth 700/min, Pro 1,200/min. Credit packs do not
    raise the quota.
  version: 1.0.0
servers:
  - url: https://api.nephia.cc
    description: Production
  - url: http://localhost:3000
    description: Local
security:
  - ApiKeyAuth: []
tags:
  - name: Account
    description: Account balance
  - name: Vinted — Search
    description: Vinted catalog search
  - name: Vinted — Items
    description: Vinted listing detail
  - name: Vinted — Users
    description: Vinted sellers and wardrobes
  - name: Vinted — Reference
    description: Vinted filter metadata
  - name: Vinted — Watches
    description: Vinted watches, events, and activity
  - name: X — Tweets
    description: Tweet lookup, replies, thread, quotes, and engagers
  - name: X — Users
    description: X profiles, timelines, and social graphs
  - name: X — Search
    description: Tweet search
  - name: X — Lists
    description: X list timelines
  - name: X — Trends
    description: Trend places and snapshots
  - name: X — Watches
    description: X watches, events, and activity
  - name: Reddit — Search
    description: Reddit post, subreddit, and user search
  - name: Reddit — Posts
    description: Reddit posts, comments, duplicates, and trending
  - name: Reddit — Subreddits
    description: Subreddit profiles, listings, and rules
  - name: Reddit — Users
    description: Reddit user profiles and activity
  - name: Reddit — Watches
    description: Reddit watches, events, and activity
paths:
  /v1/vinted/users/{id}/items:
    get:
      tags:
        - Vinted — Users
      summary: List seller listings
      description: Costs 2 credit per request.
      operationId: getV1VintedUsersByIdItems
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
        - in: query
          name: market
          schema:
            type: string
            default: fr
        - in: query
          name: page
          schema:
            type: number
        - in: query
          name: per_page
          schema:
            type: number
      responses:
        '200':
          description: Seller listings
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                        title:
                          type: string
                        price:
                          type: object
                          properties:
                            amount:
                              type: string
                            currency_code:
                              type: string
                          required:
                            - amount
                            - currency_code
                        brand_title:
                          type: string
                        size_title:
                          type: string
                        status:
                          type: string
                        url:
                          type: string
                        path:
                          type: string
                        is_visible:
                          type: boolean
                        promoted:
                          type: boolean
                        favourite_count:
                          type: number
                        view_count:
                          type: number
                        service_fee:
                          type: object
                          properties:
                            amount:
                              type: string
                            currency_code:
                              type: string
                          required:
                            - amount
                            - currency_code
                        total_item_price:
                          type: object
                          properties:
                            amount:
                              type: string
                            currency_code:
                              type: string
                          required:
                            - amount
                            - currency_code
                        content_source:
                          type:
                            - string
                            - 'null'
                        seller_country_code:
                          type:
                            - string
                            - 'null'
                        user:
                          type: object
                          properties:
                            id:
                              type: number
                            login:
                              type: string
                            photo_url:
                              type:
                                - string
                                - 'null'
                            business:
                              type: boolean
                          required:
                            - id
                            - login
                            - photo_url
                            - business
                        photo:
                          type: object
                          properties:
                            id:
                              type: number
                            url:
                              type: string
                            dominant_color:
                              type: string
                            is_main:
                              type: boolean
                            width:
                              type: number
                            height:
                              type: number
                            full_size_url:
                              type: string
                          required:
                            - id
                            - url
                            - dominant_color
                            - is_main
                            - width
                            - height
                            - full_size_url
                        photos:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: number
                              url:
                                type: string
                              dominant_color:
                                type: string
                              is_main:
                                type: boolean
                              width:
                                type: number
                              height:
                                type: number
                              full_size_url:
                                type: string
                            required:
                              - id
                              - url
                              - dominant_color
                              - is_main
                              - width
                              - height
                              - full_size_url
                      required:
                        - id
                        - title
                        - price
                        - brand_title
                        - size_title
                        - status
                        - url
                        - path
                        - is_visible
                        - promoted
                        - favourite_count
                        - view_count
                        - service_fee
                        - total_item_price
                        - content_source
                        - seller_country_code
                        - user
                        - photo
                        - photos
                  pagination:
                    type: object
                    properties:
                      current_page:
                        type: number
                      total_pages:
                        type: number
                      total_entries:
                        type: number
                      per_page:
                        type: number
                    required:
                      - current_page
                      - total_pages
                      - total_entries
                      - per_page
                  market:
                    type: string
                required:
                  - items
                  - pagination
                  - market
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '404':
          description: Seller not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Request quota exceeded. Retry after the `Retry-After` header
            (seconds). Response includes `RateLimit-*` headers (IETF draft-7).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
              example:
                error: Rate limit exceeded
                code: TOO_MANY_REQUESTS
        '503':
          description: Upstream temporarily unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created from the Nephia dashboard for your Account.

````