API

Autovit API: oferty samochodów w JSON

Autovit nie udostępnia otwartego API dla programistów. Tutaj wraca to, co serwis pokazuje publicznie — marka, model, rocznik, przebieg i cena — w formacie JSON. Zakres jest celowo wąski i piszemy to od razu: obsługiwane są zweryfikowane oferty osobowe dla marek BMW i Volkswagen.

Endpointy

endpointCo zwracaWymagane
searchWyszukiwanie zweryfikowanych ofert samochodów osobowych według marki.make
product/detailPełny rekord jednej publicznej oferty pojazdu z jej identyfikatora.listing_id

Każde wywołanie jest rozliczane w kredytach. Nieudane i zablokowane wywołania są darmowe.

Działający przykład

Zakres jest ograniczony do dwóch marek i mówimy o tym wprost, zamiast pozwolić, żeby puste wyniki dla innej marki wyglądały jak awaria. Jeśli potrzebujesz szerszego pokrycia rynku polskiego, Otomoto obejmuje wszystkie sekcje.

Żądanie
curl -X POST https://api.reefapi.com/autovit/v1/search \
  -H "x-api-key: TWOJ_KLUCZ" \
  -H "content-type: application/json" \
  -d '{"make": "bmw"}'
Odpowiedź (skrócona)
{
  "ok": true,
  "data": {
    "results": [
      {
        "listing_id": "...",
        "title": "BMW ...",
        "year": 2019,
        "mileage_km": 98000,
        "price": 89900,
        "currency": "PLN"
      }
    ]
  },
  "meta": { "record_count": 20, "cache_hit": false, "mode": "live" }
}

Zamiast własnego scrapera Autovit

Własny scraper Autovit na początku działa. Potem pojawia się to, czego nie widać: zmiana układu listy sprawia, że parser zwraca pustkę zamiast błędu, a przy dłuższym przebiegu wchodzi ochrona przed botami.

Tutaj utrzymanie jest po naszej stronie: przy zmianie schematu poprawiamy silnik, przy blokadzie wraca kod błędu i takie wywołanie nie jest płatne.

Do jednorazowego sprawdzenia własny skrypt wyjdzie taniej. Przy monitoringu, który ma chodzić regularnie, płaci się za awarie, nie za kod.

Ograniczenia i uczciwe uwagi

  • To nie jest oficjalne API Autovit i nie mamy z Autovit partnerstwa.
  • 🔴 Obsługiwane są zweryfikowane oferty osobowe dla marek BMW i Volkswagen. Dla innych marek wynik będzie pusty — to zakres, nie awaria.
  • Jeśli ogłoszenie nie podaje przebiegu albo rocznika, pole wraca jako null.
  • Nie ma cache: każde wywołanie pokazuje stan z momentu zapytania.