Alcopa Auction APIScraper & Parser

GET/filters

Връща всички възможни стойности за филтриране

Отговор:

{
  "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

Списък с обяви със страниране и филтри

Параметри:

• page (задължително) - номер на страницата
• mark, model - марка и модел, изписани както във /filters
• transmission_type, color, body_type, engine_type - скоростна кутия, цвят, категория на превозното средство и гориво, без разлика между главни и малки букви
• year_from, year_to - диапазон от години на първа регистрация
• km_age_from, km_age_to - диапазон на пробега, км
• price_from, price_to - диапазон на цената на лота, евро

Отговор:

{
  "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 }
}

Полета на записа

В обекта extra_prep

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

• date (задължително) - дата във формат yyyy-mm-dd

Отговор:

{ "change_id": 4816 }

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от промени (добавени/променени/премахнати)

Параметри:

• change_id (задължително) - от кое ID на промяна да се започне

Отговор:

{
  "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 }
}

Събитие removed с причината в полето removed_reason: sold, ако лотът е продаден; ended, ако тръжната сесия е приключила или лотът е публикуван отново, без да е отбелязана продажба; gone, ако лотът е премахнат от сайта. Един автомобил може да е обявен за продажба едновременно на търг в зала и онлайн; това са два лота със собствени цени и дати, а полето product_id ги свързва.