Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to retrieve structured data related to categories and their fields. Specifically, for the resource "Автозагрузка" (Autoload), it supports operations such as fetching the full category tree and obtaining detailed fields for a specific category.

Common scenarios where this node is beneficial include:

  • Building dynamic forms or filters based on current Avito categories.
  • Synchronizing category structures from Avito into your own system.
  • Fetching metadata about category fields, including dependencies and possible values, to validate or enrich listings before submission.

Practical example:

  1. Use the "Дерево Категорий" (Category Tree) operation to get the complete list of categories and find the relevant category slug.
  2. Use the slug in the "Поля Категории" (Category Fields) operation to fetch all fields associated with that category, including field dependencies and value catalogs.

This approach ensures you always work with up-to-date category information and avoid using outdated slugs.

Properties

Name Meaning
Дополнительные Заголовки Additional HTTP headers to include in the request. For example, you can specify the If-Modified-Since header with a date/time in RFC1123 UTC format to request only updated data since that timestamp. This helps optimize requests by avoiding unnecessary data retrieval.
📂 Получение категорий и полей

🌲 Дерево категорий:
• Получите полный список всех доступных категорий
• Найдите нужный slug в структуре категорий
• Используйте slug для получения полей конкретной категории

📋 Поля категории:
• Получение всех полей для конкретной категории
• Информация о зависимостях полей
• Возможные значения и их типы
• Ссылки на каталоги значений

⚠️ Важно:
• Сначала используйте "Дерево Категорий" для получения актуальных slug
• Slug категорий могут изменяться со временем
• Не используйте примеры slug без проверки их актуальности

🔍 Как найти slug:
1. Выполните операцию "Дерево Категорий"
2. Найдите нужную категорию в ответе
3. Скопируйте значение поля "slug"
4. Используйте его в операции "Поля Категории"		 Informational notice explaining how to use the category tree and category fields operations effectively. It emphasizes the importance of first retrieving the category tree to get valid slugs, warns that slugs may change over time, and provides step-by-step instructions on finding and using slugs correctly. This property does not accept input but serves as guidance for users.

Output

The node outputs JSON data representing the response from the Avito API for the selected operation:

  • For the "Дерево Категорий" (Category Tree) operation, the output JSON contains a hierarchical structure listing all available categories, each with properties such as name, slug, and possibly nested subcategories.
  • For the "Поля Категории" (Category Fields) operation, the output JSON includes detailed information about all fields associated with a specific category. This includes field dependencies, possible values, types, and links to value catalogs.

No binary data output is indicated for these operations.

Dependencies

  • Requires an API key credential for authenticating with the Avito API.
  • The node depends on the Avito OAuth2 authentication mechanism configured within n8n.
  • No additional external services are explicitly required beyond the Avito API.
  • Proper network access to Avito's API endpoints is necessary.

Troubleshooting

  • Common Issues:

    • Using outdated or incorrect category slugs will result in errors or empty responses. Always fetch the latest category tree before querying category fields.
    • Incorrectly formatted additional headers (e.g., malformed If-Modified-Since dates) may cause the API to reject the request.
    • Network connectivity issues or invalid API credentials will prevent successful API calls.

  • Error Messages:

    • "Unknown resource": Indicates the specified resource parameter is invalid or unsupported. Ensure the resource is set to "autoload" for these operations.
    • API errors returned from Avito will be passed through; check the error message for details such as authentication failure or rate limiting.

  • Resolution Tips:

    • Verify API credentials and permissions.
    • Confirm the correctness and currency of category slugs.
    • Use the provided informational notice to guide proper usage.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion