{"name":"Авто.ру API для дилеров","vendor":"Авто.ру (Яндекс)","industry":"marketplaces","summary":"API Авто.ру для автодилеров: управление объявлениями (снятие с продажи, активация, удаление, подключение платных услуг), личный кабинет дилера (баланс, тарифы, статистика), прайс-листы, звонки и колл-трекинг, аукционы звонков, бронирования, чаты, оценка стоимости автомобиля и каталог. Доступ к API выдаёт менеджер Авто.ру.","docsUrl":"https://yandex.ru/dev/autoru/doc/ru/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"podklyuchitsya-i-proverit-balans","title":"Подключиться и проверить баланс кабинета","summary":"Первый шаг интеграции дилерской системы: сессия, баланс и подключённые тарифы.","steps":["Запроси токен авторизации у аккаунт-менеджера Авто.ру. Он передаётся в заголовке x-authorization в каждом запросе.","Создай сессию: POST /auth/login с login (телефон или email) и password пользователя кабинета. В ответе session.id — передавай его в заголовке x-session-id во всех операциях с кабинетом и объявлениями.","Сессия живёт долго (ttl_sec в ответе), поэтому храни её и создавай новую только после ответа 401, а не перед каждым запросом.","Проверь баланс: GET /dealer/account, подключённые тарифы — GET /dealer/campaigns.","Если работаешь через агентский аккаунт, добавляй x-dealer-id с ID клиента."],"code":"TOKEN='<токен от менеджера>'\nSESSION=$(curl -s -X POST https://apiauto.ru/1.0/auth/login \\\n  -H \"x-authorization: $TOKEN\" -H 'Content-Type: application/json' -H 'Accept: application/json' \\\n  -d '{\"login\": \"dealer@example.ru\", \"password\": \"<пароль>\"}' | jq -r .session.id)\n\ncurl -s https://apiauto.ru/1.0/dealer/account  -H \"x-authorization: $TOKEN\" -H \"x-session-id: $SESSION\"\ncurl -s https://apiauto.ru/1.0/dealer/campaigns -H \"x-authorization: $TOKEN\" -H \"x-session-id: $SESSION\"","language":"bash","methods":["POST /auth/login","GET /dealer/account","GET /dealer/campaigns"]},{"id":"snyat-s-prodazhi-prodannye-avtomobili","title":"Снять с продажи проданные автомобили","summary":"Синхронизация со складом дилера: машина продана в салоне — объявление снимается с Авто.ру, вернулась в продажу — активируется.","steps":["Найди объявление по VIN: GET /user/offers/{category} с category = cars, vin и status = active. Для обхода всего склада листай page и page_size (до 100 объявлений на странице).","Сними объявление с продажи: PUT /user/offers/{category}/{offerID}/hide. Объявление остаётся в кабинете и не удаляется.","Если сделка сорвалась, верни его: POST /user/offers/{category}/{offerID}/activate.","Удалять объявление насовсем — DELETE /user/offers/{category}/{offerID} — стоит только для ошибочных объявлений: снятое можно вернуть, удалённое — нет.","Ответ 404 — объявление не найдено: проверь категорию и ID."],"code":"H=(-H \"x-authorization: $TOKEN\" -H \"x-session-id: $SESSION\" -H 'Accept: application/json')\n\nOFFER=$(curl -s -G https://apiauto.ru/1.0/user/offers/cars \"${H[@]}\" \\\n  -d vin=XW8ZZZ61ZJG012345 -d status=active | jq -r '.offers[0].id')\n\ncurl -s -X PUT \"https://apiauto.ru/1.0/user/offers/cars/$OFFER/hide\" \"${H[@]}\"","language":"bash","methods":["GET /user/offers/{category}","PUT /user/offers/{category}/{offerID}/hide","POST /user/offers/{category}/{offerID}/activate","DELETE /user/offers/{category}/{offerID}"]},{"id":"prodvinut-obyavleniya-platnymi-uslugami","title":"Продвинуть объявления платными услугами","summary":"Поднять в выдаче или выделить автомобили, которые долго стоят на складе.","steps":["Выбери объявления без продвижения: GET /user/offers/{category} с status = active, no_active_services = true и create_date_to — например, старше 30 дней.","Посмотри, как они смотрятся: GET /user/offers/{category}/{offerID}/stats — статистика просмотров.","Подключи услугу: POST /user/offers/{category}/{offerID}/products с products[].code — all_sale_fresh (поднятие), all_sale_premium (премиум) и т. д. Для all_sale_badge добавь badges — до трёх рекламных текстов.","Ответ 402 — на балансе не хватает средств: проверь GET /dealer/account и не повторяй запрос, пока баланс не пополнен.","Отключить услугу можно тем же путём методом DELETE."],"code":"curl -s -X POST \"https://apiauto.ru/1.0/user/offers/cars/1022557788-4a6efe8b/products\" \\\n  -H \"x-authorization: $TOKEN\" -H \"x-session-id: $SESSION\" \\\n  -H 'Content-Type: application/json' -H 'Accept: application/json' \\\n  -d '{\"products\": [{\"code\": \"all_sale_fresh\"}, {\"code\": \"all_sale_badge\", \"badges\": [\"Один владелец\", \"Гарантия\"]}]}'","language":"bash","methods":["GET /dealer/account","GET /user/offers/{category}","POST /user/offers/{category}/{offerID}/products","GET /user/offers/{category}/{offerID}/stats"]}],"baseUrls":[{"label":"Боевой","url":"https://apiauto.ru/1.0"}],"auth":{"type":"api_key","description":"Токен авторизации запрашивают у аккаунт-менеджера Авто.ру и передают в заголовке `x-authorization` в каждом запросе. Операции с объявлениями и кабинетом дилера дополнительно требуют сессию пользователя: её получают методом `POST /auth/login` и передают в заголовке `x-session-id`. При работе через агентский аккаунт клиента указывают в `x-dealer-id`.","example":"curl -i -X GET 'GET https://apiauto.ru/1.0/dealer/account' -H 'x-authorization: fefernrjkgnerkj3453445...'"},"methods":[{"id":"POST /auth/login","title":"Создание сессии","httpMethod":"POST","path":"/auth/login","description":"Пример ответа (сокращён):","params":[{"name":"x-authorization","in":"header","type":"string","required":true,"description":"Токен авторизации"},{"name":"login","in":"body","type":"string","required":true,"description":"Логин: телефон или email"},{"name":"password","in":"body","type":"string","required":true,"description":"Пароль"}],"requestExample":"curl -i -X POST 'https://apiauto.ru/1.0/auth/login' -H 'x-authorization: 2dtrer432...' -d '{\"login\":\"ivan-ivanov@auto.ru\",\"password\":\"autoru\"}' -H 'Accept: application/json' -H 'Content-Type: application/json'","responseExample":"{\n\"session\": {\n\"id\": \"11112233|152...019.777..0.oWEL...JwyqRHw...\",\n\"user_id\": \"11112233\",\n\"device_uid\": \"76ebe2f87d5850c5c12...\",\n\"creation_timestamp\": \"2018-05-28T14:33:39.697Z\",\n\"expire_timestamp\": \"2018-08-26T14:33:39.697Z\",\n\"ttl_sec\": 7776000\n},\n\"status\": \"SUCCESS\"\n}","docsUrl":""},{"id":"POST /auth/logout","title":"Завершение сессии","httpMethod":"POST","path":"/auth/logout","description":"Завершает сессию пользователя.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /dealer/account","title":"Баланс дилера","httpMethod":"GET","path":"/dealer/account","description":"","params":[{"name":"x-authorization","in":"header","type":"string","required":true,"description":"Токен авторизации"},{"name":"x-session-id","in":"header","type":"string","required":true,"description":"Сессия пользователя"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /dealer/campaigns","title":"Подключённые тарифы дилера","httpMethod":"GET","path":"/dealer/campaigns","description":"Список тарифов, подключённых дилеру.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /user/offers/{category}","title":"Список объявлений","httpMethod":"GET","path":"/user/offers/{category}","description":"","params":[{"name":"category","in":"path","type":"string","required":true,"description":"cars, moto, trucks или all"},{"name":"x-session-id","in":"header","type":"string","required":true,"description":"Сессия пользователя"},{"name":"x-dealer-id","in":"header","type":"string","required":false,"description":"ID клиента для агентского аккаунта"},{"name":"page","in":"query","type":"integer","required":false,"description":"Номер страницы, 1–1000"},{"name":"page_size","in":"query","type":"integer","required":false,"description":"Объявлений на странице, максимум 100"},{"name":"status","in":"query","type":"string","required":false,"description":"active, inactive или banned; можно повторять"},{"name":"section","in":"query","type":"string","required":false,"description":"NEW или USED"},{"name":"sort","in":"query","type":"string","required":false,"description":"cr_date-asc (по умолчанию), cr_date-desc, price-asc, price-desc"},{"name":"price_from","in":"query","type":"number","required":false,"description":"Цена от"},{"name":"price_to","in":"query","type":"number","required":false,"description":"Цена до"},{"name":"vin","in":"query","type":"string","required":false,"description":"VIN; можно повторять"},{"name":"mark_model","in":"query","type":"string","required":false,"description":"Марка и модель через %23, например MERCEDES%23C_KLASSE"},{"name":"service","in":"query","type":"string","required":false,"description":"Фильтр по услуге, например all_sale_premium"},{"name":"create_date_from","in":"query","type":"string","required":false,"description":"Дата создания от, ISO 8601"},{"name":"create_date_to","in":"query","type":"string","required":false,"description":"Дата создания до, ISO 8601"},{"name":"no_active_services","in":"query","type":"boolean","required":false,"description":"Только объявления без услуг"},{"name":"auction","in":"query","type":"boolean","required":false,"description":"Только объявления в аукционе"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PUT /user/offers/{category}/{offerID}/hide","title":"Снять объявление с продажи","httpMethod":"PUT","path":"/user/offers/{category}/{offerID}/hide","description":"","params":[{"name":"category","in":"path","type":"string","required":true,"description":"Категория"},{"name":"offerID","in":"path","type":"string","required":true,"description":"ID объявления"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /user/offers/{category}/{offerID}/activate","title":"Активировать объявление","httpMethod":"POST","path":"/user/offers/{category}/{offerID}/activate","description":"Возвращает в продажу ранее снятое объявление.","params":[{"name":"category","in":"path","type":"string","required":true,"description":"Категория"},{"name":"offerID","in":"path","type":"string","required":true,"description":"ID объявления"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"DELETE /user/offers/{category}/{offerID}","title":"Удалить объявление","httpMethod":"DELETE","path":"/user/offers/{category}/{offerID}","description":"","params":[{"name":"category","in":"path","type":"string","required":true,"description":"Категория"},{"name":"offerID","in":"path","type":"string","required":true,"description":"ID объявления"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /user/offers/{category}/{offerID}/products","title":"Подключить услуги объявлению","httpMethod":"POST","path":"/user/offers/{category}/{offerID}/products","description":"Отключение услуг — `DELETE /user/offers/{category}/{offerID}/products`.","params":[{"name":"category","in":"path","type":"string","required":true,"description":"cars, moto, trucks или all"},{"name":"offerID","in":"path","type":"string","required":true,"description":"ID объявления"},{"name":"x-session-id","in":"header","type":"string","required":true,"description":"Сессия пользователя"},{"name":"products","in":"body","type":"array","required":true,"description":"Подключаемые услуги"},{"name":"products[].code","in":"body","type":"string","required":true,"description":"all_sale_fresh (поднятие), all_sale_premium (премиум), all_sale_special (спецпредложение), package_turbo (турбо-продажа), reset (сброс)"},{"name":"products[].badges","in":"body","type":"array","required":false,"description":"Рекламные тексты для услуги all_sale_badge, до трёх"}],"requestExample":"curl -i -X POST 'https://apiauto.ru/1.0/user/offers/cars/1022557788-4a6efe8b/products' -H 'x-authorization: 2dtrer432...' -d '{\"products\":[{\"code\": \"all_sale_fresh\"}]}' -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'x-session-id: 112_aoR02Tpv...'","responseExample":"{\n\"status\": \"SUCCESS\"\n}","docsUrl":""},{"id":"GET /user/offers/{category}/{offerID}/stats","title":"Статистика объявления","httpMethod":"GET","path":"/user/offers/{category}/{offerID}/stats","description":"Статистика просмотров объявления.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /feeds/tasks/cars/{section}","title":"Ручная загрузка прайс-листа","httpMethod":"POST","path":"/feeds/tasks/cars/{section}","description":"Загрузка прайс-листа легковых автомобилей; история загрузок — `GET /feeds/history`.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /stats/predict","title":"Оценка стоимости","httpMethod":"POST","path":"/stats/predict","description":"Оценка стоимости автомобиля по его параметрам. Оценка по VIN или госномеру — `POST /stats/partner/predict_by_vin_or_lp`.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /calltracking","title":"Звонки дилера","httpMethod":"POST","path":"/calltracking","description":"Список звонков дилера; статистика по дням — `POST /calltracking/aggregated`.","params":[],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"400","description":"Синтаксическая ошибка в запросе"},{"code":"401","description":"Не удалось авторизовать пользователя"},{"code":"402","description":"Недостаточно средств для оплаты"},{"code":"404","description":"Объявление не найдено"},{"code":"500","description":"Внутренняя ошибка сервера"}],"limits":"","gotchas":["Почти все операции с объявлениями требуют обоих заголовков: `x-authorization` (токен) и `x-session-id` (сессия из `/auth/login`).","Сессия живёт около 90 дней (`ttl_sec` 7776000; в документации единица указана противоречиво — проверьте).","Ответ может содержать недокументированные служебные поля, порядок полей не гарантирован.","Подключение платных услуг при нехватке средств возвращает `402`."],"slug":"autoru","version":2,"updatedAt":"2026-10-24T17:05:31.400Z","sources":[{"title":"Документация API Авто.ру","url":"https://yandex.ru/dev/autoru/doc/ru/","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"Доступ к API","url":"https://yandex.ru/dev/autoru/doc/ru/concepts/access","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"Операции с ресурсами API","url":"https://yandex.ru/dev/autoru/doc/ru/reference/all-resources","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"POST /auth/login","url":"https://yandex.ru/dev/autoru/doc/ru/reference/auth-login","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"GET /user/offers/{category}","url":"https://yandex.ru/dev/autoru/doc/ru/reference/user-offers-category","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"POST /user/offers/{category}/{offerID}/products","url":"https://yandex.ru/dev/autoru/doc/ru/reference/user-offers-category-offer-id-products","kind":"research","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-12T19:23:55.830Z"},{"title":"scenarios-autoru.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:23.260Z"}],"logoUrl":null}