Avito icon

Avito

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

Overview

This node integrates with the Avito API to retrieve lists of classified ads ("Объявления"). It is designed to fetch ads filtered by various criteria such as status, update date, category, and supports pagination for handling large result sets. This node is useful for automating workflows that require up-to-date listings from Avito, such as market analysis, monitoring competitor ads, or aggregating classified ads data.

For example, you can use this node to:

  • Retrieve all active ads in a specific category updated after a certain date.
  • Collect blocked or removed ads for audit purposes.
  • Automatically paginate through multiple pages of ads to gather comprehensive datasets.

Properties

Name Meaning
Статус (status) Filter ads by their status. Options: Активные (active), Заблокированные (blocked), Отклоненные (rejected), Удаленные (removed), Устаревшие (old)
Обновлено После (updatedAtFrom) Filter ads updated after a specified date (format YYYY-MM-DD).
ID Категории (category) Filter ads by category ID. Use 0 to include all categories.
Количество Объявлений На Странице (perPage) Number of ads per page (1 to 100). Default is 100.
Начать Со Страницы (page) Page number to start fetching data from (starting at 1).
Включить Пагинацию (enablePagination) Enable automatic pagination to retrieve multiple pages of ads.
Тип Пагинации (paginationType) Pagination method when enabled: "Получить Все Страницы с Объявлениями" (all) or "Лимит Страниц с Объявлениями" (limit).
Максимум Страниц (maxPages) Maximum number of pages to retrieve when using limited pagination (minimum 1).
Включить Задержку Запросов (enableDelay) Add delay between requests to avoid hitting rate limits.
Задержка (мс) (requestDelay) Delay in milliseconds between requests when delay is enabled. Recommended 10-100ms.

Output

The node outputs an array of JSON objects, each representing an ad retrieved from Avito according to the specified filters and pagination settings. Each item in the output corresponds to one ad's data structure as returned by the Avito API.

If pagination is enabled, the output will contain ads aggregated from multiple pages, depending on the pagination settings.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Avito API.
  • The node depends on the Avito API being accessible and responsive.
  • Proper configuration of API credentials in n8n is necessary.
  • Optional delays between requests can be configured to comply with Avito's rate limiting policies.

Troubleshooting

  • Empty results: May occur if the page number exceeds available pages or filters are too restrictive. Verify filter values and page numbers.
  • Rate limiting errors: If the API returns errors related to request frequency, enable request delay and increase the delay duration.
  • Invalid category ID: Using a non-existent category ID may return no results. Refer to the official category catalog linked in the property hint.
  • Unknown resource error: This node only supports the "item" resource for this operation; ensure correct resource selection.
  • API authentication errors: Ensure the API key credential is correctly set up and has required permissions.

Links and References

  • Avito OpenAPI Catalog Categories — Reference for valid category IDs.
  • Avito API documentation (official site) for detailed information on ad statuses and filtering options.

Discussion