Alcopa Auction APIScraper & Parser
Alcopa Auction API: lote ankandi francez makinash me çmim fillestar e ofertë aktuale, VIN, defekte, dokumente, foto. Ndryshimet për lot, gjithë stoku çdo ditë.
Alcopa Auction API
Parser-i dhe scraper-i për Alcopa Auction punojnë në anën tonë, dhe ju merrni përmes API-së lote nga ankandi francez i makinave, gati për përdorim: çmimin fillestar ose ofertën aktuale, datën dhe vendin e shitjes, specifikimet, numrin VIN, defektet me foto, dokumentet dhe fotot e automjetit. Fluksi i ndryshimeve ju njofton për lotet e reja, çmimet e reja dhe lotet e mbyllura bashkë me arsyen.
Fluksi i ndryshimeve njofton për çdo lot të ri në Alcopa Auction, çmim të ri ose ofertë të re dhe lot të mbyllur.
Një skedar në ditë me çdo lot të hapur në Alcopa Auction.
Çmimi dhe oferta, ankand në sallë ose shitje online, data e shitjes, viti i regjistrimit, kilometrazhi, vëllimi i motorit dhe fuqia, transmisioni, numri VIN dhe numri i regjistrimit, CO2, TVSH e rikuperueshme, garancia, defektet e karrocerisë, dokumentet dhe fotot.
URL bazë
https://{access_name}.auto-api.com/api/v2/alcopaAutorizimi: api_key parametër
Rrjedha e punës
/filtersmerrni vlerat e disponueshme të filtrave/offersmerrni shpallje (me ose pa filtra) - përdoreni për ngarkimin fillestar të të dhënavePër përditësime (që t'i mbani të dhënat të përditësuara pas ngarkimit fillestar):
/change_id?date=...merrni ID-në fillestare për fluksin e ndryshimeve/changes?change_id=...merrni të gjitha ndryshimet në bazën e të dhënave duke filluar nga ID-ja/offermerrni të dhënat e një shpalljeje të caktuar sipas inner_idNga të filloni:
1. Së pari, thirrni /change_id me datën e sotme sipas orës së Parisit dhe ruani përgjigjen; nëse kthen 0, provoni sërish pak më vonë. Pastaj merrni çdo faqe të /offers derisa next_page të kthehet null.
2. Më pas, lexoni /changes duke filluar nga ID-ja e ruajtur dhe dërgoni next_change_id nga çdo përgjigje: kështu merrni lotet e reja, çmimet dhe ofertat e reja, si dhe lotet e mbyllura bashkë me arsyen. Nëse next_change_id kthehet null, ende nuk ka ngjarje të reja: përsëriteni kërkesën më vonë me të njëjtën ID.
3. Për të gjetur makina me porosi, thirrni /offers me filtra sipas markës, modelit, vitit, kilometrazhit, çmimit, karburantit, transmisionit, kategorisë së automjetit dhe ngjyrës.
GET/filters
Kthen të gjitha vlerat e mundshme për filtrim
https://{access_name}.auto-api.com/api/v2/alcopa/filters?api_key=YOUR_API_KEYPërgjigjja:
{
"mark": {
"PEUGEOT": {
"model": ["108", "2008", "208", "3008", "308", "5008", "508", "BOXER FOURGON", "EXPERT FOURGON", "PARTNER FOURGON"]
},
"RENAULT": {
"model": ["ARKANA", "CAPTUR", "CLIO V", "KANGOO", "MEGANE IV BERLINE", "TRAFIC FOURGON", "TWINGO III"]
},
"CITROEN": {
"model": ["BERLINGO", "C3", "C3 AIRCROSS", "C4", "C5 AIRCROSS", "JUMPY FOURGON"]
}
},
"transmission_type": ["Automatic", "Manual", "Sequential"],
"color": ["Beige", "Black", "Blue", "Brown", "Dark blue", "Dark grey", "Green", "Grey", "Light blue", "Light grey", "Orange", "Red", "Unknown", "White"],
"body_type": ["Commercial vehicle", "Passenger car", "Special purpose vehicle", "Van"],
"engine_type": ["Diesel", "Electric", "Ethanol (E85)", "Hybrid", "Petrol", "Petrol + LPG", "Plug-in hybrid"]
}GET/offers
Lista e shpalljeve me faqosje dhe filtra
Parametrat:
page(i detyrueshëm) - numri i faqesmark, model- marka dhe modeli, siç shkruhen në /filterstransmission_type, color, body_type, engine_type- transmisioni, ngjyra, kategoria e automjetit dhe karburanti, pa dallim midis shkronjave të mëdha dhe të voglayear_from, year_to- intervali i vitit të regjistrimit të parëkm_age_from, km_age_to- intervali i kilometrazhit, kmprice_from, price_to- intervali i çmimit të lotit, euro
https://{access_name}.auto-api.com/api/v2/alcopa/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/alcopa/offers?api_key=YOUR_API_KEY&page=1&mark=Peugeot&model=308&year_from=2018&km_age_to=150000&engine_type=DieselPërgjigjja:
{
"result": [
{
"id": 1018,
"inner_id": "2910153",
"change_type": "added",
"created_at": "2026-09-30T15:43:04.158+03:00",
"data": {
"id": "1018",
"inner_id": "2910153",
"url": "https://www.alcopa-auction.fr/utilitaire-occasion/peugeot/308-bluehdi-130ch-s-s-bvm6-active-1119135",
"mark": "PEUGEOT",
"model": "308",
"complectation": "308 BLUEHDI 130CH S&S BVM6 ACTIVE",
"title": "PEUGEOT 308 BLUEHDI 130CH S&S BVM6 ACTIVE",
"year": "2019",
"price": "7000",
"km_age": "82751",
"color": "Blue",
"engine_type": "Diesel",
"body_type": "Passenger car",
"transmission_type": "Manual",
"displacement": "1499",
"horse_power": "130",
"vin": "VF3LBYHZPKS060872",
"condition": "",
"description": "sans roue de secours - euro 6",
"region": "Beauvais",
"images": "[\"https://photos.static.alcopa-auction.net/photos/2609/26091100167/internalCropped/PEUGEOT_308_251e1ed0e94e3c774aaf3c74.jpg\", \"https://photos.static.alcopa-auction.net/photos/2609/26091100167/internalCropped/PEUGEOT_308_bb42b3241c4495ea67690600.jpg\"]",
"extra_prep": {
"product_id": "1119135",
"sale_id": "13052",
"sale_site": "Internet",
"is_online_sale": true,
"sale_date": "2026-09-30",
"sale_start": "2026-09-28T19:00:00+02:00",
"bidding_end": "2026-09-30T16:00:00Z",
"lot_number": 1071,
"price_type": "current_bid",
"fees_included": true,
"bid_step": 100,
"in_preparation": false,
"non_roulant": false,
"pro_only": false,
"plate": "GC488AJ",
"first_registration": "2019-03-29",
"co2": 92,
"vat_recoverable": false,
"vehicle_type": "TOURISME",
"engine_hours": null,
"fiscal_power": null,
"warranty": "Garantie Sérénité de 3 mois incluse",
"battery_soh": null,
"damages": [
{ "type": "P", "zone": "JAVG", "type_label": "Peinture", "zone_label": "Jante avant gauche" },
{ "type": "P", "zone": "AAVG", "type_label": "Peinture", "zone_label": "Aile avant gauche" }
// ... other damages
],
"damage_images": ["https://photos.static.alcopa-auction.net/photos/2609/26091100167/damages/2534668b56b764b8c1045955.jpg"],
"documents": {
"technical_inspection": "https://www.alcopa-auction.fr/getDocument/ct/bHgyWlRPaEV1N20rM3FTNDZqZVk0dz09",
"vehicle_history": "https://api.b2b.autorigin.com/api/numberplate/ys8QGUQ2Vc/pdf?user=21&token=..."
}
}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Fushat e rekordit
- id - numri i rekordit në bazën tonë të të dhënave; përdorni inner_id për ta lidhur me lotin
- inner_id - identifikuesi i lotit në Alcopa Auction; një makinë e nxjerrë në dy shitje ka dy lote dhe dy vlera inner_id
- url - lidhja e lotit në alcopa-auction.fr
- mark, model - marka dhe modeli, p.sh. PEUGEOT dhe 308
- complectation - versioni nga katalogu i ankandit: modeli, motori dhe varianti në një rresht
- title - titulli i lotit, marka plus versioni
- year - viti i regjistrimit të parë; për makineritë, viti i prodhimit
- price - oferta aktuale ose çmimi fillestar në euro, fusha price_type tregon cila nga dy vlerat është; -1 derisa ankandi të caktojë një çmim
- km_age - kilometrazhi në km; bosh kur kilometrazhi është i panjohur
- color - ngjyra e karrocerisë, vlera nga /filters; emrat e rrallë dhe ata specifikë të prodhuesve vijnë siç janë shkruar në faqen e internetit
- engine_type - lloji i karburantit, vlera nga /filters
- body_type - kategoria e automjetit nga certifikata e regjistrimit, vlera nga /filters
- transmission_type - lloji i transmisionit, vlera nga /filters
- displacement - vëllimi i motorit në cc; bosh për makinat elektrike ose kur vëllimi nuk është shënuar
- horse_power - fuqia në hp, e marrë nga emri i versionit, p.sh. BLUEHDI 130 jep 130; te makinat hibride me dy shifra të tilla, fuqia e motorit me djegie të brendshme; bosh kur versioni nuk ka shifër
- vin - VIN i plotë; për makineritë, numri serial
- condition - shënimet e ankandit për defekte: dritë paralajmëruese në panelin e instrumenteve, zhurmë motori, lëng ftohës ose friksion për t'u kontrolluar, dëmtime nga breshri e të tjera
- description - komenti i ankandit për lotin: kur do të dorëzohet certifikata e regjistrimit, klasa e emetimeve, cilat elemente mungojnë dhe shënime të tjera
- region - salla e ankandit ose depoja e shitjeve online ku ruhet makina; vetë vendi i shitjes është në fushën sale_site
- images - lidhjet e fotove si varg JSON brenda një string-u
- extra_prep - objekt i ndërfutur me të dhëna për shitjen dhe gjendjen, përshkruar më poshtë; vlerat që mungojnë vijnë si null
Brenda extra_prep
- product_id - identifikuesi i automjetit në faqen e internetit; dy lote me të njëjtën vlerë product_id i referohen së njëjtës makinë
- sale_id - identifikuesi i shitjes
- sale_site - vendi i shitjes: emri i sallës së ankandit, ose Internet për një shitje online
- is_online_sale - true për një shitje online
- sale_date - data e shitjes
- sale_start - fillimi i ankandit në sallë ose hapja e ofertimit online, ora me zonën kohore
- bidding_end - afati për ofertat online: mbyllja e një shitjeje online ose fundi i ofertimit paraprak përpara një ankandi në sallë, ora me zonën kohore; null kur ankandi nuk tregon afat
- lot_number - numri i pozicionit në katalogun e shitjes; null derisa ankandi ta numërtojë katalogun
- price_type - current_bid kur fusha price mban ofertën aktuale, starting_price kur mban çmimin fillestar
- fees_included - true kur tarifat e ankandit janë tashmë të përfshira në çmim, si në shitjet online; në ankandet në sallë tarifat shtohen mbi çmim
- bid_step - hapi minimal i ofertës në euro për lotet me ofertim online
- in_preparation - false: API-ja përfshin vetëm lotet që ankandi i ka përgatitur tashmë për shitje, me foto, defekte dhe dokumente kur janë të disponueshme
- non_roulant - true kur makina nuk është në gjendje të lëvizë; lote të tilla janë të disponueshme vetëm për profesionistët e tregtisë së makinave
- pro_only - true kur vetëm profesionistët e tregtisë së makinave mund të bëjnë oferta për lotin
- plate - numri i regjistrimit
- first_registration - data e regjistrimit të parë
- co2 - emetimet e CO2, g/km
- vat_recoverable - true kur TVSH-ja e makinës është e rikuperueshme
- vehicle_type - seksioni i ankandit: TOURISME autovetura, UTILITAIRES automjete komerciale, MATÉRIEL makineri, nga pirunë ngritës deri te rimorkio
- engine_hours - orët e punës së motorit për makineritë
- fiscal_power - fuqia fiskale e motoçikletave si string me njësinë, p.sh. 4 CV
- warranty - garancia e ankandit e përfshirë në lot: programi dhe afati; null kur nuk ka garanci
- battery_soh - kapaciteti i mbetur i baterisë së një makine elektrike ose hibride në përqind, nga certifikata; null kur nuk ka certifikatë
- damages - defektet e karrocerisë: secili me zonën dhe llojin e riparimit, si kod dhe si emër; llojet e riparimit janë P lyerje, TP punime llamarine dhe lyerje, T heqje gropëzash, RP ndërrim
- damage_images - fotot e defekteve
- documents - lidhjet e dokumenteve të lotit: technical_inspection për raportin e kontrollit teknik, battery_certificate për certifikatën e gjendjes së baterisë, vehicle_history për raportin e historikut të automjetit; të vlefshme sa kohë që loti është në shitje
GET/change_id
Merrni ID-në e parë të ndryshimit sipas datës (për përdorim në /changes)
Parametrat:
date(i detyrueshëm) - data në formatin yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/alcopa/change_id?api_key=YOUR_API_KEY&date=2026-09-30Përgjigjja:
{ "change_id": 4816 }Përdorni vlerën e kthyer si parametrin change_id në /changes
GET/changes
Fluksi i ndryshimeve (të shtuara/të ndryshuara/të hequra)
Parametrat:
change_id(i detyrueshëm) - nga cila ID ndryshimi të fillohet
https://{access_name}.auto-api.com/api/v2/alcopa/changes?api_key=YOUR_API_KEY&change_id=4816Përgjigjja:
{
"result": [
{
"id": 4816,
"inner_id": "2906621",
"change_type": "added", // added - new lot
"created_at": "2026-09-30T18:24:51.302+03:00",
"data": { ... } // full lot data, as in /offers
},
{
"id": 4817,
"inner_id": "2910153",
"change_type": "changed", // changed - new bid or starting price, EUR
"created_at": "2026-09-30T18:25:07.118+03:00",
"data": { "new_price": 7100 }
},
{
"id": 4818,
"inner_id": "2891028",
"change_type": "removed", // removed - lot closed: sold, ended or gone
"created_at": "2026-09-30T18:26:40.655+03:00",
"data": { "removed_reason": "sold" }
}
],
"meta": { "cur_change_id": 4816, "next_change_id": 4819, "limit": 20 }
}Një ngjarje removed me arsyen në fushën removed_reason: sold nëse loti është shitur, ended nëse shitja ka përfunduar ose loti është ripublikuar pa u shënuar një shitje, gone nëse loti është hequr nga faqja e internetit. E njëjta makinë mund të nxirret në shitje njëkohësisht në një ankand në sallë dhe online; këto janë dy lote me çmimet dhe datat e veta, dhe fusha product_id i lidh ato.
GET/offer
Një shpallje e vetme sipas inner_id
Parametrat:
inner_id(i detyrueshëm)
https://{access_name}.auto-api.com/api/v2/alcopa/offer?api_key=YOUR_API_KEY&inner_id=2910153Përgjigjja: objekti data (i njëjtë si në /offers, por pa mbështjellësin result)
Ruajtja
Skedarët mbeten të disponueshëm të paktën 3 ditë
Disponueshmëria
Skedarë të rinj çdo mëngjes
Formati CSV
Kolonat në CSV ndahen me vijën vertikale (|)
Struktura e URL-së:
Parametrat:
access_name- nëndomeni juaj personaldate- data e eksportimit në formatin yyyy-mm-dd, p.sh. 2026-09-30file_name- emri i skedarit me prapashtesë
Skedarët e disponueshëm:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Shembull kërkese me cURL
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvShembull komande me Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Alcopa Auction (alcopa-auction.fr) është prej disa vitesh ankandi më i madh i makinave në Francë për nga xhiroja, me salla ankandi në Beauvais, Rennes, Tours, Nancy, Lyon, Marseille dhe pranë Parisit, si dhe me shitje online ditore. Makinat vijnë nga kompanitë e lizingut, bankat, prodhuesit e makinave me rrjetet e tyre të tregtarëve dhe flotat e kompanive, kështu që katalogu përbëhet kryesisht nga makina të kthyera nga lizingu dhe nga flotat.
Shitjet zhvillohen në dy mënyra. Në sallat e ankandit, lotet dalin në ankand në një ditë të caktuar, dhe mund të lini një ofertë online para se të fillojë shitja; atje tarifat e ankandit shtohen mbi çmim. Në shitjet online, ofertat pranohen deri në orën e shpallur të mbylljes, dhe tarifat e ankandit janë tashmë të përfshira në çmim. Disa lote, përfshirë automjete që nuk janë në gjendje të lëvizin, u shiten vetëm profesionistëve të tregtisë së makinave.
Për një importues, kjo është një mënyrë për të blerë makina para se të shtohet marzhi i tregtarit dhe për të gjykuar gjendjen e tyre nga skema e defekteve, raporti i kontrollit teknik dhe raporti i historikut, kur ankandi i ka bashkëngjitur. Lotet e reja të modelit që ju duhet vijnë si ngjarje në fluks. Me numrin VIN, datën e regjistrimit të parë, vëllimin e motorit dhe fuqinë mund të përllogaritni paraprakisht detyrimet doganore dhe tarifat e importit, ndërsa treguesi për TVSH-në e rikuperueshme tregon cilat lote dalin më lirë kur eksportohen jashtë BE-së.
Lotet e reja, çmimet dhe ofertat e reja, si dhe lotet e mbyllura bashkë me arsyen, vijnë përmes /changes. Për këtë nuk ju duhet një parser i juaji.
Zgjeroni mbulimin e të dhënave tuaja automobilistike në tregjet botërore me API-të tona të platformave: