WbAnalytics icon

WbAnalytics

n8n node to interact with WB API

Actions19

Overview

This node interacts with a Wildberries (WB) analytics API to post search report data specifically about product orders. It allows users to request detailed order reports based on search queries within a specified period for a particular product identified by its article number (nmId). This is useful for sellers or analysts who want to understand how certain search terms influence product orders over time.

Typical use cases include:

  • Analyzing the effectiveness of specific search keywords in driving product sales.
  • Monitoring product order trends related to user search behavior.
  • Generating reports for marketing or inventory planning based on search-driven demand.

Properties

Name Meaning
Period The date range for the report, defined as a JSON object with start and end dates. Maximum span is 7 days. Example: { "start": "2024-02-10", "end": "2024-02-10" }.
Nm Id The Wildberries product article number (numeric identifier) for which the report is generated. Example: 211131895.
Search Texts A JSON array of search query strings to analyze. Example: [ "костюм", "пиджак" ]. These represent the search terms to be included in the report.

Output

The node outputs JSON data containing the search report results for product orders. The exact structure depends on the API response but typically includes metrics related to orders generated from the specified search texts during the given period for the product.

No binary data output is indicated.

Dependencies

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

Troubleshooting

  • Invalid Date Range: If the period exceeds 7 days, the API may reject the request. Ensure the Period property respects the maximum allowed duration.
  • Incorrect Product ID: Providing an invalid or non-existent Nm Id will result in empty or error responses. Verify the product article number.
  • Malformed JSON Inputs: The Period and Search Texts properties expect valid JSON strings. Errors in JSON formatting will cause failures.
  • Authentication Errors: Missing or incorrect API credentials will prevent successful API calls. Confirm that the API key is correctly set up.
  • Empty Results: If no orders match the search queries in the given period, the output may be empty. Try adjusting search terms or date range.

Links and References

  • Wildberries API documentation (if publicly available)
  • n8n documentation on creating custom nodes and using API credentials
  • JSON formatting guides for constructing input parameters

Discussion