{
  "openapi": "3.0.1",
  "info": {
    "title": "Авито Авто: Парсер автомобилей / Avito Car Scraper",
    "description": "Парсер Авито Авто: автомобили с пробегом и новые, характеристики отдельными колонками: марка, модель, поколение, год, пробег, двигатель, мощность, коробка, привод, владельцы. Фильтры как на сайте, оценка Авито, история по Автотеке, комплектация и телефоны продавцов.",
    "version": "0.0",
    "x-build-id": "7bYyVvy7HDiTiE5mY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zen-studio~avito-auto-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zen-studio-avito-auto-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/zen-studio~avito-auto-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zen-studio-avito-auto-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/zen-studio~avito-auto-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zen-studio-avito-auto-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchUrl": {
            "title": "URL поиска автомобилей (Car search URL)",
            "type": "string",
            "description": "Ссылка на поиск в разделе «Автомобили» с любыми фильтрами сайта или ссылка на одно объявление. Фильтры, город и сортировка берутся из ссылки. (A search address from the Cars section with any of the site's filters, or a single listing address. Filters, city and sort are read from the address.)"
          },
          "listingUrls": {
            "title": "Ссылки на объявления (Listing URLs)",
            "maxItems": 1000,
            "type": "array",
            "description": "Ссылки на объявления автомобилей или их номера, по одной в строке. Объявления не из раздела «Автомобили» пропускаются и не оплачиваются. (Car listing addresses or ids, one per line. Listings outside the Cars section are skipped and not charged.)",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Макс. результатов (Max results)",
            "minimum": 1,
            "type": "integer",
            "description": "Сколько автомобилей собрать за запуск, для ссылки или для фильтров. (How many cars to collect in this run, from the URL or from the filters.)",
            "default": 100
          },
          "includeDetails": {
            "title": "Полные данные (Full listing details)",
            "type": "boolean",
            "description": "Поколение, модификация, комплектация, цвет, руль, владельцы, ПТС, VIN, опции, описание, фото, адрес, координаты, полная карточка продавца, рыночная цена и история по Автотеке. Без этого только данные из карточки поиска: марка, модель, год, пробег, двигатель, мощность, коробка, привод, кузов, цена, имя и рейтинг продавца. (Generation, modification, trim, colour, steering, owners, title type, VIN, equipment, description, photos, address, coordinates, full seller profile, market price and history summary. Off: only what the search card shows. Listing links always return full details and are charged for them.)",
            "default": true
          },
          "make": {
            "title": "Марка (Make)",
            "type": "string",
            "description": "Марка как на сайте: BMW, Mercedes-Benz, ВАЗ (LADA). Подходит и латиница: Lada, UAZ. (Make as the site writes it; latin spellings such as Lada or UAZ work too.)"
          },
          "models": {
            "title": "Модели (Models)",
            "type": "array",
            "description": "Одна или несколько моделей выбранной марки, как на сайте: «3 серия», «Camry», «Vesta». Неизвестная модель останавливает запуск со списком доступных. (One or more models of the chosen make, as the site writes them. An unknown model stops the run and lists the valid ones.)",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Местоположение (Location)",
            "type": "string",
            "description": "Город или регион для поиска. Выберите из списка или введите название. Название подходит на русском и на английском (Moscow, Nizhny Novgorod Oblast). (City or region. Pick from suggestions or type your own. The name works in Russian or in English (Moscow, Nizhny Novgorod Oblast).)",
            "default": "Россия"
          },
          "yearMin": {
            "title": "Год от (Year from)",
            "minimum": 0,
            "type": "integer",
            "description": "Год выпуска от. (Model year from.)"
          },
          "yearMax": {
            "title": "Год до (Year to)",
            "minimum": 0,
            "type": "integer",
            "description": "Год выпуска до. (Model year to.)"
          },
          "mileageMin": {
            "title": "Пробег от, км (Mileage from, km)",
            "minimum": 0,
            "type": "integer",
            "description": "Пробег от, в километрах. (Mileage from, in km.)"
          },
          "mileageMax": {
            "title": "Пробег до, км (Mileage to, km)",
            "minimum": 0,
            "type": "integer",
            "description": "Пробег до, в километрах. (Mileage to, in km.)"
          },
          "priceMin": {
            "title": "Мин. цена (Min price)",
            "minimum": 0,
            "type": "integer",
            "description": "Цена от, ₽. (Price from, RUB.)"
          },
          "priceMax": {
            "title": "Макс. цена (Max price)",
            "minimum": 0,
            "type": "integer",
            "description": "Цена до, ₽. (Price to, RUB.)"
          },
          "powerMin": {
            "title": "Мощность от, л.с. (Power from, hp)",
            "minimum": 0,
            "type": "integer",
            "description": "Мощность двигателя от, в лошадиных силах. (Engine power from, in hp.)"
          },
          "powerMax": {
            "title": "Мощность до, л.с. (Power to, hp)",
            "minimum": 0,
            "type": "integer",
            "description": "Мощность двигателя до, в лошадиных силах. (Engine power to, in hp.)"
          },
          "engineSizeMin": {
            "title": "Объём от, л (Engine size from, l)",
            "minimum": 0,
            "type": "number",
            "description": "Объём двигателя от, в литрах, например 1.6. Сайт предлагает шаги от 0.2 до 10.0 л; берётся ближайший шаг не меньше указанного. (Engine size from, in litres, e.g. 1.6. The site offers steps from 0.2 to 10.0 l; the nearest step not below yours is used.)"
          },
          "engineSizeMax": {
            "title": "Объём до, л (Engine size to, l)",
            "minimum": 0,
            "type": "number",
            "description": "Объём двигателя до, в литрах, например 3.0. Берётся ближайший шаг не больше указанного. (Engine size to, in litres. The nearest step not above yours is used.)"
          },
          "fuelTypes": {
            "title": "Двигатель (Fuel)",
            "type": "array",
            "description": "Тип двигателя. Пусто: любой. (Fuel type. Empty means any.)",
            "items": {
              "type": "string",
              "enum": [
                "petrol",
                "diesel",
                "hybrid",
                "electric",
                "gas"
              ],
              "enumTitles": [
                "Бензин (Petrol)",
                "Дизель (Diesel)",
                "Гибрид (Hybrid)",
                "Электро (Electric)",
                "Газ (Gas)"
              ]
            }
          },
          "transmission": {
            "title": "Коробка передач (Gearbox)",
            "type": "array",
            "description": "Пусто: любая. (Empty means any.)",
            "items": {
              "type": "string",
              "enum": [
                "automatic",
                "manual",
                "robot",
                "cvt"
              ],
              "enumTitles": [
                "Автомат (Automatic)",
                "Механика (Manual)",
                "Робот (Robotized)",
                "Вариатор (CVT)"
              ]
            }
          },
          "drivetrain": {
            "title": "Привод (Drivetrain)",
            "type": "array",
            "description": "Пусто: любой. (Empty means any.)",
            "items": {
              "type": "string",
              "enum": [
                "front",
                "rear",
                "awd"
              ],
              "enumTitles": [
                "Передний (Front)",
                "Задний (Rear)",
                "Полный (All-wheel)"
              ]
            }
          },
          "bodyTypes": {
            "title": "Кузов (Body type)",
            "type": "array",
            "description": "Пусто: любой. (Empty means any.)",
            "items": {
              "type": "string",
              "enum": [
                "sedan",
                "suv5",
                "suv3",
                "wagon",
                "hatchback5",
                "hatchback3",
                "liftback",
                "coupe",
                "convertible",
                "minivan",
                "microbus",
                "pickup",
                "van"
              ],
              "enumTitles": [
                "Седан (Sedan)",
                "Внедорожник 5-дв. (SUV, 5 doors)",
                "Внедорожник 3-дв. (SUV, 3 doors)",
                "Универсал (Wagon)",
                "Хетчбек 5-дв. (Hatchback, 5 doors)",
                "Хетчбек 3-дв. (Hatchback, 3 doors)",
                "Лифтбек (Liftback)",
                "Купе (Coupe)",
                "Кабриолет (Convertible)",
                "Минивэн (Minivan)",
                "Микроавтобус (Microbus)",
                "Пикап (Pickup)",
                "Фургон (Van)"
              ]
            }
          },
          "colors": {
            "title": "Цвет (Colour)",
            "type": "array",
            "description": "Пусто: любой. (Empty means any.)",
            "items": {
              "type": "string",
              "enum": [
                "white",
                "black",
                "silver",
                "grey",
                "blue",
                "lightBlue",
                "red",
                "burgundy",
                "brown",
                "beige",
                "gold",
                "green",
                "yellow",
                "orange",
                "violet",
                "purple",
                "pink"
              ],
              "enumTitles": [
                "Белый (White)",
                "Чёрный (Black)",
                "Серебряный (Silver)",
                "Серый (Grey)",
                "Синий (Blue)",
                "Голубой (Light blue)",
                "Красный (Red)",
                "Бордовый (Burgundy)",
                "Коричневый (Brown)",
                "Бежевый (Beige)",
                "Золотой (Gold)",
                "Зелёный (Green)",
                "Жёлтый (Yellow)",
                "Оранжевый (Orange)",
                "Фиолетовый (Violet)",
                "Пурпурный (Purple)",
                "Розовый (Pink)"
              ]
            }
          },
          "condition": {
            "title": "Состояние (Condition)",
            "enum": [
              "any",
              "undamaged",
              "damaged"
            ],
            "type": "string",
            "description": "Битые или не битые. (Damaged or not.)"
          },
          "carType": {
            "title": "С пробегом или новые (Used or new)",
            "enum": [
              "any",
              "used",
              "new"
            ],
            "type": "string",
            "description": "Пусто: все. (Empty means both.)"
          },
          "sellerType": {
            "title": "Продавец (Seller)",
            "enum": [
              "any",
              "private",
              "dealer"
            ],
            "type": "string",
            "description": "Как сайт делит продавцов: «Дилеры» это дилерские центры, «Частные» все остальные, включая перекупщиков, оформленных как компания. В каждой строке userType показывает тип аккаунта, saleType показывает, личный ли это автомобиль или купленный для продажи. (The site's own grouping: Dealers are dealerships, Private is everyone else, resellers registered as companies included. Each row's userType gives the account type and saleType says whether the car is the seller's own or bought for resale.)"
          },
          "owners": {
            "title": "Владельцев по ПТС (Owners)",
            "enum": [
              "any",
              "one",
              "upToTwo",
              "upToThree"
            ],
            "type": "string",
            "description": "Число владельцев по ПТС. (Number of registered owners.)"
          },
          "steering": {
            "title": "Руль (Steering)",
            "enum": [
              "any",
              "left",
              "right"
            ],
            "type": "string",
            "description": "Левый или правый руль. (Left- or right-hand drive.)"
          },
          "query": {
            "title": "Поисковый запрос (Search query)",
            "type": "string",
            "description": "Слова в объявлении, например «полный привод» или «один владелец». Можно не указывать. (Words in the listing. Optional.)"
          },
          "sort": {
            "title": "Сортировка (Sort)",
            "enum": [
              "relevance",
              "newest",
              "cheapest",
              "expensive",
              "yearNewest",
              "mileageLowest"
            ],
            "type": "string",
            "description": "Порядок сортировки результатов. Без поискового запроса применяется сортировка по новизне. (Sort order. Without search keywords, results are sorted by newest.)",
            "default": "relevance"
          },
          "includePhone": {
            "title": "Телефоны продавцов (Seller phones)",
            "type": "boolean",
            "description": "Номера телефонов продавцов. (Seller phone numbers.)",
            "default": false
          },
          "includeComparables": {
            "title": "Цены на эту же модель (Comparable prices)",
            "type": "boolean",
            "description": "Разброс цен на точно такую же модель: сколько предложений, минимум, медиана, максимум и место этого объявления среди них. Автоматически включает полные данные. (Price spread for the exact same model: offer count, minimum, median, maximum, and where this listing sits among them. Automatically enables full details.)",
            "default": false
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "type": "string",
            "description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}