Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to retrieve data related to "Автозагрузка" (Autoload) reports, specifically focusing on fetching the latest completed report. It is useful for users who want to automate the monitoring and analysis of their data export processes from Avito, such as tracking report generation status, reviewing detailed statistics per section, and accessing download links for exported files.

Practical examples include:

  • Automatically checking when the last autoload report finished processing.
  • Retrieving detailed statistics about listings and fees from the most recent export.
  • Using pagination to navigate through up to 200 reports per request to analyze historical export data.

Properties

Name Meaning
📊 Информация об отчетах автозагрузки

📄 Пагинация отчетов:
• Максимум 200 отчетов за запрос
• Используйте page для перехода по страницам
• total показывает общее количество отчетов

📈 Структура отчета:
• report_id - уникальный ID отчета
• started_at - дата начала выгрузки
• finished_at - дата окончания выгрузки
• status - статус выгрузки
• section_stats - статистика по разделам
• listing_fees - информация о списаниях

📋 Статусы выгрузки:
• processing - выгрузка в процессе
• finished - выгрузка завершена
• failed - выгрузка не удалась

🔗 Дополнительно:
• feeds_urls - ссылки на файлы выгрузки
• section_stats - количество объявлений в каждом разделе		 This notice property provides detailed information about how autoload reports are structured and paginated:
- Pagination supports up to 200 reports per request; use a page parameter to navigate.
- Each report includes unique identifiers, timestamps for start and finish, status, section statistics, and listing fee details.
- Possible statuses: processing, finished, failed.
- Additional fields include URLs to download exported files and counts of listings per section.
This property serves as an informative guide rather than an input field.

Output

The node outputs JSON objects representing autoload reports with the following structure:

  • report_id: Unique identifier of the report.
  • started_at: Timestamp indicating when the export started.
  • finished_at: Timestamp indicating when the export finished.
  • status: Current status of the export process (processing, finished, or failed).
  • section_stats: Statistics detailing the number of listings in each section.
  • listing_fees: Information about any fees charged during the export.
  • feeds_urls: URLs linking to the exported files for download.

If multiple reports are retrieved (e.g., via pagination), the output will be an array of such report objects.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential to connect securely to the Avito API.
  • The node depends on internal routing utilities to handle different operations based on the selected resource and operation.
  • No additional external dependencies beyond the Avito API and n8n's standard environment.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Requesting pages beyond available report data may return empty results.
    • Network connectivity issues can prevent successful API calls.

  • Error Messages:

    • "Unknown resource: <resource>": Indicates that the specified resource is not supported by the node. Ensure the resource name is correct.
    • Errors containing "error" in the JSON output indicate API or execution errors; check the error message for details.

  • Resolutions:

    • Verify API credentials and permissions.
    • Use valid pagination parameters within the allowed range.
    • Enable "Continue On Fail" in the node settings to handle individual item errors gracefully.

Links and References

Discussion