Avito icon

Avito

Взаимодействие с API Авито для бизнеса

Actions79

Продвижение → Список Заявок

AI-generated

Summary

Retrieve a paginated list of promotion service orders (Заявки) from the Avito Promotion API v1, optionally on behalf of a specified company employee.

Inputs

  • ID Компании (X-Employee-Of) — Numeric identifier of the company on whose behalf the employee works; set to 0 to use the personal account context.
  • Page (required) — Page number of the orders list to retrieve (minimum 1).
  • Per Page (required) — Number of orders to retrieve per page (minimum 1, maximum 100).

Output shape

A list of promotion orders corresponding to the specified page and page size.

Results are paginated according to 'Page' and 'Per Page' inputs; pagination maximum per page is 100. The operation uses the Promotion API v1 endpoints, which support scoped access via tokens. Response includes promotion order details as provided by the API.

Examples

Example 1: Fetch first page of promotion orders for personal account.

ID Компании (X-Employee-Of) = 0, Page = 1, Per Page = 20

Example 2: Fetch second page of promotion orders for company with ID 123456.

ID Компании (X-Employee-Of) = 123456, Page = 2, Per Page = 50

Links

Discussion