WbAnalytics icon

WbAnalytics

n8n node to interact with WB API

Overview

This node interacts with the Wildberries (WB) Analytics API to retrieve detailed promotional statistics. Specifically, the "Статистика По Продвижению" resource with the "Post Adv Fullstats" operation allows users to post a request containing date ranges and receive comprehensive advertising performance data for those periods.

Common scenarios include:

  • Marketing teams analyzing the effectiveness of promotional campaigns over specific dates.
  • Data analysts aggregating advertising metrics for reporting or dashboarding.
  • Automated workflows that fetch up-to-date promotional stats to trigger further actions based on campaign performance.

Example use case: A user inputs a JSON body specifying an array of dates or date ranges to get full advertising statistics for those periods, enabling them to monitor trends and optimize marketing spend.

Properties

Name Meaning
Body JSON object containing the request payload. It must include a dates field which is an array of dates or date ranges for which the promotional statistics are requested. Example structure: { "dates": [null] }. The user can customize this JSON to specify exact dates.

Output

The node outputs JSON data representing the full advertising statistics returned by the WB Analytics API for the specified dates. The structure of the output JSON corresponds directly to the API response schema defined in the node's OpenAPI specification.

No binary data output is indicated.

Dependencies

  • Requires access to the Wildberries Analytics API.
  • Needs an API key credential configured in n8n to authenticate requests to the WB API.
  • The base URL and request headers (Accept and Content-Type as application/json) are preconfigured from the bundled OpenAPI specification.

Troubleshooting

  • Invalid JSON in Body: If the JSON provided in the Body property is malformed, the node will fail to parse it. Ensure valid JSON syntax.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly set up.
  • Empty or Incorrect Dates Array: Providing an empty or improperly formatted dates array may result in no data or errors from the API. Confirm the dates array contains valid date strings or null placeholders as required.
  • API Rate Limits or Downtime: The WB API might throttle requests or be temporarily unavailable. Handle such errors by implementing retries or checking API status.

Links and References

  • Wildberries Analytics API documentation (refer to official WB developer resources)
  • n8n documentation on creating and using HTTP Request nodes and JSON input properties

Discussion