Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to retrieve detailed reports related to "Автозагрузка" (Autoload). Specifically, the operation "📋 Отчеты: Детали По ID" fetches detailed information about a single autoload report by its unique report ID. This is useful for users who want to programmatically access the status, timing, and statistics of specific data export jobs from Avito.

Common scenarios include:

  • Monitoring the progress or result of an autoload report.
  • Fetching detailed statistics about listings included in a particular export.
  • Automating workflows that depend on the completion or failure of data exports.

Example use case:

  • A user triggers this node with a known report ID to check if the export has finished and then processes the exported data accordingly.

Properties

Name Meaning
ID Отчета Unique numeric ID of the autoload report to retrieve details for. Must be at least 1.
📊 Информация об отчетах автозагрузки (notice) Informational notice describing pagination limits, report structure, statuses, and additional fields related to autoload reports.

The notice property provides helpful context but does not affect execution.

Output

The node outputs JSON data representing the detailed report corresponding to the provided report ID. The structure includes fields such as:

  • report_id: Unique identifier of the report.
  • started_at: Timestamp when the export started.
  • finished_at: Timestamp when the export finished.
  • status: Current status of the export (processing, finished, or failed).
  • section_stats: Statistics about different sections within the report.
  • listing_fees: Information about any fees charged.
  • feeds_urls: URLs linking to the exported files.

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 OAuth2 API credentials configured in n8n.
  • No other external dependencies are explicitly required.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent report ID will likely cause an error or empty response.
    • Network or authentication failures can prevent successful API calls.
    • Exceeding pagination limits when listing multiple reports (not directly relevant here but noted in the informational notice).

  • Error messages:

    • "Unknown resource": Occurs if the resource parameter is set incorrectly; ensure it is "autoload".
    • API errors related to authentication or rate limiting should be resolved by verifying credentials and API usage limits.
    • If the node throws an error with a message about missing or invalid report ID, verify that the ID is a positive integer.

Links and References

Discussion