How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Avito

Avito Ads API

The Ads API from Avito — 23 operation(s) for ads.

Documentation Provider Profile APIs.io OpenAPI GitHub

Avito Ads API is one of 51 APIs that Avito publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Ads. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 24 operations across 23 paths, and defines 81 schemas. It is described by OpenAPI 3.2.0, at version 1.

Requests are made against a single base URL, https://api.avito.ru/.

24 operations 23 paths 81 schemas 1 DELETE5 GET18 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1
Base URL
https://api.avito.ru/
Authentication
OAuth 2.0, OAuth 2.0
Contact
supportautoload@avito.ru
Resource Areas
1

Authentication & Security 2

Avito Ads API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (AuthorizationCode) using the authorizationCode flow, exposing 1 scope. It supports OAuth 2.0 (ClientCredentials) using the clientCredentials flow.

  • AuthorizationCode — Это API использует OAuth 2 с механизмом authorizationcode. Используйте его для доступа к данным других пользователей при разработке стороннего приложения. [Под…
  • ClientCredentials — Это API использует OAuth 2 с механизмом clientcredentials. Используйте его для доступа к возможностям своей личной учетной записи. [Подробнее](tag/Access)

Paths & Operations 24

Across 23 paths, the API surfaces 24 operations — 1 DELETE, 5 GET, 18 POST. Each is listed below with its method, path, parameters, and response codes.

Ads 24
GET
/ads/v1/account/{accountID}
Получить аккаунт по ID
V1GetAccountByID 1 param → 200400401403404429500503
POST
/ads/v1/account/{accountID}
Создать аккаунт в песочнице
V1CreateAccount 1 param body → 200207400401403429500503
POST
/ads/v1/account/{accountID}/add-user
Добавить пользователя в аккаунт
V1AddUser 1 param body → 200400401403429500503
POST
/ads/v1/account/{accountID}/advertisers
Получить список рекламодателей по фильтрам
V1GetAdvertisersList 1 param body → 200400401403404429500503
GET
/ads/v1/account/{accountID}/balance
Получить баланс аккаунта по ID
V1GetAccountBalanceByID 1 param → 200400401403404429500503
POST
/ads/v1/account/{accountID}/bonus-transfer
Перевод бонусов между аккаунтом родителем и дочерними на одном договоре
V1TransferBonus 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/campaigns
Получить список кампаний по фильтрам
V1GetCampaignsList 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/campaigns/{campaignID}/creatives/stats
Получить статистику по креативам кампании
V1GetCreativesStatistic 2 params body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/campaigns/{campaignID}/groups/stats
Получить статистику по группам кампании
V1GetGroupsStatistic 2 params body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/campaigns/{campaignID}/stats
Получить статистику по кампании
V1GetCampaignStatistic 2 params body → 200400401403404429500503
GET
/ads/v1/account/{accountID}/children
Получить список дочерних аккаунтов
V1GetChildAccountsList 1 param → 200400401403404429500503
GET
/ads/v1/account/{accountID}/children-with-balances
Получить список дочерних аккаунтов с балансами
V1GetChildAccountsWithBalancesList 1 param → 200400401403404429500503
POST
/ads/v1/account/{accountID}/contracts
Получить список договоров по фильтрам
V1GetContractsList 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/create-advertiser
Создать рекламодателя
V1CreateAdvertiser 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/create-contract
Создание изначального договора
V1CreateContract 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/create-nonpayer-child-account
Создание дочернего аккаунта на договоре родителя
V1CreateNonPayerAccount 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/creatives
Получить список креативов по фильтрам
V1GetCreativesList 1 param body → 200400401403404429500503
DELETE
/ads/v1/account/{accountID}/delete-user/{userID}
Удалить пользователя из аккаунта
V1DeleteUser 2 params → 200400401403429500503
POST
/ads/v1/account/{accountID}/funds-transfer
Перевод денег между аккаунтом родителем и дочерними на одном договоре
V1TransferFunds 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/group/{groupID}/change-budget
Изменить бюджет группы
V1ChangeBudget 2 params body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/group/{groupID}/change-price
Изменить цену группы
V1ChangePrice 2 params body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/groups
Получить список групп по фильтрам
V1GetGroupsList 1 param body → 200400401403404429500503
POST
/ads/v1/account/{accountID}/set-user-role
Изменить роль пользователя в аккаунте
V1SetUserRole 1 param body → 200400401403429500503
GET
/ads/v1/account/{accountID}/users
Получить список пользователей аккаунта
V1GetUsersListByAccount 1 param → 200400401403429500503

Schemas 81

The contract defines 81 schemas that model the data the API accepts and returns. The most detailed are Group (40 properties), Creative (19 properties), StatsData (18 properties), Campaign (18 properties). Each schema is shown below with its type and property counts.

V1GetChildAccountsWithBalancesListOut
object
1 property 1 required
V1GetAccountBalanceByIdOut
object
4 properties 4 required
V1TransferFundsIn
object
Payload Перевода денег между аккаунтом родителем и дочками неплательщиками
2 properties 2 required
CreteIntermediaryIn
objectnull
Данные исполнителя по договору. Для доп соглашений не передаем. Для договоров обязательно передавать.
8 properties
User
object
3 properties 3 required
CampaignPaymentModel
string
Модель оплаты кампании
CampaignStatus
string
Статус кампании
ShortAccount
object
2 properties 2 required
ScheduleType
string
Тип расписания показов
V1GetCreativesListIn
object
Payload запроса на получение списка креативов
3 properties 3 required
V1GetCampaignsListIn
object
Payload запроса на получение списка кампаний
3 properties 3 required
Campaign
object
18 properties
V1GetCampaignsListOut
object
2 properties 2 required
EmptyResponse
object
LegalRole
string
Роль ЮЛ
ContractSubject
string
Предмет договора
GroupFormat
string
Формат группы объявлений
V1SetUserRoleIn
object
Payload изменение роли пользователя в аккаунте
2 properties 2 required
V1ChangePriceIn
object
Payload для изменения ставки группы
1 property 1 required
AudienceType
string
Тип аудитории таргетинга группы
FrequencyPeriod
string
Период частотного ограничения
ContractType
string
Тип контракта
V1CreateNonPayerAccountOut
object
3 properties 3 required
CreativesFilter
object
9 properties
V1GetContractsListIn
object
Payload запроса на получение списка договоров
3 properties 3 required
CampaignsFilter
object
10 properties
Contract
object
14 properties 5 required
V1GetUsersListByAccountOut
object
2 properties 2 required
V1CreateContractIn
object
Payload запроса на создание договора. Базово обязательны description, advertiserId, type. Для type = service дополнительно передаются subject, isReportingRequi…
12 properties 3 required
LegalInfo
object
4 properties
V1AddUserIn
object
Payload добавления пользователя в аккаунт
2 properties 2 required
V1GetGroupsStatisticOut
object
Статистика по группам кампании
1 property 1 required
BudgetFrequency
string
Частота расходования бюджета
V1GetGroupsListOut
object
2 properties 2 required
V1GetChildAccountsListOut
object
1 property 1 required
V1GetCampaignStatisticOut
object
Статистика по кампании
3 properties 3 required
Account
object
9 properties 8 required
ActivityScheduleHours
array
Расписание активности на день по часам (0-23)
UserRole
string
Роль пользователя в рекламном кабинете
V1CreateAdvertiserOut
object
1 property 1 required
Advertiser
object
11 properties 10 required
GroupsFilter
object
8 properties
ShortAccountWithBalance
object
2 properties 2 required
V1GetGroupsStatisticIn
object
Request body для запроса статистики по группам кампании. Максимальный период между dateFrom и dateTo — 100 дней.
3 properties 3 required
V1GetCreativesListOut
object
2 properties 2 required
CampaignStatistic
object
Статистика кампании
6 properties 6 required
V1GetAdvertisersListIn
object
Payload запроса на получение списка рекламодателей
3 properties 3 required
V1GetCreativesStatisticOut
object
Статистика по креативам кампании
1 property 1 required
ContractForChildAccount
objectnull
14 properties
V1CreateNonPayerAccountIn
object
Payload создания аккаунта
2 properties 2 required
CampaignType
string
Тип кампании
V1GetGroupsListIn
object
Payload запроса на получение списка кампаний
3 properties 3 required
Creative
object
19 properties
GroupStatistic
object
Статистика группы
4 properties 4 required
ContractCounterpartyType
string
V1ChangeBudgetIn
object
Payload для изменения бюджета группы
1 property 1 required
StatsData
object
Данные статистики за период
18 properties 7 required
GroupPriceControl
string
Контроль цены группы
GroupsStatus
string
Статус группы объявлений
V1GetContractsListOut
object
2 properties 2 required
V1CreateAdvertiserIn
object
Payload создания рекламодателя
9 properties 7 required
V1GetAdvertisersListOut
object
2 properties 2 required
V1GetCreativesStatisticIn
object
Request body для запроса статистики по креативам кампании. Максимальный период между dateFrom и dateTo — 100 дней.
3 properties 3 required
CreativeStatistic
object
Статистика креатива
5 properties 5 required
CreativesStatus
string
Статус креатива
LegalType
string
Тип ЮЛ
ContractAction
string
Описание действия договора
V1CreateAccountIn
object
Payload создания аккаунта
9 properties 7 required
ShortAccountWithContract
object
2 properties 1 required
V1GetAccountByIdOut
object
1 property
FrequencyRule
object
Правило частотного ограничения
2 properties 2 required
V1GetCampaignStatisticIn
object
Request body для запроса статистики по кампании. Максимальный период между dateFrom и dateTo — 100 дней.
2 properties 2 required
Error
object
2 properties 2 required
ContractsFilter
object
4 properties
Paces
string
Скорости показов
V1CreateContractOut
object
1 property 1 required
DateRange
objectnull
Диапазон дат
2 properties
V1CreateAccountOut
object
2 properties 2 required
AdvertiserFilter
object
3 properties
V1TransferBonusIn
object
Payload Перевода денег между аккаунтом родителем и дочками неплательщиками
2 properties 2 required
Group
object
40 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

avito-ads-api-openapi.yml Raw ↑

Other APIs Avito publishes across the network.

Avito Access API
AE Profile APIs.io
Avito ApplicationAccess API
AE Profile APIs.io
Avito Auction API
AE Profile APIs.io
Avito Authorization API
AE Profile APIs.io
Avito Autoload API
AE Profile APIs.io
Avito Autostrategy API
AE Profile APIs.io
Avito balance API
AE Profile APIs.io
Avito Call API
AE Profile APIs.io
Avito Calltracking API
AE Profile APIs.io
Avito Chat API
AE Profile APIs.io
Avito CheckAhUserV1 API
AE Profile APIs.io
Avito CheckAhUserV2 API
AE Profile APIs.io
#Ads
← Back to A APIs
API Details
ID
avito:avito-ads-api
Base URL
https://api.avito.ru/
Docs
https://developers.avito.ru/api-catalog/accounts-hierarchy/documentation
Provider
Avito
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=avito-ads-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/avito-ads-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Avito Ads API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.