Dokumentacja API.

Bazowy URL: https://api.snajper.org

Autoryzacja

Każde zapytanie musi zawierać nagłówek x-api-key <API_KEY> . Klucz API znajdziesz w panelu użytkownika po zalogowaniu. Każde zapytanie zużywa kredyty — ich liczba zależy od endpointu.

x-api-key: xxxxxxxxxxxxxxxxxxxx
POST /api/v2/vinted/catalog
2 kredyty

Pobiera listę przedmiotów z katalogu Vinted.

Jak używać

Przekaż w body pełny URL strony wyszukiwania Vinted (np. skopiowany z przeglądarki). API automatycznie przetłumaczy go na zapytanie do wewnętrznego API Vinted, posortuje wyniki od najnowszych i zwróci do 20 przedmiotów na stronę. Idealny punkt startowy do budowania monitorów cenowych lub scraperów katalogu.

Czas odpowiedzi 0.6s – 1s
Transfer 7 kB – 12 kB
Parametry
x-api-key nagłówek string <API_KEY> *
url body string Pełny URL katalogu Vinted wraz z filtrami (np. https://www.vinted.pl/catalog?search_text=iphone+13). *
Przykładowe zapytanie 
curl -X POST "https://api.snajper.org/api/v2/vinted/catalog" \
  -H "x-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.vinted.pl/catalog?search_text=iphone+13"}'
Przykładowa odpowiedź 
{
  "items": [
    {
      "id": 8805548600,
      "title": "Iphone 13 pro",
      "brand_title": "Apple",
      "price": "944.88 PLN",
      "status": "Bardzo dobry",
      "url": "https://www.vinted.pl/items/8805548600-iphone-13-pro",
      "is_promoted": false,
      "favourite_count": 0,
      "photo": "https://images1.vinted.net/...",
      "seller_id": 3153068455,
      "seller_name": "krolinjo",
      "timestamp": 1777745143,
      "created_at": "2026-05-02 20:05:43"
    }
  ]
}
Kody błędów
400 invalid_request Ciało zapytania jest nieprawidłowe lub brakuje pola url.
400 invalid_url Podany URL nie jest prawidłowym adresem katalogu Vinted.
401 UNAUTHORIZED Brak lub nieprawidłowy klucz API.
500 internal_error Błąd po stronie serwera podczas pobierania danych z Vinted.
GET /api/v2/vinted/item/:id/details
1 kredyt

Pobiera szczegółowe informacje o konkretnym przedmiocie.

Jak używać

Podaj ID przedmiotu jako parametr ścieżki. ID możesz znaleźć w URL strony przedmiotu na Vinted (np. vinted.pl/items/8803132441-...). Endpoint zwraca pełne dane: zdjęcia, atrybuty, cenę z prowizją, informacje o sprzedawcy oraz status przedmiotu.

Czas odpowiedzi 0.4s – 0.65s
Transfer 2 kB – 4 kB
Parametry
id ścieżka string ID przedmiotu z Vinted (widoczne w URL strony przedmiotu). *
x-api-key nagłówek string <API_KEY> *
Przykładowe zapytanie 
curl -X GET "https://api.snajper.org/api/v2/vinted/item/8803132441/details" \
  -H "x-api-key: <API_KEY>"
Przykładowa odpowiedź 
{
  "id": 8803132441,
  "title": "iPhone 13 Pro",
  "price": "577.52 PLN",
  "service_fee": "31.78 PLN",
  "total_price": "609.3 PLN"
}
Kody błędów
400 MISSING_ITEM_ID Parametr id nie został podany w ścieżce.
401 UNAUTHORIZED Brak lub nieprawidłowy klucz API.
500 FETCH_ITEM_DETAILS_FAILED Nie udało się pobrać danych przedmiotu z Vinted.
GET /api/v2/vinted/user/:id/info
1 kredyt

Pobiera publiczny profil użytkownika Vinted.

Jak używać

Podaj ID użytkownika jako parametr ścieżki. ID sprzedawcy znajdziesz w odpowiedzi z endpointu /catalog lub /item/:id/details (pole seller_id). Endpoint zwraca pełne dane profilowe: historię ocen, liczbę przedmiotów, zniżki pakietowe, status online oraz dane weryfikacyjne konta.

Czas odpowiedzi 0.3s – 0.55s
Transfer 4 kB – 7 kB
Parametry
id ścieżka string ID użytkownika Vinted (pole seller_id w odpowiedzi katalogu lub szczegółów przedmiotu). *
x-api-key nagłówek string <API_KEY> *
Przykładowe zapytanie 
curl -X GET "https://api.snajper.org/api/v2/vinted/user/157416251/info" \
  -H "x-api-key: <API_KEY>"
Przykładowa odpowiedź 
{
  "user": {
    "id": 157416251,
    "login": "geaninasava",
    "feedback_count": 42,
    "item_count": 11
  }
}
Kody błędów
400 user_id_required Parametr id nie został podany w ścieżce.
401 UNAUTHORIZED Brak lub nieprawidłowy klucz API.
500 internal_error Nie udało się pobrać danych użytkownika z Vinted.

Masz pytania? skontaktuj się z nami.