find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/avito-autostrategy-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  contact:
    email: supportautoload@avito.ru
  description: 'API для взаимодействия с иерархией аккаунтов в Авито

    **Авито API для бизнеса предоставляется согласно [Условиям использования](https://www.avito.ru/legal/pro_tools/public-api).**

    '
  title: Иерархия Аккаунтов Access Autostrategy API
  version: '1'
servers:
- url: https://api.avito.ru/
tags:
- description: 'API для работы с автостратегией в категории

    '
  name: Autostrategy
  x-displayName: Autostrategy
paths:
  /autostrategy/v1/budget:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      operationId: getAutostrategyBudget
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetBudgetRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  budget:
                    $ref: '#/components/schemas/Budget'
                  calcId:
                    description: Id расчета бюджета
                    example: 123
                    type:
                    - integer
                    - 'null'
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBudgetBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBudgetConflictError'
          description: Ошибка бизнес-логики
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Расчет бюджета кампании
      tags:
      - Autostrategy
  /autostrategy/v1/campaign/create:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      operationId: createAutostrategyCampaign
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCampaignRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  campaign:
                    $ref: '#/components/schemas/Campaign'
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCampaignBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCampaignConflictError'
          description: Ошибка бизнес-логики
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Создание новой кампании
      tags:
      - Autostrategy
  /autostrategy/v1/campaign/edit:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      description: '**Возможно редактирование лишь только кампаний, имеющих тип `AS`**

        '
      operationId: editAutostrategyCampaign
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditCampaignRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  campaign:
                    $ref: '#/components/schemas/Campaign'
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EditCampaignBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EditCampaignConflictError'
          description: Ошибка бизнес-логики
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Редактирование кампании
      tags:
      - Autostrategy
  /autostrategy/v1/campaign/info:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      operationId: getAutostrategyCampaignInfo
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCampaignInfoRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  campaign:
                    $ref: '#/components/schemas/Campaign'
                  forecast:
                    $ref: '#/components/schemas/GetCampaignInfoForecastResult'
                  items:
                    description: Список индентификаторов объявлений, которые продвигаются/продвигались в данной кампании
                    items:
                      properties:
                        isActive:
                          description: Продвигается ли объявление в кампании на данный момент
                          example: true
                          type: boolean
                        itemId:
                          description: ID объявления
                          example: 12345678
                          type: integer
                      type: object
                    type: array
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCampaignInfoBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictError'
          description: Ошибка бизнес-логики
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Получение полной информации о кампании
      tags:
      - Autostrategy
  /autostrategy/v1/campaign/stop:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      operationId: stopAutostrategyCampaign
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StopCampaignRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  campaign:
                    $ref: '#/components/schemas/Campaign'
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StopCampaignBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Остановка кампании
      tags:
      - Autostrategy
  /autostrategy/v1/campaigns:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      description: '**Получение кампаний текущего пользователя с учетом фильтров**

        '
      operationId: getAutostrategyCampaigns
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCampaignsRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaigns'
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCampaignsBadRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Получение списка кампаний
      tags:
      - Autostrategy
  /autostrategy/v1/stat:
    parameters:
    - $ref: '#/components/parameters/authHeader'
    post:
      operationId: getAutostrategyStat
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetStatRequestBody'
        description: Набор параметров в теле запроса.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  stat:
                    $ref: '#/components/schemas/Stat'
                  totals:
                    description: Статистика, просумированная за все дни
                    properties:
                      calls:
                        description: Факт по звонкам
                        example: 50
                        type: integer
                      views:
                        description: Факт по просмотрам
                        example: 500
                        type: integer
                    required:
                    - calls
                    - views
                    type: object
                type: object
          description: Успешный ответ
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStatRequestError'
          description: Неверный запрос
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyAuthError'
          description: Требуется аутентификация
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictError'
          description: Ошибка бизнес-логики
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/autostrategyServiceError'
          description: Внутренняя ошибка метода API
      security:
      - Client Credentials: []
      summary: Получение статистики по кампании
      tags:
      - Autostrategy
components:
  schemas:
    autostrategyServiceError:
      properties:
        error:
          properties:
            message:
              description: Описание ошибки
              example: internal server error
              type: string
          required:
          - code
          - message
          type: object
      type: object
    CreateCampaignBadRequestError:
      properties:
        error:
          properties:
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                budget:
                  description: Ошибка валидации поля **budget**
                  type: string
                budgetBonus:
                  description: Ошибка валидации поля **budgetBonus**
                  type: string
                budgetReal:
                  description: Ошибка валидации поля **budgetReal**
                  type: string
                campaignType:
                  description: Ошибка валидации поля **campaignType**
                  type: string
                description:
                  description: Ошибка валидации поля **description**
                  type: string
                finishTime:
                  description: Ошибка валидации поля **finishTime**
                  type: string
                items:
                  description: Ошибка валидации поля **items**
                  type: string
                startTime:
                  description: Ошибка валидации поля **startTime**
                  type: string
                title:
                  description: Ошибка валидации поля **title**
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    GetStatRequestError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки
              example: 400
              type: integer
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                campaignId:
                  description: Ошибка валидации поля **campaignId**
                  example: campaignId should be greater than 0
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    CreateCampaignRequestBody:
      properties:
        budget:
          description: Выделенный бюджет на кампанию в рублях.<br/>**Обязательно только для типа кампании `AS`**
          example: 10000
          type: integer
        budgetBonus:
          description: Бонусная часть бюджета, в рублях, которая спишется засчет бонусов.<br/>**Может быть только для типа кампании `AP`**
          example: 100
          type: integer
        budgetReal:
          description: Часть бюджета на кампанию в рублях.<br/>**Обязательно только для типа кампании `AP`**
          example: 10000
          type: integer
        calcId:
          description: Идентфикатор расчета бюджета из ответа ручки `/autostrategy/v1/budget`
          example: 123
          type:
          - integer
          - 'null'
        campaignType:
          description: Тип кампании. Возможные типы:<br/> `AS` - Автостратегия. Cтратегия расчитана на определенное количество автомобилей, которые находятся в продаже<br/> `AP` - Автопилот. Cтратегия расчитана на все автомобили, которые находятся в продаже<br/>
          example: AS
          type: string
        description:
          description: Описание кампании
          example: Toyota, Lexus, BMW 2020 года выпуска
          type: string
        finishTime:
          description: Время окончания кампании.<br/>**Обязательно только для типа кампании `AS`**
          example: '2019-10-24T14:15:22Z'
          format: date-time
          type: string
        items:
          description: Список индентификаторов объявлений, которые будут продвигаться с помощью данной кампании.<br/>**Обязательно только для типа кампании `AS`**
          example:
          - 123123214
          - 455454235
          - 87746346
          items:
            type: integer
          type: array
        startTime:
          description: Время начала кампании.<br/>**Обязательно только для типа кампании `AS`**
          example: '2019-08-24T14:15:22Z'
          format: date-time
          type: string
        title:
          description: Название кампании
          example: Внедорожники Москвы
          type: string
      required:
      - campaignType
      - title
      type: object
    Stat:
      description: Статистика по дням с агрегацией по всем объявлениям в кампании
      items:
        properties:
          calls:
            description: Факт по звонкам
            example: 10
            type: integer
          callsForecast:
            description: Предсказание звонков
            properties:
              from:
                description: Нижняя граница предсказания
                example: 8
                type: integer
              to:
                description: Верхняя граница предсказания
                example: 12
                type: integer
            required:
            - from
            - to
            type:
            - object
            - 'null'
          date:
            description: Дата в формате `YYYY-MM-DD`
            example: '2021-01-25'
            format: date
            type: string
          views:
            description: Факт по просмотрам
            example: 100
            type: integer
          viewsForecast:
            properties:
              from:
                description: Нижняя граница предсказания
                example: 80
                type: integer
              to:
                description: Верхняя граница предсказания
                example: 120
                type: integer
            required:
            - from
            - to
            type:
            - object
            - 'null'
        required:
        - date
        - calls
        - views
        type: object
      type: array
    ConflictError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки. Возможные ошибки:<br/> `2` - кампания не найдена<br/>
              example: 2
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: campaign not found
              type: string
          type: object
      type: object
    GetCampaignsBadRequestError:
      properties:
        error:
          properties:
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                limit:
                  description: Ошибка валидации поля **limit**
                  type: string
                offset:
                  description: Ошибка валидации поля **offset**
                  type: string
                orderBy:
                  description: Ошибка валидации поля **orderBy**
                  properties:
                    column:
                      description: Ошибка валидации поля **column**
                      type: string
                    direction:
                      description: Ошибка валидации поля **direction**
                      type: string
                  type: object
                statusId:
                  description: Ошибка валидации поля **statusId**
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    autostrategyAuthError:
      properties:
        error:
          properties:
            message:
              description: Сообщение об ошибке
              example: unauthorized
              type: string
          required:
          - message
          type: object
      type: object
    GetCampaignInfoRequestBody:
      properties:
        campaignId:
          description: Идентификатор активной кампании
          example: 3456432
          type: integer
      required:
      - campaignId
      type: object
    GetBudgetConflictError:
      properties:
        error:
          properties:
            code:
              description: Код ошибки. Возможные ошибки:<br/> `1` - Слишком много объявлений для расчета бюджета<br/> `6` - Тариф не активен<br/>
              example: 6
              format: int32
              type: integer
            message:
              description: Сообщение об ошибке
              example: get budget failed
              type: string
          type: object
      type: object
    StopCampaignBadRequestError:
      properties:
        error:
          properties:
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                campaignId:
                  description: Ошибка валидации поля **campaignId**
                  type: string
                version:
                  description: Ошибка валидации поля **version**
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    StopCampaignRequestBody:
      properties:
        campaignId:
          description: Идентификатор активной кампании
          example: 3456432
          type: integer
        version:
          description: Текущая версия кампании
          example: 3
          type: integer
      required:
      - campaignId
      - version
      type: object
    GetCampaignInfoBadRequestError:
      properties:
        error:
          properties:
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                campaignId:
                  description: Ошибка валидации поля **campaignId**
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    Campaign:
      description: Кампания
      properties:
        balance:
          description: Оставшиеся средства от всего бюджета на продвижение кампании
          example: 1000
          type: integer
        budget:
          description: Бюджет кампании в рублях
          example: 10000
          type: integer
        campaignId:
          description: Идентификатор кампании
          example: 3456432
          type: integer
        campaignType:
          description: Тип кампании. Возможные типы:<br/> `AS` - Автостратегия. Cтратегия расчитана на определенное количество автомобилей, которые находятся в продаже<br/> `AP` - Автопилот. Cтратегия расчитана на все автомобили, которые находятся в продаже<br/>
          example: AS
          type: string
        createTime:
          description: Время создания кампании
          example: '2018-08-24T14:15:22Z'
          format: date-time
          type: string
        description:
          description: Новое описание кампании
          example: Toyota, Lexus, BMW, Audi 2019 и 2020 года выпуска
          type: string
        finishTime:
          description: Время окончания кампании
          example: '2020-08-24T14:15:22Z'
          format: date-time
          type: string
        itemsCount:
          description: Количество объявлений, которые продвигаются с помощью данной кампании
          example: 10
          type: integer
        startTime:
          description: Время начала кампании
          example: '2019-08-24T14:15:22Z'
          format: date-time
          type: string
        statusId:
          description: Статусы кампании для выборки. Возможные статусы:<br/> `0` - Черновик, дата старта сегодня или раньше, денег на балансе нет<br/> `1` - Активная кампания, участвует в аукционе<br/> `2` - Кампания приостановлена<br/> `3` - Кампания удалена<br/> `4` - Кампания остановлена<br/> `5` - Кампания запланирована, дата старта завтра или позже, на балансе есть деньги<br/>
          example: 1
          type: integer
        title:
          description: Новое название кампании
          example: Внедорожники Москвы и Санкт-Петербурга
          type: string
        updateTime:
          description: Время последнего обновления кампании
          example: '2020-01-01T14:15:22Z'
          format: date-time
          type: string
        userId:
          description: Идентификатор пользователя-владельца кампании
          example: 345632234325
          type: integer
        version:
          description: Текущая версия кампании
          example: 3
          type: integer
      type:
      - object
      - 'null'
    GetBudgetBadRequestError:
      properties:
        error:
          properties:
            fieldErrors:
              description: Описание ошибок валидации полей
              properties:
                campaignType:
                  description: Ошибка валидации поля **campaignType**
                  type: string
                finishTime:
                  description: Ошибка валидации поля **finishTime**
                  type: string
                items:
                  description: Ошибка валидации поля **items**
                  type: string
                startTime:
                  description: Ошибка валидации поля **startTime**
                  type: string
              type: object
            message:
              description: Сообщение об ошибке
              example: bad request
              type: string
          required:
          - message
          type: object
      type: object
    Campaigns:
      description: Список кампаний
      properties:
        campaigns:
          description: Список кампаний, удовлетворяющих фильтрам, с учетом смещения и ограничения
          items:
            $ref: '#/components/schemas/Campaign'
          type: array
        totalCount:
          description: Общее количество кампаний, удовлетворяющих фильтрам
          example: 10
          type: integer
      type: object
    EditCampaignRequestBody:
      properties:
        budget:
          description: Новый бюджет кампании в рублях
          example: 1000
          type: integer
        calcId:
          description: Идентификатор расчета бюджета из ответа ручки `/autostrategy/v1/budget`
          example: 123
          type:
          - integer
          - 'null'
        campaignId:
          description: Идентификатор активной кампании
          example: 3456432
          type: integer
        description:
          description: Новое описание кампании
          example: Toyota, Lexus, BMW, Audi 2019 и 2020 года выпуска
          type: string
        finishTime:
          description: Новое время окончания кампании
          example: '2020-08-24T14:15:22Z'
          format: date-time
          type: string
        items:
          description: Новый список индентификаторов объявлений, которые будут продвигаться с помощью данной кампании
       

# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/avito/refs/heads/main/openapi/avito-autostrategy-api-openapi.yml