AutoScout24 APIScraper & Parser

GET/filters

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

Отговор:

{
  "mark": {
    "BMW": {
      "model": {
        "3 Series": {
          "configuration": {
            "320d": { "complectation": ["Sport Line", "Luxury Line", "M Sport"] }
          }
        }
      }
    },
    "Mercedes-Benz": {
      "model": {
        "C-Class": {
          "configuration": {
            "C200": { "complectation": ["Avantgarde", "AMG Line"] }
          }
        }
      }
    }
  },
  "transmission_type": ["MT", "AT"],
  "color": ["Champagne", "Black", "Purple", "Silver", "Red", "Gray", "Blue", "White", "Green", "Yellow"],
  "body_type": ["Pick Up", "Sedan", "Sports Car", "Crossover", "Bus", "Hatchback", "Station Wagon", "Convertible", "SUV", "Truck"],
  "engine_type": ["PHEV", "Diesel", "BEV", "Gasoline", "HEV", "REEV"]
}

GET/offers

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

Параметри:

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

Отговор:

{
  "result": [
    {
      "id": 4695867,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
      "change_type": "added",
      "created_at": "2025-05-27T00:23:45.196Z",
      "data": {
        "id": 4695867,
        "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
        "url": "https://www.autoscout24.com/offers/toyota-yaris-...",
        "mark": "Toyota",
        "model": "Yaris",
        "configuration": "1.4 D-4D",
        "complectation": "Sol",
        "year": 2006,
        "color": "Black",
        "price_eur": 3490,
        "km_age": 240000,
        "engine_type": "Diesel",
        "transmission_type": "MT",
        "body_type": "Hatchback",
        "address": "Roma - Rm",
        "seller_type": "dealer",
        "is_dealer": true,
        "section": "used",
        "seller": "Spazio Auto Srl",
        "seller_id": "17358964",
        "description": "Toyota Yaris in excellent condition...",
        "displacement": 1.4,
        "horse_power": 90,
        "offer_created": "2025-05-27",
        "doors_count": 5,
        "num_seats": 5,
        "first_registration": "12/2006",
        "images": ["https://prod.pictures.autoscout24.net/..."],
        "seller_phones": ["+390624416455"],
        "extra": {}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Полета с данни:

GET/change_id

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

Параметри:

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

Отговор:

{ "change_id": 9182734 }

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

GET/changes

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

Параметри:

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

Отговор:

{
  "result": [
    {
      "id": 456,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549e",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549f",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490 }
    },
    {
      "id": 458,
      "inner_id": "2aa0d910-4b72-4c69-9638-79ac5c58549g",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}