Czy Vinted ma API? Kanał ogłoszeń dla serwerów Discord i aplikacji do odsprzedaży

Jeśli prowadzisz serwer Discord poświęcony sourcingowi, aplikację do odsprzedaży albo mały SaaS dla sprzedających na Vinted, w gruncie rzeczy potrzebujesz zawsze tego samego: stałego dopływu nowych ogłoszeń Vinted, które pasują do tego, czego szukają Twoi członkowie lub klienci. Pierwsze pytanie większości osób brzmi, czy Vinted ma do tego API.

Nie udostępnia otwartego. Vinted nie oferuje publicznego API do odczytu nowych ogłoszeń, więc większość zespołów kończy na pisaniu scrapera. Przez jakiś czas to działa. Potem przychodzi utrzymanie: proxy, zablokowane żądania, zmiana strony, która w niedzielę psuje Twój parser, i osobna konfiguracja dla każdego dodawanego kraju.

Vinotify to niezależna usługa, która robi tę część za Ciebie. Zapisujesz wyszukiwania, Vinotify obserwuje je dla Ciebie i przekazuje nowe dopasowania przez kanał REST, webhooki lub MCP. To Twój serwer lub aplikacja decyduje, co z nimi zrobić.

Własny scraper czy kanał?

Jeśli masz już działający scraper i lubisz go utrzymywać, zostaw go. Poniższa tabela jest dla zespołów, które wolą poświęcić ten czas swoim członkom lub produktowi.

Jedna rzecz musi być jasna: to nie jest pełna kopia Vinted. Dostajesz nowe ogłoszenia pasujące do Twoich zapisanych wyszukiwań, a nie każdy przedmiot z serwisu. Dla serwera sourcingowego lub produktu z alertami zwykle i tak o to chodzi.

Co zawiera kanał

Każde zapisane wyszukiwanie ma własny strumień zdarzeń. Zdarzenie zawiera jedno lub więcej nowych ogłoszeń, a każde ogłoszenie może zawierać identyfikator przedmiotu, tytuł, markę, rozmiar, stan, cenę, walutę, adres URL Vinted i zdjęcie. Zdarzenie podaje też wyszukiwanie, rynek i moment, w którym Vinotify je znalazł.

• Płatne wyszukiwania dostają natychmiastowe alerty, więc dopasowanie dociera do Ciebie krótko po wystawieniu.
• Wyszukiwania mogą filtrować według słów kluczowych, kategorii, marki, rozmiaru, stanu, ceny, wykluczonych słów i zablokowanych sprzedawców.
• Twój kod może tworzyć, aktualizować, wstrzymywać, wznawiać i usuwać wyszukiwania za pomocą tokena z uprawnieniami do zapisu, dzięki czemu członkowie lub klienci mogą zarządzać własnymi wyszukiwaniami z poziomu Twojego bota lub aplikacji.
• Kanał nie zawiera nazw sprzedawców ani profili. Dostajesz ogłoszenie, a nie osobę, która za nim stoi.

Nazwy pól, limity i kody błędów znajdziesz w dokumentacji dla deweloperów.

Podłączenie do serwera Discord

Payload Vinotify nie ma formatu webhooków Discorda, więc potrzebny jest mały pomost pośrodku. Najprostsza wersja odczytuje kanał zdarzeń jednego wyszukiwania i publikuje każde nowe ogłoszenie w webhooku kanału Discord:

import os, requests

API = "https://vinotify.me/api/v1/integrations"
HEADERS = {"Authorization": f"Bearer {os.environ['VINOTIFY_TOKEN']}"}
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]
SEARCH_ID = 42

cursor, seen = "0-0", set()
while True:
    r = requests.get(f"{API}/events", headers=HEADERS, timeout=40,
                     params={"search_id": SEARCH_ID, "cursor": cursor, "wait": 30})
    if r.status_code == 410:          # cursor older than 48 hours
        cursor = "0-0"
        continue
    r.raise_for_status()
    body = r.json()
    for event in body["events"]:
        if event["event_id"] in seen:
            continue
        seen.add(event["event_id"])
        for item in event["items"]:
            embed = {"title": item["title"], "url": item["url"],
                     "description": f"{item['price']} {item['currency']}"}
            if item.get("photo"):
                embed["image"] = {"url": item["photo"]}
            requests.post(DISCORD, json={"embeds": [embed]}, timeout=10)
    cursor = body["next_cursor"]

To szkic, a nie gotowy bot. Prawdziwy bot zapisuje kursor na dysku, żeby restart nie powtarzał starych przedmiotów, czeka na Retry-After, gdy dostanie 429, i obsługuje jeden kanał na wyszukiwanie. Token pozwala na 12 jednoczesnych long polli i 240 żądań na minutę, więc przy większej liczbie wyszukiwań odpytuj każde po kolei bez wait.

Jeśli wolisz, żeby to Vinotify wywoływało Ciebie, ustaw zamiast tego cel webhooka przy każdym wyszukiwaniu. Push jest szybszy, ale nie jest ponawiany, dlatego większość serwerów uruchamia równolegle także kanał. Poradnik o webhookach opisuje oba rozwiązania.

Ile to kosztuje

Kanał, webhooki i MCP są w planie Pro: €22.99 miesięcznie w UE, £19.99 w Wielkiej Brytanii i $19.99 w USA, za 100 wyszukiwań z natychmiastowymi alertami. Wychodzi to około 23 centy za wyszukiwanie. Wyszukiwanie obserwujące więcej niż jeden rynek liczy się raz na każdy rynek.

Jeśli potrzebujesz więcej niż 100 wyszukiwań, napisz na support@vinotify.me. Większe limity ustalane są dla każdego konta osobno. Pełne szczegóły planów znajdziesz na stronie z cennikiem.

Zachowaj jasną granicę

Vinotify nie jest powiązany z Vinted. Obserwuje publiczne ogłoszenia dla Twoich zapisanych wyszukiwań. Nigdy nie prosi o login do Vinted, nie loguje się na niczyje konto i niczego nie kupuje, nie wysyła wiadomości ani nie dodaje do ulubionych w czyimkolwiek imieniu.

Ogłoszenia należą do osób, które je opublikowały. Linkuj każdy post do oryginalnego ogłoszenia, przechowuj tylko to, czego potrzebuje Twoja usługa, i sprawdź, czy Twoje użycie jest zgodne z regulaminem Vinted i prawem w kraju, w którym działasz. Ta część należy do Ciebie.

Na początek załóż konto Pro, dodaj kilka wyszukiwań i utwórz token tylko do odczytu na stronie Integracje. Przegląd automatyzacji przeprowadzi Cię przez pierwsze wywołania.