Alcopa Auction APIПарсер и скрапер

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": ["Автомат", "Механика", "Робот"],
  "color": ["Бежевый", "Белый", "Зеленый", "Коричневый", "Красный", "Не указан", "Оранжевый", "Светло-серый", "Светло-синий", "Серый", "Синий", "Темно-серый", "Темно-синий", "Черный"],
  "body_type": ["Коммерческий", "Легковой", "Спецавтомобиль", "Фургон"],
  "engine_type": ["Бензин", "Бензин + пропан", "Гибрид", "Дизель", "Подключаемый гибрид", "Электро", "Этанол (E85)"]
}

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": "Синий",
        "engine_type": "Дизель",
        "body_type": "Легковой",
        "transmission_type": "Механика",
        "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 (обязательно) - дата в формате гггг-мм-дд

Ответ:

{ "change_id": 4816 }

Используйте это значение как параметр change_id в /changes

GET/changes

Поток изменений (новые/измененные/удаленные)

Параметры:

• change_id (обязательно) - начиная с какого change_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.