Быстрый старт¶

Это руководство проведёт вас от установки пакета до первого рабочего запроса к Avito API.

Что вы сделаете: установите avito-py, создадите клиент и получите информацию о своём аккаунте.

Время: около 5 минут.

Шаг 1. Установка¶

pip install avito-py

Требования: Python 3.14 и выше.

Шаг 2. Получение ключей API¶

Перейдите на avito.ru/professionals/api и создайте приложение. Вам понадобятся client_id и client_secret.

Шаг 3. Настройка переменных окружения¶

Создайте файл .env в корне проекта:

AVITO_CLIENT_ID=ваш-client-id
AVITO_CLIENT_SECRET=ваш-client-secret

Или экспортируйте переменные напрямую:

export AVITO_CLIENT_ID=ваш-client-id
export AVITO_CLIENT_SECRET=ваш-client-secret

Шаг 4. Первый запрос¶

from avito import AvitoClient

with AvitoClient.from_env() as avito:
    profile = avito.account().get_self()

print(profile.name)
print(profile.email)

Запустите скрипт:

python main.py

Вы увидите имя и email вашего аккаунта Avito.

Что дальше¶

Авторизация и конфигурация — все способы создания клиента, env-переменные, AvitoSettings.
Работа с объявлениями — получение, фильтрация, статистика.
Reference: AvitoClient — полный список фабричных методов.

Используйте контекстный менеджер

Конструкция with AvitoClient.from_env() as avito: автоматически закрывает HTTP-соединения при выходе из блока. Альтернатива — вызвать client.close() вручную.