WbProducts icon

WbProducts

n8n node to interact with WB API

Actions41

Overview

This node interacts with the Wildberries API to retrieve directory information related to categories, subjects, and characteristics. Specifically, the "Get Directory" operation fetches structured data about product categories and their attributes in a specified language locale. This is useful for workflows that need to dynamically access or synchronize product taxonomy data from Wildberries, such as e-commerce integrations, inventory management, or analytics pipelines.

Example use cases:

  • Automatically fetching updated category lists to populate dropdowns in product import forms.
  • Synchronizing product attribute definitions for consistent data entry across systems.
  • Localizing category and attribute names based on user language preferences.

Properties

Name Meaning
Locale Language of the response fields subjectName and name. Possible values: ru (Russian), en (English), zh (Chinese). Not used in sandbox mode.

Output

The node outputs JSON data representing the directory structure of categories, subjects, and characteristics retrieved from the Wildberries API. The exact structure depends on the API response but generally includes localized names and identifiers for each category and its associated attributes.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating requests to the Wildberries API.
  • The node uses a base URL and OpenAPI specification bundled internally to construct requests.
  • Proper configuration of the API authentication credential within n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Using unsupported locale values may result in empty or error responses.
    • Network connectivity problems can prevent the node from reaching the Wildberries API.

  • Error messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors on the locale parameter suggest using one of the supported values (ru, en, zh).
    • Timeout or connection errors require checking network settings and API availability.

Links and References

Discussion