ApiAd API

Открыть Swagger

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

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

GET /api/ads

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

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

Параметр	Тип	Описание
`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/ads?apikey=ВАШ_КЛЮЧ&categoryIds=9&categoryIds=14&page=1&limit=50"

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

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

GET /api/parse_sync

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

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

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

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

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

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

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

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

В поле data (а также в результатах выдачи /api/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.