API Vinted Search

OverviewLink to Overview

Search Vinted second-hand listings through Piloterr. Pass a keyword or a full catalog URL; Piloterr calls the internal Vinted API (/api/v2/catalog/items) with an auto-managed session cookie.

Works across Vinted domains: vinted.fr, vinted.com, vinted.de, vinted.co.uk, and more.

Costs 1 credit per call.

WorkflowLink to Workflow

Typical flow on Piloterr:

1. Search (this endpoint) to list matching items
2. Vinted Item for full listing details
3. Vinted User Info for seller profile data

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/vinted/search?query=nike&region=https://www.vinted.fr&page=1&per_page=24
GET https://api.piloterr.com/v2/vinted/search?query=https://www.vinted.com/catalog?search_text=dresses%20for%20woman&per_page=24

ParametersLink to Parameters

ResponseLink to Response

{
  "results": [
    {
      "id": 9417084957,
      "url": "https://www.vinted.com/items/9417084957-tempted-black-draped-cowl-neck-short-sleeve-mini-dress",
      "path": "/items/9417084957-tempted-black-draped-cowl-neck-short-sleeve-mini-dress",
      "user": {
        "id": 3167755373,
        "login": "laceejayy",
        "photo": {
          "id": 321171847,
          "url": "https://images1.vinted.net/t/01_000e3_gsMsJcE1AKa2GfL23XAnjz5P/f800/1783634863.jpeg?s=5c18d0103555bbed3ddca66fe9e12ad631f2f4da",
          "width": 600,
          "height": 800
        },
        "business": false,
        "profile_url": "https://www.vinted.com/member/3167755373-laceejayy"
      },
      "photo": {
        "id": 39862469776,
        "url": "https://images1.vinted.net/t/02_023f8_BqApqrfHRr4eYif4gfmsy9a7/f800/1784247894.jpeg?s=2f0f0b44d41db05b396ceae775aef3c37f8116be",
        "width": 600,
        "height": 800,
        "is_main": true
      },
      "price": {
        "amount": "25.0",
        "currency_code": "USD"
      },
      "title": "Tempted Black Draped Cowl-Neck Short Sleeve Mini dress",
      "photos": [
        {
          "id": 39862469776,
          "url": "https://images1.vinted.net/t/02_023f8_BqApqrfHRr4eYif4gfmsy9a7/f800/1784247894.jpeg?s=2f0f0b44d41db05b396ceae775aef3c37f8116be",
          "width": 600,
          "height": 800,
          "is_main": true,
          "image_no": 1
        }
      ],
      "status": "Very good",
      "item_box": {
        "item_id": 9417084957,
        "first_line": "tempted",
        "second_line": "S / US 4-6 \u00b7 Very good"
      },
      "promoted": true,
      "is_visible": true,
      "size_title": "S / US 4-6",
      "brand_title": "tempted",
      "service_fee": {
        "amount": "1.95",
        "currency_code": "USD"
      },
      "is_favourite": false,
      "content_source": "search_promoted_items",
      "favourite_count": 55,
      "total_item_price": {
        "amount": "26.95",
        "currency_code": "USD"
      }
    },
    {
      "id": 9422855356,
      "url": "https://www.vinted.com/items/9422855356-wild-fable-coral-pink-maxi-dress-with-floral-cups-and-open-back",
      "path": "/items/9422855356-wild-fable-coral-pink-maxi-dress-with-floral-cups-and-open-back",
      "user": {
        "id": 3168044178,
        "login": "gabriellamiah",
        "photo": {
          "id": 321347671,
          "url": "https://images1.vinted.net/t/05_00074_fgpRk7bEdNFrM2D5x158Vubm/f800/1783751489.jpeg?s=43ca2d96f54cc36d797dda7a281bdc7d8cd12734",
          "width": 600,
          "height": 800
        },
        "business": false,
        "profile_url": "https://www.vinted.com/member/3168044178-gabriellamiah"
      },
      "photo": {
        "id": 39887137204,
        "url": "https://images1.vinted.net/t/06_00485_DbqyZigqBuvGGQTL4icBDLi5/f800/1784313642.jpeg?s=cf2c907b215da3820cb5abe89e418d934131512c",
        "width": 600,
        "height": 800,
        "is_main": true
      },
      "price": {
        "amount": "12.0",
        "currency_code": "USD"
      },
      "title": "Wild Fable coral pink maxi dress with floral cups and open back",
      "photos": [
        {
          "id": 39887137204,
          "url": "https://images1.vinted.net/t/06_00485_DbqyZigqBuvGGQTL4icBDLi5/f800/1784313642.jpeg?s=cf2c907b215da3820cb5abe89e418d934131512c",
          "width": 600,
          "height": 800,
          "is_main": true,
          "image_no": 1
        },
        {
          "id": 39887137208,
          "url": "https://images1.vinted.net/t/03_01bd1_h7xRSJBdzL1FQLZ1vmC3Q7XZ/f800/1784313642.jpeg?s=fc2b14c3a747ec275d0c8f9e0ddef236be217ca3",
          "width": 600,
          "height": 800,
          "is_main": false,
          "image_no": 2
        }
      ],
      "status": "Very good",
      "item_box": {
        "item_id": 9422855356,
        "first_line": "Wild Fable",
        "second_line": "S / US 4-6 \u00b7 Very good"
      },
      "promoted": false,
      "is_visible": true,
      "size_title": "S / US 4-6",
      "brand_title": "Wild Fable",
      "service_fee": {
        "amount": "1.3",
        "currency_code": "USD"
      },
      "is_favourite": false,
      "content_source": "search",
      "favourite_count": 52,
      "total_item_price": {
        "amount": "13.3",
        "currency_code": "USD"
      }
    }
  ],
  "pagination": {
    "next": 2,
    "page": 1,
    "per_page": 24,
    "total_pages": 40,
    "total_results": 960
  }
}

Error codesLink to Error codes

Good to knowLink to Good to know

• Vinted requires a session cookie; Piloterr fetches and refreshes it automatically.
• Search returns the raw Vinted catalog card schema (camelCase keys as returned by Vinted). Use Vinted Item for the normalized snake_case detail view.
• Some domains (especially .fr) may be harder to reach because of Cloudflare.
• Public data only, no user login.

Main use casesLink to Main use cases

• Monitor new listings for a brand or keyword across European Vinted markets
• Build resale price intelligence pipelines with pagination
• Feed item IDs into the Vinted Item endpoint for enrichment