Avito icon

Avito

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

Actions79

Автозагрузка → 📃 Загрузки V4: Объявления Загрузки

AI-generated

Summary

Retrieve detailed listings data from Avito's Autoload API v4 for either the last successful upload or the currently processing upload.

Inputs

  • uploadTarget (required) — Select which upload to request data from: 'lastSuccessful' returns the last fully processed stable upload, and 'current' returns the latest upload that has processed at least one listing but might still be updating.
  • uploadItemsPage — Page number to retrieve, starting at 1; relevant when paginating upload items.
  • uploadItemsPerPage — Number of listings per page, up to a maximum of 100.
  • uploadItemsFilters — Optional filters to refine the listings returned, including a search query string and comma-separated slugs of listing sections like 'errors' or 'warnings'.
  • uploadItemsEnablePagination — If enabled, automatically fetches and merges all pages of results.
  • uploadItemsPaginationType — Pagination mode used if pagination is enabled; choose between fetching all pages or limiting the maximum number of pages processed.
  • uploadItemsMaxPages — Maximum number of pages to fetch when the pagination mode is limited ('limit').
  • uploadItemsRequestDelay — Milliseconds to wait between consecutive page requests to avoid triggering Avito API rate limits.

Output shape

A JSON object representing the listings data from the specified upload, including the selected page(s) of listings with applied filters if provided.

The shape includes pagination when enabled. If pagination is disabled, only a single page is returned. Data corresponds to the selected upload type ('lastSuccessful' or 'current'). Results may include partial or changing data when choosing the current upload option.

Examples

Example 1: Fetch the last fully processed upload listings page 1 with 50 listings per page, filtered by errors section.

uploadTarget='lastSuccessful', uploadItemsPage=1, uploadItemsPerPage=50, uploadItemsFilters:{sections:'errors'}, uploadItemsEnablePagination=false

Example 2: Fetch all pages of the current upload listings, with a request delay of 1000ms to limit rate.

uploadTarget='current', uploadItemsEnablePagination=true, uploadItemsPaginationType='all', uploadItemsRequestDelay=1000

Links

Discussion