Documentație Auction API

Prezentare

Auction API include informații despre anunțuri auto disponibile curent prin sursele de date activate. Datele includ specificații ale vehiculului, prețuri, detalii despre vânzător, locație, imagini, URL-uri ale anunțurilor și câmpuri de licitație când sunt disponibile.

API key-ul tău este emis separat și trebuie trimis ca parametrul GET api_key pe fiecare endpoint.

Acoperire

Anunțuri auto active disponibile în abonamentul tău și limitate de sursele de date activate.

Livrare

Datele sunt livrate cu query-uri Elasticsearch scroll, optimizate pentru procesarea în loturi a volumelor mari de date.

Sincronizare

Endpoint-ul stream returnează doar vehicule active curent și ne-arhivate.

Control acces

Fiecare request este validat prin API key, abonament activ, surse de date activate și IP whitelist când este activat.

Request HTTP

Endpoint

requestGET

stream cars

GEThttps://api.auctionsapi.com/cars?api_key=YOUR_API_KEY

Exemplu — Laravel / HTTP Client

Țintă:

Client:

SyncCars.php

1use Illuminate\Support\Facades\Http;2 3$response = Http::acceptJson()4    ->timeout(60)5    ->get('https://api.auctionsapi.com/cars', [6        'api_key' => 'YOUR_API_KEY',7    ]);8 9return $response->json();

Endpoint-uri API

GET/carsPas 1

Start sincronizare

Pornește sincronizarea

api_keylimitscroll_time

https://api.auctionsapi.com/cars?api_key=YOUR_API_KEY&limit=1000&scroll_time=10

GET/carsPas 2

Continuare sincronizare

Continuă sincronizarea

api_keyscroll_id

https://api.auctionsapi.com/cars?api_key=YOUR_API_KEY&scroll_id=SCROLL_ID

GET/search

Căutare

Căutare după cuvânt-cheie

api_keyquerypageperPagesort

https://api.auctionsapi.com/search?api_key=YOUR_API_KEY&query=toyota&page=1&perPage=20&sort=newest

GET/search

Căutare

Căutare filtrată

priceyearenumsbrands

https://api.auctionsapi.com/search?api_key=YOUR_API_KEY&price_from=5000&price_to=15000&currency_id=1&year_from=2015&year_to=2020&body_types[]=5&fuels[]=1&colors[]=13&transmission=1&drive_wheels[]=3&brands[0][id]=10&brands[0][models][]=101

GET/brands

Referință

Branduri

api_key

https://api.auctionsapi.com/brands?api_key=YOUR_API_KEY

GET/models/{brand_id}

Referință

Modele

brand_idapi_key

https://api.auctionsapi.com/models/58?api_key=YOUR_API_KEY

Flux de paginare

Începe cu /cars fără scroll_id.
Răspunsul include scroll_id și next_url.
Dacă next_url nu este gol, continuă să îl soliciți până devine gol sau API-ul nu mai returnează date.
Dacă un vehicul nu a fost returnat în ultimele 24 de ore, marchează-l ca arhivat sau șterge-l din baza ta.

Parametri GET

Parametru	Endpoint	Tip	Implicit / limite	Descriere
`api_key`	`Toate endpoint-urile`	`string`	Implicit: -	API key-ul tău unic. Trebuie trimis ca parametrul GET.
`scroll_time`	`/cars`	`int`	Implicit: 10 Limite: Max: 15 minute	Durata sesiunii scroll.
`limit`	`/cars`	`int`	Implicit: 1000 Limite: Max: 2000	Numărul de mașini per lot.
`scroll_id`	`/cars`	`string`	Implicit: -	Folosește-l pentru a obține următorul lot de date.
`page`	`/search`	`int`	Implicit: 1 Limite: Min: 1	Numărul paginii.
`perPage`	`/search`	`int`	Implicit: 50 Limite: Min: 2, Max: 50	Elemente per pagină.
`sort`	`/search`	`string`	Implicit: newest Limite: Vezi opțiunile de sortare	Ordinea sortării.
`query`	`/search`	`string`	Implicit: - Limite: Lungime max: 200	Query de căutare full-text.
`price_from`	`/search`	`int`	Implicit: - Limite: Min: 0	Preț minim, inclusiv.
`price_to`	`/search`	`int`	Implicit: - Limite: Min: 1	Preț maxim, inclusiv.
`currency_id`	`/search`	`int`	Implicit: - Limite: Min: 1	Moneda pentru filtrarea prețului. Ignorată dacă nu este oferit interval de preț.
`year_from`	`/search`	`int`	Implicit: - Limite: Min: 1800, Max: 3000	An model de la, inclusiv.
`year_to`	`/search`	`int`	Implicit: - Limite: Min: 1800, Max: 3000	An model până la, inclusiv.
`odometer_from`	`/search`	`int`	Implicit: - Limite: Min: 0, Max: 999999999	Odometru de la, inclusiv.
`odometer_to`	`/search`	`int`	Implicit: - Limite: Min: 0, Max: 999999999	Odometru până la, inclusiv.
`engine_volume_from`	`/search`	`int`	Implicit: - Limite: Min: 0, Max: 999999999	Volum motor de la, inclusiv.
`engine_volume_to`	`/search`	`int`	Implicit: - Limite: Min: 0, Max: 999999999	Volum motor până la, inclusiv.
`power_hp_from`	`/search`	`int`	Implicit: - Limite: Min: 0, Max: 100000	Cai putere de la, inclusiv.
`power_hp_to`	`/search`	`int`	Implicit: - Limite: Min: 1, Max: 100000	Cai putere până la, inclusiv.
`brands`	`/search`	`array<object>`	Implicit: - Limite: id, optional models[]	Filtru brand. Dacă modelele sunt omise, potrivește orice model din brandul selectat.
`body_types`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri tip caroserie.
`colors`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri culoare.
`fuels`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri combustibil.
`seller_type`	`/search`	`int`	Implicit: - Limite: Vezi enum	ID tip vânzător.
`steering_wheel_position`	`/search`	`int`	Implicit: - Limite: Vezi enum	ID poziție volan.
`transmission`	`/search`	`int`	Implicit: - Limite: Vezi enum	ID transmisie.
`airbags`	`/search`	`int`	Implicit: - Limite: Vezi enum	ID stare airbag.
`damages`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri daune.
`conditions`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri stare.
`availabilities`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri disponibilitate.
`emissions`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri standard emisii.
`drive_wheels`	`/search`	`int[]`	Implicit: - Limite: Vezi enum	ID-uri roți motrice.
`keys_available`	`/search`	`boolean`	Implicit: - Limite: true/false sau 1/0	Filtrează după disponibilitatea cheilor.
`brand_id`	`/models/{brand_id}`	`int`	Implicit: - Limite: Path parameter	Brand ID folosit pentru a returna modelele unui brand specific.

Opțiuni sortare

Valoare	Descriere
`newest`	Cele mai noi anunțuri primele.
`oldest`	Cele mai vechi anunțuri primele.
`cheaper`	Cel mai mic preț primul.
`expensive`	Cel mai mare preț primul.
`odometer_asc`	Cel mai mic odometru primul.
`odometer_desc`	Cel mai mare odometru primul.
`year_asc`	Cel mai vechi an model primul.
`year_desc`	Cel mai nou an model primul.
`auction_nearest`	Cea mai apropiată dată de licitație prima.

Array-uri și parametri imbricați

Array-uri simplecolors[]=13&colors[]=15&fuels[]=1&fuels[]=4

Branduri și modelebrands[0][id]=10&brands[0][models][]=101&brands[0][models][]=102&brands[1][id]=12

Dacă modelele sunt omise, filtrul potrivește orice model din brandul selectat. Pentru paginarea căutării, page * perPage trebuie să fie mai mic sau egal cu 10000.

Valori enum

Folosește ID-ul numeric în query parameters. De exemplu, colors[]=13 înseamnă alb, iar transmission=1 înseamnă automat.

Tipuri caroserie

body_types

1Sedan2Break3Coupe4Pickup5SUV6Cabrio7Van11Hatchback12Roadster13Limuzină20Liftback22Dric27Mașină sport

Culori

colors

1Argintiu2Mov3Portocaliu4Verde5Roșu6Auriu8Maro9Gri10Turcoaz11Albastru12Bronz13Alb14Crem15Negru16Galben17Bej18Roz100Două culori

Combustibili

fuels

1Diesel2Electric3Hibrid4Benzină5Gaz6Flexibil7Hidrogen8Etanol

Tip vânzător

seller_type

1Persoană fizică2Dealer

Poziție volan

steering_wheel_position

1Stânga2Dreapta

Transmisie

transmission

1Automată2Manuală

Airbaguri

airbags

1Intacte2Declanșate3Lipsă

Daune

damages

1Lateral2Furt3Arsură4Electric5Vandalizat6Apă7Plafon8Transmission9Suspensie10Biohazard11Program casare12Recuperare13Răsturnare14Peste tot15Motor16Șasiu17Față18Spate19Față și spate20Grindină21Mecanic22Lovituri/zgârieturi minore23VIN24Uzură normală25Reparație respinsă sau parțială26Furtună27Dezmembrat28Partea inferioară

Stări

conditions

1Folosit2Nou3Avariat

Disponibilitate

availabilities

1În stoc2În tranzit3La comandă

Emisii

emissions

1Euro 12Euro 23Euro 34Euro 45Euro 56Euro 67Zev

Roți motrice

drive_wheels

1Spate2Față3Integral

Răspuns JSON

Răspunsul include informații normalizate despre vehicul, date de listare, imagini, preț, locație, tip vânzător, stare, câmpuri de licitație și date de paginare pentru continuarea stream-ului.

Câmpuri răspuns

Parametru	Descriere
`data`	Array de înregistrări normalizate ale vehiculelor disponibile în abonamentul tău sau array gol când nu mai există date în stream.
`id`	Identificator intern AuctionsAPI pentru vehicul.
`brand / model`	Obiecte normalizate pentru marcă și model cu ID-uri și nume.
`engine_volume`	Cilindreea motorului când este disponibilă.
`body_type / transmission / fuel / color`	Obiecte enum normalizate cu ID și nume.
`listings`	Înregistrări de listare ale sursei cu URL-ul anunțului, titlu, preț, tip vânzător, imagini, date și status.
`external`	Identificatorul original al anunțului, placeholder-ul domeniului sursei și URL-ul anunțului.
`price`	Prețul anunțului, moneda, indicatorul de negociere și istoricul opțional al prețului.
`location`	Metadate de locație și coordonate când sunt disponibile.
`condition / damage / auction fields`	Stare, dată licitație, ofertă, chei, daune, stare airbag și câmpuri document când sunt disponibile.
`scroll_id`	Token de paginare returnat de endpoint-ul stream când sunt disponibile mai multe loturi.
`next_url`	URL gata de apelat pentru următorul lot. Oprește-te când este gol sau nu mai există date.
`hash`	Hash stabil al datelor normalizate ale vehiculului.
`message`	Returnat de endpoint-ul stream când nu mai există date.

Răspuns200 OK

application/json

1{2  "data": [3    {4      "id": "0z2OgJ0B0FUJVEfmXKRZ",5      "year": 2022,6      "vin": "wba5p9c02nfm40627",7      "brand": {8        "id": 16,9        "name": "BMW"10      },11      "model": {12        "id": 93,13        "name": "3er"14      },15      "body_type": {16        "name": "sedan",17        "id": 118      },19      "transmission": {20        "name": "automatic",21        "id": 122      },23      "transmission_steps": 5,24      "fuel": {25        "name": "gasoline",26        "id": 427      },28      "color": {29        "name": "grey",30        "id": 931      },32      "market_origin": {33        "name": "europe",34        "id": 135      },36      "drive_wheels": {37        "name": "all",38        "id": 339      },40      "badge": "330e xDrive Plug-In Hybrid - Leather - Sunroof !!",41      "listings": [42        {43          "external": {44            "id": "EXTERNAL_LISTING_ID",45            "domain": {46              "id": 1000,47              "name": "{domain.com}"48            },49            "url": "https://{domain.com}/vehicle-listing/example"50          },51          "archived": false,52          "title": {53            "en": "2022 BMW 3 Series 330e xDrive Plug-In Hybrid - Leather - Sunroof !!"54          },55          "odometer": 39650,56          "location": {57            "iso": "ca",58            "position": {59              "lon": -113.64258,60              "lat": 60.1086761            }62          },63          "images": [64            {65              "preview": "https://{image-domain.com}/vehicles/example-1-preview.jpg",66              "original": "https://{image-domain.com}/vehicles/example-1.jpg"67            },68            {69              "preview": "https://{image-domain.com}/vehicles/example-2-preview.jpg",70              "original": "https://{image-domain.com}/vehicles/example-2.jpg"71            },72            {73              "preview": "https://{image-domain.com}/vehicles/example-3-preview.jpg",74              "original": "https://{image-domain.com}/vehicles/example-3.jpg"75            },76            {77              "preview": "https://{image-domain.com}/vehicles/example-4-preview.jpg",78              "original": "https://{image-domain.com}/vehicles/example-4.jpg"79            },80            {81              "preview": "https://{image-domain.com}/vehicles/example-5-preview.jpg",82              "original": "https://{image-domain.com}/vehicles/example-5.jpg"83            }84          ],85          "video": null,86          "created_at": "2026-04-12T07:18:25.915404Z",87          "last_seen_at": "2026-04-29T07:59:47.901334Z",88          "updated_at": "2026-04-29T07:59:47.901337Z",89          "price": {90            "price": 30888,91            "currency": {92              "id": 28,93              "name": "cad"94            },95            "negotiable": false,96            "history": null97          },98          "seller_type": {99            "name": "dealer",100            "id": 2101          },102          "is_auction": false,103          "current_bid": null,104          "auction_at": null,105          "availability": null,106          "condition": {107            "name": "used",108            "id": 1109          },110          "keys_available": null,111          "damage": null,112          "second_damage": null,113          "airbag_state": null,114          "document_id": null,115          "description": "Sample 2022 BMW 330e xDrive Plug-In Hybrid listing with leather, sunroof, navigation, reverse camera, heated seats, and driver assistance features."116        }117      ],118      "hash": "60b52121bedf682865247f58ac068d217d2bc7d4dc3db88d2f7856b0dfa6e79e"119    }120  ],121  "scroll_id": "DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAx...",122  "next_url": "https://api.auctionsapi.com/cars?scroll_id=DXF1ZX...&api_key=YOUR_API_KEY"123}

Nu mai sunt date în stream

Răspuns200 OK

application/json

1{2  "scroll_id": null,3  "data": [],4  "message": "No more data"5}

Răspuns listă branduri

Răspuns200 OK

application/json

1[2  {3    "id": 9,4    "name": "Audi"5  },6  {7    "id": 13,8    "name": "Bentley"9  },10  {11    "id": 16,12    "name": "BMW"13  },14  {15    "id": 88,16    "name": "Mercedes-Benz"17  },18  {19    "id": 110,20    "name": "Porsche"21  }22]

Răspuns listă modele

Răspuns200 OK

application/json

1[2  {3        "id": 1665,4        "name": "X5",5        "generations": [6            {7                "name": "III (F15)",8                "from": 2013,9                "to": 201810            },11            {12                "name": "IV (G05)",13                "from": 2018,14                "to": 202215            },16            ...17        ]18    },19  {20    "id": 102,21    "name": "X6",22    "generations": []23  }24]

Răspunsuri eroare

error

Când apare o eroare, API-ul returnează un status de eroare cu un cod și mesaj.

Cod	Descriere	Rezolvare
`400`	scroll_time trebuie să fie mai mic de 15.	Folosește scroll_time până la 15 minute.
`400`	limit trebuie să fie mai mic de 2000.	Folosește limit până la 2000 mașini per lot.
`403`	te rugăm să adaugi api_key în parametrul GET.	Adaugă api_key ca parametrul GET.
`403`	api key greșit.	Verifică dacă API key-ul este valid.
`403`	abonamentul tău API nu este activ.	Activează sau reînnoiește abonamentul.
`403`	adresa IP nu este în whitelist.	Trimite request-ul de pe un IP permis sau actualizează whitelist-ul.
`403`	nu ai date în abonament.	Asigură-te că sursele de date sunt activate pentru abonament.
`422`	page * perPage depășește 10000 pentru search și API-ul returnează offset error.	Redu page sau perPage ca offset-ul să rămână în limita 10000.
`500`	Eroare neașteptată de server.	Reîncearcă request-ul sau contactează suportul dacă problema persistă.

Auction APIDocumentație

Prezentare

Acoperire

Livrare

Sincronizare

Control acces

Request HTTP

Pornește sincronizarea

Continuă sincronizarea

Căutare după cuvânt-cheie

Căutare filtrată

Branduri

Modele

Parametri GET

Tipuri caroserie

Culori

Combustibili

Tip vânzător

Poziție volan

Transmisie

Airbaguri

Daune

Stări

Disponibilitate

Emisii

Roți motrice

Răspuns JSON

Răspunsuri eroare