Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to facilitate business operations related to Avito listings. Specifically, for the resource Автозагрузка (Autoload) and operation 🔄 Конвертация: Avito ID → Файл ID (Conversion: Avito ID to File ID), it converts one or multiple Avito listing IDs into corresponding internal file IDs used in an autoload system.

This is useful when you have a list of Avito advertisement IDs and want to find their matching IDs in your local or external file-based system. It helps synchronize data between Avito and your own database or files, enabling reverse lookup and reporting.

Practical examples:

  • You receive a batch of Avito ad IDs from a marketing campaign and want to find their corresponding records in your internal system.
  • You need to generate reports that link Avito ads to your file storage or processing system by matching IDs.
  • Synchronizing updates or statuses between Avito listings and your local dataset using these ID mappings.

Properties

Name Meaning
ID Объявлений На Авито Comma-separated or pipe-separated string of Avito advertisement IDs to convert. Example: 1234567890,9876543210 or `1234567890
🔗 Получение ID из файла по Avito ID

📋 Назначение:
• Связь между ID на Авито и ID в файле
• Полезно для синхронизации данных
• Обратное сопоставление объявлений

🔍 Входные данные:
• ID объявлений на сайте Авито
• Например: 1234567890, 9876543210
• Разделители: запятая (,) или символ (		 )

📊 Результат:
• Пары: Avito ID → ID из файла
• Null если объявление не найдено в автозагрузке
• Полезно для отчетности и аналитики

Output

The node outputs JSON objects where each input Avito ID is paired with its corresponding file ID from the autoload system. If no match is found for a given Avito ID, the output value for that ID is null.

Example output structure (conceptual):

{
  "1234567890": "file_id_abc123",
  "9876543210": null,
  ...
}

This allows downstream nodes or workflows to easily process matched pairs or handle unmatched entries accordingly.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential for accessing the Avito API.
  • The node depends on internal routing utilities (RouterUtils) and description modules bundled within the node package.
  • No additional external services beyond Avito API are required.
  • Proper configuration of the API credential in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing Avito IDs format (e.g., wrong separators or empty strings) may cause errors or empty results.
    • Authentication failures due to incorrect or expired API credentials.
    • Network connectivity problems preventing access to the Avito API.
    • Unrecognized resource or operation parameters if misconfigured.

  • Error messages:

    • "Unknown resource: ..." indicates the resource parameter is invalid or unsupported.
    • API errors returned from Avito will be surfaced as error messages; check credentials and network.
    • Parsing errors if the input string of IDs is malformed.

  • Resolutions:

    • Ensure the Avito IDs input uses commas or pipes as separators without extra spaces.
    • Verify and refresh API credentials.
    • Confirm the resource is set to "autoload" and operation to "getAdIdsByAvitoIds".
    • Enable "Continue On Fail" option to handle partial failures gracefully.

Links and References

If you want me to analyze other resources or operations, please provide their names or source code snippets.

Discussion