Тарифы API

Вопросы

Как считается квота?

По запросам, а не по строкам. Один вызов — одна единица, сколько бы машин он ни вернул, поэтому страница побольше ничего не стоит сверху.

Что происходит при достижении лимита?

Запросы отклоняются с HTTP 429 до смены дневного окна. Ничего не ставится в очередь и не списывается как перерасход.

Скрывает ли бесплатный доступ поля?

Нет. Каждый тариф получает все поля, включая ссылку на исходное объявление. Тарифы различаются объёмом и возможностями, перечисленными выше.

Отдаются ли проданные машины?

Да. API отдаёт весь каталог, включая объявления, ушедшие с рынка, — это та история, которая нужна цене. Добавьте available_only=true, чтобы получить только актуальные.

Ограничивает ли тариф набор площадок?

Нет. Любой ключ видит все площадки. Площадки, выбранные в калькуляторе, определяют цену и квоту, а не то, что возвращает API.

Насколько свежее объявление?

Зависит от площадки. У каждой машины есть last_seen_at, у каждого источника — last_parsed_at; ориентируйтесь на них, а не на предполагаемую цифру.

Как авторизоваться?

Передайте ключ в заголовке X-API-Key или как Bearer-токен в Authorization. Никогда — в строке запроса.

Почему запрос отклонён с HTTP 400?

Неизвестный параметр не игнорируется, а отклоняется, и в ответе указано, какой параметр использовать. Полный список — в справочнике API.