Docs

API referencaWidgeti

Lista widgeta

Objavljena vozila, od najnovijeg, po stranicama; po vašoj oznaci nađete public_id za predložak stranice.

GEThttps://api.cifra.ba/v1/widgets
Pristup
widgets
Obračun
Besplatno
GET/v1/widgets
curl "https://api.cifra.ba/v1/widgets?external_ref=LAG-0412" \
  -H "Authorization: Bearer $CIFRA_API_KEY"
Odgovor
{
  "object": "list",
  "data": [
    {
      "id": "wgt_7Hq2Lm9PzX4cV1bN8sKd",
      "object": "widget",
      "public_id": "k3M9xQ2vTa",
      "status": "active",
      "source": "valuation",
      "report_id": null,
      "valuation_id": "val_8fK2mQ9xLp4TvB7nR1sW",
      "external_ref": "LAG-0412",
      "title": null,
      "vehicle": {
        "vehicle_type": "car",
        "make": "volkswagen",
        "model": "golf_7",
        "make_name": "Volkswagen",
        "model_name": "Golf 7",
        "year": 2017,
        "mileage_km": 148000,
        "fuel": "diesel",
        "transmission": "manual",
        "power_kw": 85
      },
      "asking_price": 23900,
      "value": {
        "currency": "BAM",
        "point": 25750,
        "low": 22600,
        "high": 28900,
        "confidence_grade": "B",
        "as_of": "2026-10-21"
      },
      "rating": {
        "level": "good",
        "pct": -7.18,
        "diff_bam": -1850
      },
      "embed": {
        "page_url": "https://www.cifra.ba/w/k3M9xQ2vTa",
        "script": "<div data-cifra-widget=\"price\" data-id=\"k3M9xQ2vTa\"></div>\n<script async src=\"https://www.cifra.ba/widget.js\"></script>",
        "iframe": "<iframe src=\"https://www.cifra.ba/embed/k3M9xQ2vTa/price\" title=\"Cifra — Cijena i tržišna vrijednost\" width=\"100%\" height=\"236\" style=\"border:0;max-width:100%\" loading=\"lazy\"></iframe>"
      },
      "sold_at": null,
      "created_at": "2026-10-21T09:14:02.511Z",
      "updated_at": "2026-10-21T09:14:02.640Z"
    }
  ],
  "has_more": false
}

Parametri upita

  • external_refstringopcionalnodo 80 znakova

    Samo widget s ovom vašom oznakom.

  • statusenumopcionalno

    Samo widgeti u ovom stanju (bez polja: svi osim uklonjenih).

    activepausedsold
  • limitintegeropcionalnopodrazumijevano 501 – 100

    Koliko po stranici.

  • starting_afterstringopcionalnodo 64 znaka

    id zadnjeg widgeta prethodne stranice.

Odgovor

200
  • objectstringobavezno

    list.

  • dataobject[]obavezno

    Widgeti, od najnovijeg.

    Prikaži 17 polja
    • idstringobavezno

      Oznaka (wgt_…).

    • objectstringobavezno

      widget.

    • public_idstringobavezno

      Javni kod u adresi widgeta (cifra.ba/embed/<public_id>/…, cifra.ba/w/<public_id>); ide u vašu stranicu.

    • statusenumobavezno

      active, paused ili sold (oglas s Cifrine platforme je skinut: widgeti kažu „Prodano”).

      activepausedsold
    • sourceenumobavezno

      Iz API procjene ili izvještaja s platforme.

      valuationreport
    • report_idstringobavezno

      Izvještaj s platforme, kad je odatle objavljen.

    • valuation_idstringobavezno

      API procjena iz koje je objavljen.

    • external_refstringobavezno

      Vaša oznaka.

    • titlestringobavezno

      Naziv na widgetu (null: marka, model i godište).

    • vehicleobjectobavezno

      Vozilo.

      Prikaži 10 polja
      • vehicle_typeenumobavezno

        Vrsta vozila.

        carmotorcycletruck
      • makestringobavezno

        Šifra marke.

      • modelstringobavezno

        Šifra modela.

      • make_namestringobavezno

        Marka.

      • model_namestringobavezno

        Model.

      • yearintegerobavezno

        Godište.

      • mileage_kmintegerobavezno

        Kilometraža.

      • fuelstringobavezno

        Gorivo.

      • transmissionstringobavezno

        Mjenjač.

      • power_kwnumberobavezno

        Snaga u kW.

    • asking_priceinteger | nullobavezno

      Tražena cijena u KM.

    • valueobject | nullobavezno

      Zadnja jutarnja procjena.

      Prikaži 6 polja
      • currencystringobavezno

        BAM.

      • pointintegerobavezno

        Tržišna vrijednost (standardni model, nezavisan od modela vaše kompanije).

      • lowinteger | nullobavezno

        Donja granica raspona.

      • highinteger | nullobavezno

        Gornja granica raspona.

      • confidence_gradeenum | nullobavezno

        Ocjena pouzdanosti: A najuži rasponi za takva vozila, C najširi (rijetki modeli, malo podataka, nepotpun unos).

        ABC
      • as_ofstring | nullobavezno

        Dan, YYYY-MM-DD.

    • ratingobject | nullobavezno

      Ocjena kakvu widget prikazuje; null bez cijene, za prodano vozilo ili cijenu daleko van tržišta.

      Prikaži 3 polja
      • levelenumobavezno

        Ocjena cijene: great odlična, good dobra, fair fer, high povišena, over visoka.

        greatgoodfairhighover
      • pctnumberobavezno

        Tražena cijena naspram vrijednosti, u %.

      • diff_bamintegerobavezno

        Razlika u KM (negativna: ispod vrijednosti).

    • embedobjectobavezno

      Gotov kod; druge vrste: data-cifra-widget="badge|market|comparables|forecast|factors|mileage|report".

      Prikaži 3 polja
      • page_urlstringobavezno

        Stranica vozila za kupce, s cijelim izvještajem.

      • scriptstringobavezno

        Kod widgeta „Cijena” sa skriptom (preporučeno).

      • iframestringobavezno

        Isti widget kao iframe.

    • sold_atstring | nullobavezno

      Trenutak u ISO 8601 (UTC).

    • created_atstringobavezno

      Trenutak u ISO 8601 (UTC).

    • updated_atstringobavezno

      Trenutak u ISO 8601 (UTC).

  • has_morebooleanobavezno

    Ima li još stranica.

Greške

  • 400
    invalid_request

    Tijelo ili parametri ne odgovaraju šemi; errors navodi svako polje.

  • 403
    organization_required

    Ključ pripada klijentu koji nije vezan za kompaniju; widgeti su kompanijini.

Uz ove, svaki poziv s ključem može vratiti opšte greške (ključ, pristup, limiti).