Search Items

Search and filter items on Vinted marketplace. Supports full-text search, category filtering, brand filtering, size/material/status filtering, price range, and sorting options.

Endpoint

GET /api/vinted/search
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

query string Optional

Search query text (e.g., "nike shoes")

country string Optional

Country code for Vinted domain (FR, DE, BE, IT, ES, NL, etc.). Defaults to FR.

page integer Optional

Page number for pagination. Defaults to 1.

per_page integer Optional

Number of items per page (max 100). Defaults to 24.

order string Optional

Sort order: relevance, newest_first, price_low_to_high, price_high_to_low

catalog_ids string Optional

Category IDs to filter by (comma-separated)

brand_ids string Optional

Brand IDs to filter by (comma-separated)

size_ids string Optional

Size IDs to filter by (comma-separated)

color_ids string Optional

Color IDs to filter by (comma-separated)

material_ids string Optional

Material IDs to filter by (comma-separated)

status_ids string Optional

Status IDs to filter by (comma-separated)

price_from number Optional

Minimum price filter (inclusive). Items below this price will be filtered out from results.

price_to number Optional

Maximum price filter (inclusive). Items above this price will be filtered out from results.

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE');

return $response->json();
fetch('https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/vinted/search?query=nike+shoes&country=DE' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "items": [],
    "pagination": []
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home