ApiAd API

Открыть Swagger

Интерактивная документация: Рекомендуем использовать Swagger UI для удобного тестирования API, формирования запросов и просмотра актуальных примеров ответов.

Добро пожаловать. Используйте наш интерфейс для получения структурированных данных в формате JSON.

GET /api/avito/ads · GET /api/drom/ads

Получение списка обработанных объявлений. Результаты возвращаются постранично, отсортированные по дате обработки (сначала свежие).

/api/avito/ads — объявления Авито, /api/drom/ads — объявления Дрома. Параметры и формат ответа одинаковые. Старые адреса (/api/ads, /api/parse_sync, /api/search_transport_avito) продолжают работать.

Поле uid — сквозной идентификатор объявления в нашей системе (начинается с 1 000 000 000 000). Он не пересекается между площадками, поэтому его удобно использовать как ключ объявления у себя. srcId — ID объявления на самой площадке.

Параметры запроса

Параметр	Тип	Описание
`apikey` *	string	Ваш уникальный ключ API. Скопируйте его в Личном кабинете.
`page`	int	Номер страницы. По умолчанию: `1`.
`limit`	int	Количество результатов (макс. 100). По умолчанию: `100`.
`sort`	string	Сортировка выдачи (`asc` или `desc`). По умолчанию: `desc`.
`pubDate1`, `pubDate2`	string	Фильтр по дате выкладывания объявления (от и до). Пример: `2014-11-02` или `2014-11-02 17:10:00` (Время UTC).
`procDate1`, `procDate2`	string	Фильтр по дате процессинга объявления (от и до). Пример: `2014-11-02` или `2014-11-02 17:10:00` (Время UTC).
`categoryIds`	int[]	Фильтр по ID категорий (ищет совпадения по полям `cat1_id` или `cat2_id`). Можно передавать несколько значений, например: `?categoryIds=1&categoryIds=2`.

Пример запроса

curl -X GET "https://apiad.ru/api/avito/ads?apikey=ВАШ_КЛЮЧ&categoryIds=9&categoryIds=14&page=1&limit=50"

Пример ответа (200 OK)

{
  "success": true,
  "page": 1,
  "limit": 50,
  "totalItems": 1500,
  "totalPages": 30,
  "results": [
    {
      "uid": 1000000123456,
      "source": "avito",
      "srcId": "1234567890",
      "price": 500000,
      "pubDate": "2024-05-18T10:00:00Z",
      "procDate": "2024-05-18T10:05:00Z",
      "data": { ... } // JSON-структура объявления
    }
  ]
}

GET /api/avito/parse_sync · GET /api/drom/parse_sync

/api/avito/parse_sync — ссылка на Авито, /api/drom/parse_sync — ссылка на объявление Дрома (…/id.html). Ответ одинаковый: uid, srcId (ID на площадке) и data.

Поиск по транспорту в реальном времени: /api/avito/search_transport и /api/drom/search_transport (параметры query и cat; у Дрома cat — auto, spec или раздел спецтехники из categories[].subs[].id). Описание — в Swagger.

Синхронный парсинг одного объявления по ссылке. Внимание: запрос может выполняться до 30 секунд.

Параметры запроса

Параметр	Тип	Описание
`apikey` *	string	Ваш уникальный ключ API. Скопируйте его в Личном кабинете.
`url` *	string	Ссылка на объявление на сайте avito.ru. Например: `https://www.avito.ru/moskva/...`

Пример запроса

curl -X GET "https://apiad.ru/api/avito/parse_sync?apikey=ВАШ_КЛЮЧ&url=ССЫЛКА_НА_AVITO"

Пример ответа (200 OK)

{
  "success": true,
  "avitoId": "1234567890",
  "data": { ... } // JSON-структура объявления
}

GET /api/avito/search_transport · GET /api/drom/search_transport

Поиск объявлений в разделе транспорта на Avito (https://www.avito.ru/all/transport?q=...) с помощью браузерного движка Playwright. Возвращает список ссылок, заголовков, краткого текста/характеристик, категорий и цен.

Параметры запроса

Параметр	Тип	Описание
`apikey` *	string	Ваш уникальный ключ API. Скопируйте его в Личном кабинете.
`query` (или `q`) *	string	Поисковый запрос (например: `ЛТЗ-55А`) или полная ссылка на выдачу транспорта Avito.

Пример запроса

curl -X GET "https://apiad.ru/api/avito/search_transport?apikey=ВАШ_КЛЮЧ&query=ЛТЗ-55А"

Пример ответа (200 OK)

[
  {
    "url": "https://www.avito.ru/voronezh/gruzoviki_i_spetstehnika/traktor_ltz_55a_8307989898",
    "title": "Трактор лтз 55А",
    "description": "Продаю трактор Лтз 55А. Полный привод. Трактор обслужен...",
    "category": "Грузовики и спецтехника",
    "price": 500000,
    "price_string": "500 000 ₽ c НДС"
  }
]

Структура JSON объявления (поле data)

В поле data (а также в результатах выдачи /api/avito/ads) возвращается подробная информация об объявлении в формате JSON.

Поле	Тип	Описание
`id` / `avitoid`	long / string	Уникальный идентификатор объявления на Авито.
`url`	string	Прямая ссылка на объявление.
`cat1`, `cat2`	string	Названия категорий (например: "Транспорт", "Автомобили").
`city`, `region`, `address`	string	Географические данные объявления.
`phone`	string	Телефон (может быть скрыт как "8 XXX XXX-XX-XX", если парсинг телефона отключен).
`price`	long	Цена в рублях.
`title`, `description`	string	Заголовок и текст описания.
`coords`	object	Гео-координаты (`lat`, `lng`, `zoom`).
`images`	array	Список объектов с ссылками на фотографии (`imgurl`).
`params`	object	Общий список всех характеристик (ключ-значение).
`analytics`	object	Аналитика от Авито (оценка цены, плюсы и минусы).
`seller_analytics`	object	Данные о продавце (тип продавца, имя, анонимность).
`time_source_created` / `time_source_updated`	string	Время выкладывания и обновления объявления по данным площадки.
`param_*`	string	Оригинальные идентификаторы параметров Авито (служебные поля).

Совет: Полный пример ответа с реальными данными для вашего аккаунта всегда доступен в Swagger UI.