AvitoClient и AsyncAvitoClient¶

AvitoClient — единственная публичная точка входа SDK. Он владеет конфигурацией, auth-provider и transport-слоем, а наружу отдаёт только доменные объекты.

AsyncAvitoClient предоставляет тот же фасад для async-кода. Он создаёт loop-bound ресурсы в async with, закрывается через aclose() и возвращает async-доменные объекты.

Контракт¶

AvitoClient.from_env() — основной путь для конфигурации из окружения.
AsyncAvitoClient.from_env() — async-аналог; использовать только через async with.
AvitoClient(client_id=..., client_secret=...) — короткий явный путь для OAuth credentials.
AvitoClient(AvitoSettings(...)) — полный путь для расширенной конфигурации.
Клиент поддерживает context manager и закрывает внутренние HTTP-клиенты в close().
После close() публичные операции поднимают ClientClosedError.
debug_info() возвращает безопасный диагностический снимок без OAuth-секретов.

Фасад¶

Единственная публичная точка входа SDK с фабриками доменных объектов.

Пример

from avito import AvitoClient

with AvitoClient() as avito:
    profile = avito.account().get_self()
    ad = avito.ad(42).get()

Initialize AvitoClient.

settings `property` ¶

settings: AvitoSettings

Возвращает read-only настройки клиента.

auth_provider `property` ¶

auth_provider: AuthProvider

Возвращает read-only auth provider клиента.

transport `property` ¶

transport: Transport

Возвращает read-only transport клиента.

from_env `classmethod` ¶

from_env(
    *, env_file: str | Path | None = ".env"
) -> AvitoClient

Создает клиент из переменных окружения и optional .env файла.

auth ¶

auth() -> AuthProvider

Возвращает объект аутентификации и token-flow операций.

Raises: AvitoError с полями operation, status, request_id, attempt, method и endpoint.

debug_info ¶

debug_info() -> TransportDebugInfo

Возвращает безопасный снимок transport-настроек для диагностики.

business_summary ¶

business_summary(
    *,
    user_id: int | str | None = None,
    listing_limit: int = 50,
    listing_page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> AccountHealthSummary

Возвращает итоговую read-only сводку бизнеса.

Метод является совместимым именем для account_health() и не содержит отдельной логики.

account_health ¶

account_health(
    *,
    user_id: int | str | None = None,
    listing_limit: int = 50,
    listing_page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> AccountHealthSummary

Возвращает итоговую read-only health-сводку аккаунта.

listing_health ¶

listing_health(
    *,
    user_id: int | str | None = None,
    limit: int = 50,
    page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> ListingHealthSummary

Возвращает health-сводку объявлений без ручного сопоставления статистики.

chat_summary ¶

chat_summary(
    *, user_id: int | str | None = None
) -> ChatSummary

Возвращает итоговую read-only сводку по чатам.

order_summary ¶

order_summary() -> OrderSummary

Возвращает итоговую read-only сводку по заказам.

review_summary ¶

review_summary() -> ReviewSummary

Возвращает итоговую read-only сводку по отзывам.

promotion_summary ¶

promotion_summary(
    *, item_ids: list[int] | None = None
) -> PromotionSummary

Возвращает итоговую read-only сводку по продвижению.

capabilities ¶

capabilities() -> CapabilityDiscoveryResult

Возвращает справочник возможностей SDK и типовых причин отказов API.

close ¶

close() -> None

Закрывает внутренние HTTP-клиенты SDK.

account ¶

account(user_id: int | str | None = None) -> Account

Создает доменный объект аккаунта.

account_hierarchy ¶

account_hierarchy(
    user_id: int | str | None = None,
) -> AccountHierarchy

Создает доменный объект иерархии аккаунта.

ad ¶

ad(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> Ad

Создает доменный объект объявления.

ad_stats ¶

ad_stats(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AdStats

Создает доменный объект статистики объявления.

ad_promotion ¶

ad_promotion(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AdPromotion

Создает доменный объект продвижения объявления.

autoload_profile ¶

autoload_profile(
    user_id: int | str | None = None,
) -> AutoloadProfile

Создает доменный объект профиля автозагрузки.

autoload_report ¶

autoload_report(
    report_id: int | str | None = None,
) -> AutoloadReport

Создает доменный объект отчета автозагрузки.

autoload_archive ¶

autoload_archive(
    report_id: int | str | None = None,
) -> AutoloadArchive

Создает доменный объект архивных операций автозагрузки.

chat ¶

chat(
    chat_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> Chat

Создает доменный объект чата.

chat_message ¶

chat_message(
    message_id: int | str | None = None,
    *,
    chat_id: int | str | None = None,
    user_id: int | str | None = None,
) -> ChatMessage

Создает доменный объект сообщения чата.

chat_webhook ¶

chat_webhook() -> ChatWebhook

Создает доменный объект webhook мессенджера.

chat_media ¶

chat_media(
    *, user_id: int | str | None = None
) -> ChatMedia

Создает доменный объект медиа мессенджера.

special_offer_campaign ¶

special_offer_campaign(
    campaign_id: int | str | None = None,
) -> SpecialOfferCampaign

Создает доменный объект рассылки спецпредложений.

promotion_order ¶

promotion_order(
    order_id: int | str | None = None,
) -> PromotionOrder

Создает доменный объект заявки на продвижение.

bbip_promotion ¶

bbip_promotion(
    item_id: int | str | None = None,
) -> BbipPromotion

Создает доменный объект BBIP-продвижения.

trx_promotion ¶

trx_promotion(
    item_id: int | str | None = None,
) -> TrxPromotion

Создает доменный объект TrxPromo.

cpa_auction ¶

cpa_auction(item_id: int | str | None = None) -> CpaAuction

Создает доменный объект CPA-аукциона.

target_action_pricing ¶

target_action_pricing(
    item_id: int | str | None = None,
) -> TargetActionPricing

Создает доменный объект цены целевого действия.

autostrategy_campaign ¶

autostrategy_campaign(
    campaign_id: int | str | None = None,
) -> AutostrategyCampaign

Создает доменный объект автостратегии.

order ¶

order() -> Order

Создает доменный объект заказа.

order_label ¶

order_label(task_id: int | str | None = None) -> OrderLabel

Создает доменный объект этикетки заказа.

delivery_order ¶

delivery_order() -> DeliveryOrder

Создает доменный объект доставки.

sandbox_delivery ¶

sandbox_delivery() -> SandboxDelivery

Создает доменный объект песочницы доставки.

delivery_task ¶

delivery_task(
    task_id: int | str | None = None,
) -> DeliveryTask

Создает доменный объект задачи доставки.

stock ¶

stock() -> Stock

Создает доменный объект остатков.

vacancy ¶

vacancy(vacancy_id: int | str | None = None) -> Vacancy

Создает доменный объект вакансии.

application ¶

application() -> Application

Создает доменный объект отклика.

resume ¶

resume(resume_id: int | str | None = None) -> Resume

Создает доменный объект резюме.

job_webhook ¶

job_webhook() -> JobWebhook

Создает доменный объект webhook раздела Работа.

job_dictionary ¶

job_dictionary(
    dictionary_id: int | str | None = None,
) -> JobDictionary

Создает доменный объект словаря Работа.

cpa_lead ¶

cpa_lead() -> CpaLead

Создает доменный объект CPA-лида.

cpa_chat ¶

cpa_chat(chat_id: int | str | None = None) -> CpaChat

Создает доменный объект CPA-чата.

cpa_call ¶

cpa_call() -> CpaCall

Создает доменный объект CPA-звонка.

cpa_archive ¶

cpa_archive(call_id: int | str | None = None) -> CpaArchive

Создает доменный объект архивных операций CPA.

call_tracking_call ¶

call_tracking_call(
    call_id: int | str | None = None,
) -> CallTrackingCall

Создает доменный объект CallTracking.

autoteka_vehicle ¶

autoteka_vehicle(
    vehicle_id: int | str | None = None,
) -> AutotekaVehicle

Создает доменный объект транспортного средства Автотеки.

autoteka_report ¶

autoteka_report(
    report_id: int | str | None = None,
) -> AutotekaReport

Создает доменный объект отчета Автотеки.

autoteka_monitoring ¶

autoteka_monitoring() -> AutotekaMonitoring

Создает доменный объект мониторинга Автотеки.

autoteka_scoring ¶

autoteka_scoring(
    scoring_id: int | str | None = None,
) -> AutotekaScoring

Создает доменный объект скоринга Автотеки.

autoteka_valuation ¶

autoteka_valuation() -> AutotekaValuation

Создает доменный объект оценки Автотеки.

realty_listing ¶

realty_listing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyListing

Создает доменный объект объявления недвижимости.

realty_booking ¶

realty_booking(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyBooking

Создает доменный объект бронирования недвижимости.

realty_pricing ¶

realty_pricing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyPricing

Создает доменный объект цен недвижимости.

realty_analytics_report ¶

realty_analytics_report(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> RealtyAnalyticsReport

Создает доменный объект аналитического отчета недвижимости.

review ¶

review() -> Review

Создает доменный объект отзыва.

review_answer ¶

review_answer(
    answer_id: int | str | None = None,
) -> ReviewAnswer

Создает доменный объект ответа на отзыв.

rating_profile ¶

rating_profile() -> RatingProfile

Создает доменный объект рейтингового профиля.

tariff ¶

tariff(tariff_id: int | str | None = None) -> Tariff

Создает доменный объект тарифа.

Асинхронная публичная точка входа SDK с factory-методами портированных доменов.

Initialize AsyncAvitoClient.

settings `property` ¶

settings: AvitoSettings

Возвращает read-only настройки клиента.

auth_provider `property` ¶

auth_provider: AsyncAuthProvider

Возвращает read-only auth provider клиента.

transport `property` ¶

transport: AsyncTransport

Возвращает read-only async transport клиента.

from_env `classmethod` ¶

from_env(
    *, env_file: str | Path | None = ".env"
) -> AsyncAvitoClient

Создает async-клиент из переменных окружения и optional .env файла.

auth ¶

auth() -> AsyncAuthProvider

Возвращает объект аутентификации и async token-flow операций.

debug_info ¶

debug_info() -> TransportDebugInfo

Возвращает безопасный снимок transport-настроек для диагностики.

business_summary `async` ¶

business_summary(
    *,
    user_id: int | str | None = None,
    listing_limit: int = 50,
    listing_page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> AccountHealthSummary

Возвращает итоговую async read-only сводку бизнеса.

account_health `async` ¶

account_health(
    *,
    user_id: int | str | None = None,
    listing_limit: int = 50,
    listing_page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> AccountHealthSummary

Возвращает итоговую async read-only health-сводку аккаунта.

listing_health `async` ¶

listing_health(
    *,
    user_id: int | str | None = None,
    limit: int = 50,
    page_size: int = 50,
    date_from: SummaryDate | None = None,
    date_to: SummaryDate | None = None,
) -> ListingHealthSummary

Возвращает async health-сводку объявлений.

chat_summary `async` ¶

chat_summary(
    *, user_id: int | str | None = None
) -> ChatSummary

Возвращает итоговую async read-only сводку по чатам.

order_summary `async` ¶

order_summary() -> OrderSummary

Возвращает итоговую async read-only сводку по заказам.

review_summary `async` ¶

review_summary() -> ReviewSummary

Возвращает итоговую async read-only сводку по отзывам.

promotion_summary `async` ¶

promotion_summary(
    *, item_ids: list[int] | None = None
) -> PromotionSummary

Возвращает итоговую async read-only сводку по продвижению.

capabilities ¶

capabilities() -> CapabilityDiscoveryResult

Возвращает справочник возможностей SDK без сетевых probe-запросов.

account ¶

account(user_id: int | str | None = None) -> AsyncAccount

Создает async-доменный объект аккаунта.

account_hierarchy ¶

account_hierarchy(
    user_id: int | str | None = None,
) -> AsyncAccountHierarchy

Создает async-доменный объект иерархии аккаунта.

ad ¶

ad(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AsyncAd

Создает async-доменный объект объявления.

ad_stats ¶

ad_stats(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AsyncAdStats

Создает async-доменный объект статистики объявления.

ad_promotion ¶

ad_promotion(
    item_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AsyncAdPromotion

Создает async-доменный объект продвижения объявления.

autoload_profile ¶

autoload_profile(
    user_id: int | str | None = None,
) -> AsyncAutoloadProfile

Создает async-доменный объект профиля автозагрузки.

autoload_report ¶

autoload_report(
    report_id: int | str | None = None,
) -> AsyncAutoloadReport

Создает async-доменный объект отчета автозагрузки.

autoload_archive ¶

autoload_archive(
    report_id: int | str | None = None,
) -> AsyncAutoloadArchive

Создает async-доменный объект архивных операций автозагрузки.

cpa_lead ¶

cpa_lead() -> AsyncCpaLead

Создает async-доменный объект CPA-лида.

cpa_chat ¶

cpa_chat(chat_id: int | str | None = None) -> AsyncCpaChat

Создает async-доменный объект CPA-чата.

cpa_call ¶

cpa_call() -> AsyncCpaCall

Создает async-доменный объект CPA-звонка.

cpa_archive ¶

cpa_archive(
    call_id: int | str | None = None,
) -> AsyncCpaArchive

Создает async-доменный объект архивных операций CPA.

call_tracking_call ¶

call_tracking_call(
    call_id: int | str | None = None,
) -> AsyncCallTrackingCall

Создает async-доменный объект CallTracking.

tariff ¶

tariff(tariff_id: int | str | None = None) -> AsyncTariff

Создает async-доменный объект тарифа.

review ¶

review() -> AsyncReview

Создает async-доменный объект отзыва.

review_answer ¶

review_answer(
    answer_id: int | str | None = None,
) -> AsyncReviewAnswer

Создает async-доменный объект ответа на отзыв.

rating_profile ¶

rating_profile() -> AsyncRatingProfile

Создает async-доменный объект рейтингового профиля.

realty_listing ¶

realty_listing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> AsyncRealtyListing

Создает async-доменный объект объявления недвижимости.

realty_booking ¶

realty_booking(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> AsyncRealtyBooking

Создает async-доменный объект бронирования недвижимости.

realty_pricing ¶

realty_pricing(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> AsyncRealtyPricing

Создает async-доменный объект цен недвижимости.

realty_analytics_report ¶

realty_analytics_report(
    item_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> AsyncRealtyAnalyticsReport

Создает async-доменный объект аналитического отчета недвижимости.

chat ¶

chat(
    chat_id: int | str | None = None,
    *,
    user_id: int | str | None = None,
) -> AsyncChat

Создает async-доменный объект чата.

chat_message ¶

chat_message(
    message_id: int | str | None = None,
    *,
    chat_id: int | str | None = None,
    user_id: int | str | None = None,
) -> AsyncChatMessage

Создает async-доменный объект сообщения чата.

chat_webhook ¶

chat_webhook() -> AsyncChatWebhook

Создает async-доменный объект webhook мессенджера.

chat_media ¶

chat_media(
    *, user_id: int | str | None = None
) -> AsyncChatMedia

Создает async-доменный объект медиа мессенджера.

special_offer_campaign ¶

special_offer_campaign(
    campaign_id: int | str | None = None,
) -> AsyncSpecialOfferCampaign

Создает async-доменный объект рассылки спецпредложений.

vacancy ¶

vacancy(
    vacancy_id: int | str | None = None,
) -> AsyncVacancy

Создает async-доменный объект вакансии.

application ¶

application() -> AsyncApplication

Создает async-доменный объект откликов.

resume ¶

resume(resume_id: int | str | None = None) -> AsyncResume

Создает async-доменный объект резюме.

job_webhook ¶

job_webhook() -> AsyncJobWebhook

Создает async-доменный объект webhook Авито Работы.

job_dictionary ¶

job_dictionary(
    dictionary_id: int | str | None = None,
) -> AsyncJobDictionary

Создает async-доменный объект справочника Авито Работы.

promotion_order ¶

promotion_order(
    order_id: int | str | None = None,
) -> AsyncPromotionOrder

Создает async-доменный объект заявок promotion.

bbip_promotion ¶

bbip_promotion(
    item_id: int | str | None = None,
) -> AsyncBbipPromotion

Создает async-доменный объект BBIP-продвижения.

trx_promotion ¶

trx_promotion(
    item_id: int | str | None = None,
) -> AsyncTrxPromotion

Создает async-доменный объект TrxPromo.

cpa_auction ¶

cpa_auction(
    item_id: int | str | None = None,
) -> AsyncCpaAuction

Создает async-доменный объект CPA-аукциона.

target_action_pricing ¶

target_action_pricing(
    item_id: int | str | None = None,
) -> AsyncTargetActionPricing

Создает async-доменный объект цены целевого действия.

autostrategy_campaign ¶

autostrategy_campaign(
    campaign_id: int | str | None = None,
) -> AsyncAutostrategyCampaign

Создает async-доменный объект кампании автостратегии.

order ¶

order() -> AsyncOrder

Создает async-доменный объект заказа.

order_label ¶

order_label(
    task_id: int | str | None = None,
) -> AsyncOrderLabel

Создает async-доменный объект этикетки заказа.

delivery_order ¶

delivery_order() -> AsyncDeliveryOrder

Создает async-доменный объект доставки.

sandbox_delivery ¶

sandbox_delivery() -> AsyncSandboxDelivery

Создает async-доменный объект песочницы доставки.

delivery_task ¶

delivery_task(
    task_id: int | str | None = None,
) -> AsyncDeliveryTask

Создает async-доменный объект задачи доставки.

stock ¶

stock() -> AsyncStock

Создает async-доменный объект остатков.

autoteka_vehicle ¶

autoteka_vehicle(
    vehicle_id: int | str | None = None,
) -> AsyncAutotekaVehicle

Создает async-доменный объект автомобиля Автотеки.

autoteka_report ¶

autoteka_report(
    report_id: int | str | None = None,
) -> AsyncAutotekaReport

Создает async-доменный объект отчетов Автотеки.

autoteka_monitoring ¶

autoteka_monitoring() -> AsyncAutotekaMonitoring

Создает async-доменный объект мониторинга Автотеки.

autoteka_scoring ¶

autoteka_scoring(
    scoring_id: int | str | None = None,
) -> AsyncAutotekaScoring

Создает async-доменный объект скоринга Автотеки.

autoteka_valuation ¶

autoteka_valuation() -> AsyncAutotekaValuation

Создает async-доменный объект оценки автомобиля Автотеки.

aclose `async` ¶

aclose() -> None

Закрывает transport и auth-provider; повторный вызов безопасен.

Безопасная диагностика¶

Возвращает безопасный снимок transport-настроек для диагностики.

AvitoClient и AsyncAvitoClient¶

Контракт¶

Фасад¶

settings property ¶

auth_provider property ¶

transport property ¶

from_env classmethod ¶

auth ¶

debug_info ¶

business_summary ¶

account_health ¶

listing_health ¶

chat_summary ¶

order_summary ¶

review_summary ¶

promotion_summary ¶

capabilities ¶

close ¶

account ¶

account_hierarchy ¶

ad ¶

ad_stats ¶

ad_promotion ¶

autoload_profile ¶

autoload_report ¶

autoload_archive ¶

chat ¶

chat_message ¶

chat_webhook ¶

chat_media ¶

special_offer_campaign ¶

promotion_order ¶

bbip_promotion ¶

trx_promotion ¶

cpa_auction ¶

target_action_pricing ¶

autostrategy_campaign ¶

order ¶

order_label ¶

delivery_order ¶

sandbox_delivery ¶

delivery_task ¶

stock ¶

vacancy ¶

application ¶

resume ¶

job_webhook ¶

job_dictionary ¶

cpa_lead ¶

cpa_chat ¶

cpa_call ¶

cpa_archive ¶

call_tracking_call ¶

autoteka_vehicle ¶

autoteka_report ¶

autoteka_monitoring ¶

autoteka_scoring ¶

autoteka_valuation ¶

realty_listing ¶

realty_booking ¶

realty_pricing ¶

realty_analytics_report ¶

review ¶

review_answer ¶

rating_profile ¶

tariff ¶

settings property ¶

auth_provider property ¶

transport property ¶

from_env classmethod ¶

auth ¶

debug_info ¶

business_summary async ¶

account_health async ¶

listing_health async ¶

chat_summary async ¶

order_summary async ¶

review_summary async ¶

promotion_summary async ¶

capabilities ¶

settings `property` ¶

auth_provider `property` ¶

transport `property` ¶

from_env `classmethod` ¶

settings `property` ¶

auth_provider `property` ¶

transport `property` ¶

from_env `classmethod` ¶

business_summary `async` ¶

account_health `async` ¶

listing_health `async` ¶

chat_summary `async` ¶

order_summary `async` ¶

review_summary `async` ¶

promotion_summary `async` ¶

aclose `async` ¶