### Get Items Information

Source: https://developers.avito.ru/api-catalog/item/documentation

This snippet demonstrates how to make a GET request to the Avito API to retrieve a list of items. It includes example query parameters for pagination and filtering by status, and a header parameter for authorization. The response sample shows the structure of the returned data, including metadata and a list of resources.

```http
GET /core/v1/items?per_page=50&page=1&status=active,old&updatedAtFrom=2023-12-18&category=111 HTTP/1.1
Host: api.avito.ru
Authorization: Bearer ACCESS_TOKEN
```

--------------------------------

### Campaign Response Example

Source: https://developers.avito.ru/api-catalog/ads/documentation

Example JSON response when listing campaigns, showing details of a single campaign.

```json
{
  "total": 1,
  "campaigns": [
    {
      "id": 1234567890,
      "name": "Кампания 1",
      "status": "active",
      "budget": 100000,
      "budgetKopeks": 10000000,
      "paymentModel": "CPC",
      "campaignType": "textImage",
      "startDate": "2025-01-01",
      "endDate": "2025-12-31",
      "accountId": 123456789,
      "advertiserId": 987654321,
      "contractId": 1122334455,
      "userId": 12345,
      "managerID": 67890,
      "createdAt": "2025-01-01T10:00:00Z",
      "updatedAt": "2025-01-15T12:30:00Z"
    }
  ]
}
```

--------------------------------

### Get Promotion Services Response (Success)

Source: https://developers.avito.ru/api-catalog/promotion/documentation

This is a sample successful response (200 OK) for the promotion services request. It includes item details and associated promotion service information like start and end dates.

```json
{
  "items": [
    {
      "itemId": 0,
      "services": [
        {
          "endDate": "2019-08-24T14:15:22Z",
          "name": "string",
          "slug": "string",
          "startDate": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ]
}
```

--------------------------------

### Get Promotion Services Response (Error Example)

Source: https://developers.avito.ru/api-catalog/promotion/documentation

This is a sample error response (e.g., 400 Bad Request or 422 Unprocessable Entity) for the promotion services request. It details the error code, text, and the affected item ID.

```json
{
  "errors": [
    {
      "errorCode": 1005,
      "errorText": "Услуга недоступна для объявлений с типом Резюме",
      "itemId": 2
    }
  ],
  "items": []
}
```

--------------------------------

### Create Announcement Request Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a request to create an announcement in the delivery service. Pay attention to the structure for packages that are also грузоместа (shipping units).

```json
{
  "announcementID": "string",
  "sender": {
    "name": "string",
    "contact": {
      "phone": "string",
      "email": "string"
    }
  },
  "recipient": {
    "name": "string",
    "contact": {
      "phone": "string",
      "email": "string"
    }
  },
  "shipmentDate": "string",
  "packages": [
    {
      "id": "string",
      "senderBarcode": "string",
      "sealID": "string",
      "parcels": [
        {
          "id": "string",
          "barcode": "string"
        }
      ]
    }
  ]
}
```

--------------------------------

### Example Parcel Creation Request

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

This is a standard example of a request to create a parcel. It includes fields like orderID, directOrderID, parcelID, barcodes, and items.

```json
{
  "orderID": "12345",
  "directOrderID": "67890",
  "parcelID": "P00037988",
  "barcodes": [
    "1234567890",
    "0987654321"
  ],
  "items": [
    {
      "name": "Example Item",
      "count": 1,
      "sku": "SKU123"
    }
  ]
}
```

--------------------------------

### Package with Empty ID and Barcode Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a package object in the 'packages' array where 'id' and 'barcode' are empty. This occurs when a package is not registered in the delivery service at the time the announcement is received.

```json
{
  "id": "",
  "senderBarcode": "",
  "parcels": [
    {
      "id": "",
      "barcode": ""
    }
  ]
}
```

--------------------------------

### Search Resumes with Parameters

Source: https://developers.avito.ru/api-catalog/job/documentation

Demonstrates how to search for resumes using various query parameters. This snippet shows a basic example of how to structure a search request.

```http
GET /job/v1/cv?query=оператор call-центра&fields=title,specialization,total_experience,salary&location=637640&specialization=10175,10186&schedule=remote&gender=female&age_min=25&age_max=40&education_level=higher HTTP/1.1
Host: api.avito.ru
Accept: application/json
```

--------------------------------

### Get BBIP Promotion Budget Options

Source: https://developers.avito.ru/api-catalog/promotion/documentation

Retrieves available budget options for promoting items. Requires item IDs and specific authorization.

```APIDOC
## POST /promotion/v1/items/services/bbip/suggests/get

### Description
Retrieves available budget options for promoting items. This endpoint is used to get suggestions for promotion budgets based on provided item IDs.

### Method
POST

### Endpoint
https://api.avito.ru/promotion/v1/items/services/bbip/suggests/get

### Header Parameters
- **Authorization** (string) - Required - Bearer ACCESS_TOKEN. Token for authorization.
- **X-Is-Employee** (string) - Deprecated - Use X-Employee-Of. Indicates if the user is acting on behalf of a company employee (true/false).
- **X-Employee-Of** (integer) - Optional - The ID of the company the employee is acting on behalf of.

### Request Body
#### Request Body schema: application/json
- **itemIds** (Array of integers) - Required - A list of item IDs (up to 100) for which to get budget options.

### Request Example
```json
{
  "itemIds": [
    0
  ]
}
```

### Responses
#### Success Response (200)
OK. Returns a list of budget options for the specified items.
- **items** (Array) - List of items with their promotion budget suggestions.
  - **itemId** (integer) - The ID of the item.
  - **budgets** (Array) - List of available budget options for the item.
    - **isRecommended** (boolean) - Indicates if this budget is recommended.
    - **oldPrice** (integer) - The original price of the promotion.
    - **price** (integer) - The current price of the promotion.
  - **duration** (object) - Recommended duration for the promotion.
    - **from** (integer) - Minimum duration in days.
    - **recommended** (integer) - Recommended duration in days.
    - **to** (integer) - Maximum duration in days.

#### Error Response (400)
Bad Request. Validation error.

#### Error Response (401)
Unauthorized. Authentication error.

#### Error Response (403)
Forbidden. Access denied.

#### Error Response (404)
Not Found. Item not found.

#### Error Response (422)
Unprocessable Entity. Request processing error.

#### Error Response (500)
Internal Server Error.

### Response Example (200)
```json
{
  "errors": [
    {
      "errorCode": 1005,
      "errorText": "Услуга недоступна для объявлений с типом Резюме",
      "itemId": 2
    }
  ],
  "items": [
    {
      "budgets": [
        {
          "isRecommended": true,
          "oldPrice": 10000,
          "price": 10000
        }
      ],
      "duration": {
        "from": 1,
        "recommended": 5,
        "to": 7
      },
      "itemId": 2
    }
  ]
}
```
```

--------------------------------

### Apply Promotion Request Payload

Source: https://developers.avito.ru/api-catalog/trxpromo/documentation

Example JSON payload for the `post/trx-promo/1/apply` endpoint. This demonstrates how to specify commission rates, start dates, and end dates for promoting items.

```json
{
  "items": [
    {
      "commission": 1500,
      "dateFrom": "2024-12-01",
      "dateTo": "2024-12-31",
      "itemID": 0
}
]

}
```

--------------------------------

### Get all ads from a specific upload (deprecated)

Source: https://developers.avito.ru/api-catalog/autoload/documentation

Retrieve processed results for each ad within a specific upload. This method is deprecated and will be disabled on 08.03.2027, with reduced data returned starting 08.09.2026.

```APIDOC
## GET /autoload/v2/reports/{report_id}/items

### Description
Retrieves processed results for each ad within a specific upload. This method is deprecated.

### Method
GET

### Endpoint
https://api.avito.ru/autoload/v2/reports/{report_id}/items

### Parameters
#### Path Parameters
- **report_id** (integer) - Required - Идентификатор отчёта (ID)

#### Query Parameters
- **per_page** (integer) - Optional - Количество объявлений на странице: целое число больше 0 и меньше или равно 200. Default: 50
- **page** (integer) - Optional - Номер страницы: целое число больше 0. Default: 0
- **query** (string) - Optional - Фильтр по ID объявления. Формат значения: строка с идентификаторами объявлений из файла или идентификаторами объявлений на Авито, перечисленными через «,» или «|».
- **sections** (string) - Optional - Фильтр объявлений по разделам. Формат значения: строка с идентификаторами разделов, перечисленными через «,» или «|». Получить список разделов для конкретного отчёта можно с помощью метода Статистика по конкретной выгрузке.

### Responses
#### Success Response (200)
- **items** (array) - List of processed ad items.
- **meta** (object) - Metadata for pagination.
- **report_id** (integer) - The ID of the report.

#### Response Example (200)
```json
{
  "items": [
    {
      "ad_id": "string",
      "applied_vas": [
        {
          "price": 0,
          "slug": "xl",
          "title": "string"
        }
      ],
      "avito_date_end": "string",
      "avito_id": 0,
      "avito_status": "active",
      "feed_name": "string",
      "messages": [
        {
          "code": 0,
          "description": "string",
          "title": "string",
          "type": "error",
          "updated_at": "2019-08-24T14:15:22Z"
        }
      ],
      "section": {
        "slug": "string",
        "title": "string"
      },
      "url": "string"
    }
  ],
  "meta": {
    "page": 0,
    "pages": 0,
    "per_page": 0,
    "total": 0
  },
  "report_id": 0
}
```

#### Default Response
Information about the error.
```

--------------------------------

### Calculate Campaign Budget Response

Source: https://developers.avito.ru/api-catalog/autostrategy/documentation

Example response containing minimal, recommended, and maximal budget details for a campaign.

```json
{
  "budget": {
    "maximal": {
      "bonus": 1000,
      "callsFrom": 6,
      "callsTo": 10,
      "real": 100000,
      "total": 101000,
      "viewsFrom": 50,
      "viewsTo": 80
},
    "minimal": {
      "bonus": 10,
      "callsFrom": 1,
      "callsTo": 3,
      "real": 1000,
      "total": 1010,
      "viewsFrom": 10,
      "viewsTo": 20
},
    "priceRanges": [
      {
        "callsFrom": 4,
        "callsTo": 7,
        "percent": 95,
        "priceFrom": 10000,
        "priceTo": 20000,
        "viewsFrom": 50,
        "viewsTo": 80
}
],
    "recommended": {
      "bonus": 100,
      "callsFrom": 4,
      "callsTo": 7,
      "real": 10000,
      "total": 10100,
      "viewsFrom": 30,
      "viewsTo": 50
}
},
  "calcId": 123

}
```

--------------------------------

### Get BBIP Promotion Budget Suggestion Response (Success)

Source: https://developers.avito.ru/api-catalog/promotion/documentation

A successful response includes item details with available promotion budgets, recommended durations, and pricing. Note that 'isRecommended' flag indicates the preferred budget option.

```json
{
  "items": [
    {
      "budgets": [
        {
          "isRecommended": true,
          "oldPrice": 10000,
          "price": 10000
        }
      ],
      "duration": {
        "from": 1,
        "recommended": 5,
        "to": 7
      },
      "itemId": 2
    }
  ]
}
```

--------------------------------

### Get Autoloaded Ads by ID (Deprecated)

Source: https://developers.avito.ru/api-catalog/autoload/documentation

Retrieves data for specific autoloaded ads using their IDs. This method is deprecated and will be disabled on 08.03.2027, with reduced data returned starting 08.09.2026.

```APIDOC
## GET /autoload/v2/reports/items

### Description
Retrieves data for specific autoloaded ads using their IDs. This method is deprecated.

### Method
GET

### Endpoint
https://api.avito.ru/autoload/v2/reports/items

### Parameters
#### Query Parameters
- **query** (string) - Required - Identifiers of ads from the file (Id parameter). Format: a string containing 1 to 100 identifiers, separated by ',' or '|'.

#### Header Parameters
- **Authorization** (string) - Required - Token for authorization. Example: Bearer ACCESS_TOKEN

### Responses
#### Success Response (200)
- **items** (array) - An array of ad objects.
  - **ad_id** (string) - The ID of the ad.
  - **avito_date_end** (string) - The expiration date of the ad on Avito.
  - **avito_id** (integer) - The Avito internal ID of the ad.
  - **avito_status** (string) - The current status of the ad on Avito (e.g., 'active').
  - **fee_info** (object) - Information about the fee applied to the ad.
    - **amount** (integer) - The fee amount.
    - **package_id** (integer) - The ID of the package associated with the fee.
    - **type** (string) - The type of fee (e.g., 'single').
  - **messages** (array) - A list of messages or errors related to the ad.
    - **code** (integer) - The error code.
    - **description** (string) - A description of the message or error.
    - **title** (string) - The title of the message or error.
    - **type** (string) - The type of message (e.g., 'error').
    - **updated_at** (string) - The timestamp when the message was last updated.
  - **processing_time** (string) - The time when the ad was processed.
  - **section** (object) - Information about the section the ad belongs to.
    - **slug** (string) - The slug of the section.
    - **title** (string) - The title of the section.
  - **url** (string) - The URL of the ad on Avito.

#### Response Example (200)
```json
{
  "items": [
    {
      "ad_id": "string",
      "avito_date_end": "2019-08-24T14:15:22Z",
      "avito_id": 0,
      "avito_status": "active",
      "fee_info": {
        "amount": 0,
        "package_id": 0,
        "type": "single"
      },
      "messages": [
        {
          "code": 0,
          "description": "string",
          "title": "string",
          "type": "error",
          "updated_at": "2019-08-24T14:15:22Z"
        }
      ],
      "processing_time": "2019-08-24T14:15:22Z",
      "section": {
        "slug": "string",
        "title": "string"
      },
      "url": "string"
    }
  ]
}
```

#### Error Response (default)
Information about the error.
```

--------------------------------

### Get Fees for Ads in a Specific Report (Deprecated)

Source: https://developers.avito.ru/api-catalog/autoload/documentation

This method retrieves fee information for each ad placement within a specific report. It is deprecated and will be disabled on 08.03.2027, with reduced data starting 08.09.2026.

```http
GET /autoload/v2/reports/{report_id}/items/fees
```

--------------------------------

### Access Token Response Sample

Source: https://developers.avito.ru/api-catalog/auth/documentation

Example of a successful response when obtaining an access token. Includes the token, expiration time, and scope.

```json
{
  "access_token": "kChqt9ewQNAcwgbHp4yFd5",
  "expires_in": 86400,
  "refresh_token": "QNAcwgbHQNAcwgbHkChqt9ewQNAcwgbHp4yFd5",
  "scope": "messenger:read,messenger:write",
  "token_type": "Bearer"
}
```

--------------------------------

### Response Sample (200 OK)

Source: https://developers.avito.ru/api-catalog/item/documentation

This is a sample JSON response for a successful request to retrieve item information. It includes pagination metadata and a list of item resources, each with details like address, category, ID, price, status, title, and URL.

```json
{
  "meta": {
    "page": 1,
    "per_page": 25
  },
  "resources": [
    {
      "address": "Москва, Лесная улица 7",
      "category": {
        "id": 111,
        "name": "Вакансии"
      },
      "id": 24122231,
      "price": 35000,
      "status": "active",
      "title": "Продавец-кассир",
      "url": "https://www.avito.ru/rostov-na-donu/vakansii/prodavets_magazina_2142"
    }
  ]
}
```

--------------------------------

### Get Available Dictionaries - Response Sample

Source: https://developers.avito.ru/api-catalog/job/documentation

This is a sample JSON response for the get/job/v2/vacancy/dict endpoint, illustrating the structure of available dictionaries.

```json
[
  {
    "description": "Профессия",
    "id": "profession"
  },
  {
    "description": "Техника",
    "id": "vehicle_type"
  }

]
```

--------------------------------

### Get Calls by Time Request Payload

Source: https://developers.avito.ru/api-catalog/calltracking/documentation

This request body is used to retrieve a list of calls filtered by time. It requires a start date-time (dateTimeFrom) and optionally an end date-time (dateTimeTo). The limit should not exceed 100, and offset is used for pagination.

```json
{
  "dateTimeFrom": "2021-01-02T00:00:00Z",
  "dateTimeTo": "2021-03-02T23:59:59Z",
  "limit": 100,
  "offset": 0
}
```

--------------------------------

### Get Vacancy Publication Status V2

Source: https://developers.avito.ru/api-catalog/job/documentation

Get the publication status of a vacancy using version 2 of the API.

```APIDOC
## POST /v2/vacancies/status

### Description
Get the publication status of a vacancy using version 2 of the API.

### Method
POST

### Endpoint
/v2/vacancies/status

### Request Body
- **vacancy_id** (string) - Required - The ID of the vacancy.
```

--------------------------------

### Successful Method Response Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a successful HTTP-200 response from API methods, including a 'data' object and a success status.

```json
{
  "data": {},
  "status": "success"
}
```

--------------------------------

### Monitoring Event Response Sample

Source: https://developers.avito.ru/api-catalog/autoteka/documentation

Example structure of a successful response containing monitoring event data.

```json
{
  "pagination": {
    "lastId": 1230414
},
  "result": [
    {
      "id": 1230414,
      "payload": {
        "brand": "ВАЗ (LADA)",
        "condition": "Не битый",
        "controlCode": "a2430986",
        "description": "string",
        "extraPayload": {
          "cityName": "Елец",
          "hasPledge": false,
          "isProSeller": false,
          "phoneNumber": 79309991023,
          "pledge": "Залог не найден",
          "priceAnalytics": {
            "averageDaysInSale": 29,
            "estimateSellPrice": 165000,
            "liquidityRating": "B-",
            "sellerPriceDiff": 65000
},
          "regionName": "Липецкая область",
          "seller": "Частное лицо",
          "teaser": {
            "crashesBadge": true,
            "realMileageBadge": false
}
},
        "itemCreatedAt": "2021-01-10 16:07",
        "itemId": 2075191323,
        "itemUpdatedAt": "2021-02-09 16:10",
        "mileage": 125000,
        "model": "Kalina",
        "owners": "string",
        "price": 230000,
        "regionId": 637260,
        "triggerPayload": {
          "lastEvents": [
            {
              "eventDate": "2018-10-08",
              "eventTitle": "Сервисное обслуживание"
}
]
},
        "url": "https://avito.ru/elets/avtomobili/lada_kalina_2010_2075191323?utm_source=autoteka_leads&utm_medium=referral&utm_campaign=43|api",
        "vin": "XTA111830A0219549",
        "year": 2010
},
      "subscriptionId": 8132
}
]

}
```

--------------------------------

### Successful Response Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a successful response from an API method, typically returning an HTTP 200 status with a 'data' object.

```json
{
  "data": {},
  "status": "SUCCESS"
}
```

--------------------------------

### Response Sample for User Operations History

Source: https://developers.avito.ru/api-catalog/user/documentation

Example response structure containing a list of user financial operations.

```json
{
  "operations": [
    {
      "amountBonus": 0,
      "amountRub": 119,
      "amountTotal": 119,
      "itemId": 1853257996,
      "operationName": "Резервирование средств. Услуга «Сделать XL объявлением» для объявления №1853257996",
      "operationType": "резервирование средств под услугу",
      "serviceId": 16,
      "serviceName": "Сделать XL объявлением",
      "serviceType": "vas",
      "updatedAt": "2020-04-27T10:51:50.012436+03:00"
    }
  ]
}
```

--------------------------------

### Ad Group Response Example

Source: https://developers.avito.ru/api-catalog/ads/documentation

Example JSON response when listing ad groups, detailing budget, price, and frequency rules.

```json
{
  "total": 1,
  "groups": [
    {
      "id": 987654321,
      "campaignID": 1234567890,
      "name": "Группа 1",
      "status": "active",
      "budget": 2500,
      "budgetKopeks": 250000,
      "price": 25,
      "priceKopeks": 2500,
      "frequencyCount": 3,
      "frequencyPeriod": "day",
      "frequencyRules": [
        { "count": 3, "period": "day" },
        { "count": 10, "period": "week" }
      ],
      "pace": "asap",
      "bannerFormat": "media"
    }
  ]
}
```

--------------------------------

### Cancel Announcement Request Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a request to cancel an announcement. This method informs the recipient that they should not expect delivery for a previously sent announcement.

```json
{
  "announcementID": "string"
}
```

--------------------------------

### Response Sample for Campaigns

Source: https://developers.avito.ru/api-catalog/ads/documentation

This is a sample successful response (200 OK) containing a list of campaigns and the total count. Each campaign object includes details like ID, type, status, and associated IDs.

```json
{
  "campaigns": [
    {
      "accountId": 0,
      "additionalAgreementID": 0,
      "advertiserId": 0,
      "budget": 0,
      "campaignType": "textImage",
      "contractId": 0,
      "createdAt": "string",
      "endDate": "string",
      "id": 0,
      "managerID": 0,
      "name": "string",
      "paymentModel": "CPM",
      "performanceAdditionalAgreementID": 0,
      "startDate": "string",
      "status": "draft",
      "updatedAt": "string",
      "userId": 0
}
],
  "total": 0
}
```

--------------------------------

### Get Resumes API Response Sample (200 OK)

Source: https://developers.avito.ru/api-catalog/job/documentation

This is a sample successful response (200 OK) for the get/job/v1/resumes/ endpoint, showing the structure of resume data returned.

```json
{
  "meta": {
    "cursor": 1538480436,
    "page": 1,
    "pages": 6,
    "per_page": 25
},
  "resumes": [
    {
      "address_details": {
        "address": "Москва, Лесная улица, 7",
        "coordinates": {
          "latitude": 55.755814,
          "longitude": 37.617635
},
        "district": "Тверской",
        "location": "Москва",
        "metro": "Белорусская"
},
      "age": 19,
      "created": "2019-08-24T14:15:22Z",
      "driver_licence": true,
      "driver_licence_category": [
        "a"
],
      "driving_experience": "less-than-three-years",
      "education_level": "unfinished-higher",
      "gender": "female",
      "id": 2385934235,
      "is_purchased": false,
      "location": {
        "id": 637640,
        "title": "Москва"
},
      "medical_book": true,
      "nationality": {
        "id": 15973,
        "title": "Россия"
},
      "own_transport": false,
      "salary": 20000,
      "specialization": {
        "id": 10186,
        "title": "Консультирование"
},
      "title": "Оператор Call-центра",
      "total_experience": 0,
      "updated": "2019-08-24T14:15:22Z"
}
]

}
```

--------------------------------

### Get Category Tree

Source: https://developers.avito.ru/api-catalog/autoload/documentation

Retrieves the Avito category tree in an array format. This method allows you to get a hierarchical structure of categories available on Avito.

```APIDOC
## Get Category Tree

### Description
Retrieves the Avito category tree in an array format. This method allows you to get a hierarchical structure of categories available on Avito.

### Method
GET

### Endpoint
/autoload/v1/user-docs/tree

### Parameters
#### Header Parameters
- **If-Modified-Since** (string, Nullable) - Example: Mon, 01 Jan 0001 00:00:00 UTC - Date and time of the last received version in RFC1123 format in UTC.

### Responses
#### Success Response (200)
Successful retrieval of the category tree.

#### Error Response (304)
An empty response will be returned if the date in the If-Modified-Since header is earlier than the last documentation build date.

#### Error Response (403)
User authorization error.

### Response Sample (200)
```json
{
  "categories": [
    {
      "name": "string",
      "nested": [
        {
          "property1": [
            {}
          ],
          "property2": [
            {}
          ]
        }
      ],
      "slug": "string"
    }
  ]
}
```
```

--------------------------------

### Request Sample for Agency Clients

Source: https://developers.avito.ru/api-catalog/avito-promo/documentation

This JSON payload demonstrates how to request a list of agency clients, including options to include extra information like balance, subscription, advance, and statistics. It also shows how to set pagination parameters like limit and offset.

```json
{
  "extra": {
    "advance": true,
    "balance": true,
    "statistics": true,
    "subscription": true
  },
  "limit": 100,
  "offset": 10
}
```

--------------------------------

### Current Upload Response Sample

Source: https://developers.avito.ru/api-catalog/autoload/documentation

Example of a successful response with warnings for the current upload status. It includes event details, feed URLs, processing statistics, and the upload status.

```json
{
  "events": [
    {
      "code": 600,
      "description": "В ваших файлах суммарно слишком много объявлений — автозагрузка обработает только 100000 из них.",
      "type": "warning"
}
],
  "feed_urls": [
    {
      "name": "файл 1",
      "url": "https://www.avito.ru/"
}
],
  "source": "OpenAPI",
  "started_at": "2026-05-20T10:15:30+03:00",
  "stats": {
    "count": 3,
    "sections": [
      {
        "count": 1,
        "sections": [
          {
            "count": 1,
            "slug": "error_params",
            "title": "Ошибки описания"
}
],
        "slug": "error",
        "title": "Не удалось опубликовать"
},
      {
        "count": 2,
        "sections": [ ],
        "slug": "successful",
        "title": "Успешно опубликовано"
}
],
    "slug": "sections_stats",
    "title": "Обработано объявлений"
},
  "status": "success_warning",
  "upload_id": 1234567890
}
```

--------------------------------

### Get Child Accounts Response Sample

Source: https://developers.avito.ru/api-catalog/ads/documentation

This is a sample JSON response for a successful request to get child accounts. It includes account and contract details for each child.

```json
{
  "children": [
    {
      "account": {
        "id": 0,
        "shortName": "string"
      },
      "contract": {
        "accountID": 0,
        "cid": "string",
        "client": {
          "accountId": 0,
          "actualAddress": "string",
          "id": 0,
          "inn": "string",
          "kpp": "string",
          "legalAddress": "string",
          "legalRole": "rd",
          "legalType": "ul",
          "longName": "string",
          "ogrn": "string",
          "shortName": "string"
        },
        "contractor": {
          "accountId": 0,
          "actualAddress": "string",
          "id": 0,
          "inn": "string",
          "kpp": "string",
          "legalAddress": "string",
          "legalRole": "rd",
          "legalType": "ul",
          "longName": "string",
          "ogrn": "string",
          "shortName": "string"
        },
        "date": "string",
        "description": "string",
        "id": 0,
        "isAgentActingForPublisher": true,
        "isCreativeReporter": true,
        "number": "string",
        "object": "string",
        "parentId": 0,
        "subject": "string",
        "type": "service"
      }
    }
  ]
}
```

--------------------------------

### Get User Bids - Response Sample

Source: https://developers.avito.ru/api-catalog/auction/documentation

This is a sample JSON response for the `getUserBids` method, illustrating the structure of returned bid information, including available prices and expiration times.

```json
{
  "items": [
    {
      "availablePrices": [
        {
          "goodness": 0,
          "pricePenny": 120000
}
],
      "expirationTime": "2023-06-29T12:34:34+03:00",
      "itemID": 123456789,
      "pricePenny": 147000
}
]

}
```

--------------------------------

### Package as Shipping Unit Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of how a package is represented when it is also a shipping unit. The package's barcode is duplicated in the shipping unit ID, and sealID is absent.

```json
{
  "id": "string",
  "senderBarcode": "string",
  "parcels": [
    {
      "id": "string",
      "barcode": "string"
    }
  ]
}
```

--------------------------------

### Create Announcement Request (Return Flow)

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of a request to create an announcement in Avito for the return flow. Note the differences in receiver and delivery type compared to the direct flow.

```json
{
  "announcementId": "string",
  "sender": {
    "contact": {
      "name": "string",
      "phone": "string"
    },
    "address": {
      "region": "string",
      "city": "string",
      "street": "string",
      "house": "string",
      "apartment": "string",
      "comment": "string"
    }
  },
  "receiver": {
    "contact": {
      "name": "string",
      "phone": "string"
    },
    "address": {
      "region": "string",
      "city": "string",
      "street": "string",
      "house": "string",
      "apartment": "string",
      "comment": "string"
    },
    "delivery": {
      "sortingCenter": {
        "provider": "string"
      }
    }
  },
  "parcels": [
    {
      "parcelId": "string",
      "weight": 0,
      "dimensions": {
        "length": 0,
        "width": 0,
        "height": 0
      },
      "comment": "string"
    }
  ],
  "courierInfo": {
    "courierName": "string",
    "courierPhone": "string",
    "transportType": "string"
  },
  "deliveryType": "PICKUP",
  "comment": "string"
}
```

--------------------------------

### Get Resume Data

Source: https://developers.avito.ru/api-catalog/job/documentation

Retrieves detailed information about a specific resume using its unique identifier. You can customize the returned fields and parameters to get the exact data you need.

```APIDOC
## GET /job/v2/resumes/{resume_id}

### Description
Retrieves detailed information about a specific resume using its unique identifier. You can customize the returned fields and parameters to get the exact data you need.

### Method
GET

### Endpoint
https://api.avito.ru/job/v2/resumes/{resume_id}

### Parameters
#### Path Parameters
- **resume_id** (integer) - Required - Идентификатор резюме

#### Query Parameters
- **fields** (string) - Optional - Enum: "address_details" "description" "is_active" "is_purchased" "salary" "start_time" "title" "update_time" "url". Specifies which main response fields to include. Defaults to all fields.
- **params** (string) - Optional - Enum: "ability_to_business_trip" "address" "age" "business_area" "driver_licence" "driver_licence_category" "education" "education_list" "experience" "experience_list" "language_list" "moving" "nationality" "pol" "razreshenie_na_rabotu_v_rossii" "schedule". Specifies additional parameters to include in the response. Defaults to all parameters.
- **photos** (boolean) - Optional - Default: false. Indicates whether to return images. Defaults to false.

#### Header Parameters
- **Authorization** (string) - Required - Example: Bearer ACCESS_TOKEN. Token for authorization.
- **X-Is-Employee** (boolean) - Optional, Nullable, Deprecated. Use X-Employee-Of instead. Enables company privileges for an employee, granting access to resumes on behalf of the company.
- **X-Employee-Of** (integer) - Optional, Nullable - >= 1. The identifier of the company on whose behalf the employee is acting. Enables company privileges for an employee, granting access to resumes on behalf of the company.

### Responses
#### Success Response (200)
- **address_details** (object) - Details about the resume's address.
- **description** (string) - The detailed description of the resume.
- **id** (integer) - The unique identifier of the resume.
- **is_active** (boolean) - Indicates if the resume is currently active.
- **is_purchased** (boolean) - Indicates if the resume has been purchased.
- **params** (object) - Additional parameters and details about the resume.
- **photos** (array) - An array of photo objects associated with the resume.
- **salary** (integer) - The salary information for the resume.
- **start_time** (string) - The start time of the resume's validity.
- **title** (string) - The title of the resume.
- **update_time** (string) - The last update time of the resume.
- **url** (string) - The URL to the resume.

#### Error Responses
- **400** - Bad Request
- **401** - Unauthorized
- **404** - Resume Not Found
- **429** - Too Many Requests
- **500** - Internal Server Error
- **503** - Service Unavailable

### Request Example
```json
{
  "example": "request body"
}
```

### Response Example
```json
{
  "address_details": {
    "address": "Москва, Лесная улица, 7",
    "coordinates": {
      "latitude": 55.755814,
      "longitude": 37.617635
    },
    "district": "Тверской",
    "location": "Москва",
    "metro": "Белорусская"
  },
  "description": "Повар- универсал с 15 летним опытом работы:\nповар - пекарь, шеф-поваром на судах;\nповар -универсал в экспедициях и на приисках;\nповар горячего и холодного цехов в ресторанах и кафе Москвы;\nщеф-повар в ресторанах и ночных клубах Одессы.\nЗнание русской, поморской, украинской, кавказской, итальянской кухонь. Технология, администрирование. \nуправление персоналом.",
  "id": 2143065041,
  "is_active": true,
  "is_purchased": true,
  "params": {
    "ability_to_business_trip": "Не готов",
    "address": "Москва, Лесная улица 7",
    "age": 32,
    "business_area": "IT, интернет, телеком",
    "driver_licence": true,
    "driver_licence_category": [
      "a"
    ],
    "education": "Высшее",
    "education_list": [
      {
        "education_stop": 1995,
        "institution": "МГИМО МИД РФ",
        "specialty": "Финансы и кредит, экономист-международник"
      }
    ],
    "experience_list": [
      {
        "company": "МТС",
        "position": "Эксперт клиентского сервиса",
        "responsibilities": "Принятие входящих обращений от клиентов; помощь в решении возникающих вопросов; консультирование по продуктам компании; продажи",
        "work_finish": "2018-09-01",
        "work_start": "2015-07-01"
      }
    ],
    "language_list": [
      {
        "language": "Коми",
        "language_level": "Начальный"
      }
    ],
    "moving": "Невозможен",
    "nationality": "Филиппины",
    "pol": "Мужской",
    "razreshenie_na_rabotu_v_rossii": "Да",
    "schedule": "flyInFlyOut"
  },
  "photos": [
    {
      "url": "string"
    }
  ],
  "salary": 60000,
  "start_time": "2020-08-21T08:44:12Z",
  "title": "Повар-универсал",
  "update_time": "2020-08-21T09:53:06Z",
  "url": "/moskva/rezume/povar-universal_358696_2143065041"
}
```
```

--------------------------------

### Infrastructure Error Response Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of an API response indicating an infrastructure error, returning an HTTP 500 status with an 'error' object. Implement retry logic for these errors.

```json
{
  "error": "Internal Server Error"
}
```

--------------------------------

### Advertiser Response Sample

Source: https://developers.avito.ru/api-catalog/ads/documentation

Example response structure for retrieving advertisers, including account details, advertiser information, and total count.

```json
{
  "advertisers": [
    {
      "accountId": 0,
      "actualAddress": "string",
      "id": 0,
      "inn": "string",
      "kpp": "string",
      "legalAddress": "string",
      "legalRole": "rd",
      "legalType": "ul",
      "longName": "string",
      "ogrn": "string",
      "shortName": "string"
    }
  ],
  "total": 0
}
```

--------------------------------

### Successful Booking Response Sample

Source: https://developers.avito.ru/api-catalog/str/documentation

Example of a successful JSON response when retrieving booking information. It includes details about each booking such as ID, price, dates, guest information, and status.

```json
{
  "bookings": [
    {
      "avito_booking_id": 11111,
      "base_price": 8000,
      "check_in": "2026-08-01",
      "check_out": "2026-08-04",
      "contact": {
        "email": "guest_email@domain.com",
        "name": "Иван",
        "phone": "9997770000"
},
      "guest_count": 1,
      "nights": 3,
      "safe_deposit": {
        "owner_amount": 4500,
        "tax": 500,
        "total_amount": 5000
},
      "status": "active"
}
]

}
```

--------------------------------

### Business Logic Error Response Example

Source: https://developers.avito.ru/api-catalog/delivery-sandbox/documentation

Example of an API response indicating a business logic error, returning an HTTP 200 status with an 'error' object detailing the issue.

```json
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
```

--------------------------------

### Получение access token

Source: https://developers.avito.ru/api-catalog/autoteka/documentation

Example request for obtaining an access token using OAuth 2.0 client_credentials flow.

```bash
curl -L -X POST 'https://pro.autoteka.ru/token/' -H 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'grant_type=client_credentials' --data-urlencode 'client_id=XXX' --data-urlencode 'client_secret=YYY'
```