WbReports icon

WbReports

n8n node to interact with WB API

Actions26

Overview

This node interacts with an analytics API to retrieve the brand share in sales within a specified category and time period. It is useful for marketing analysts, category managers, or business intelligence professionals who want to understand how a particular brand performs relative to others in a parent product category over a defined date range.

Practical examples include:

  • Measuring the market share of a brand like H&M in a specific product category.
  • Tracking changes in brand share over time to evaluate marketing campaigns.
  • Comparing brand performance across different parent categories.

Properties

Name Meaning
Parent Id ID of the parent category under which the brand's sales share is analyzed (number).
Brand The brand name whose sales share is being requested (string).
Date From Start date of the reporting period in YYYY-MM-DD format.
Date To End date of the reporting period in YYYY-MM-DD format.

Output

The node outputs JSON data containing the analytics results for the brand share in sales. The exact structure depends on the API response but typically includes metrics such as the percentage share of sales attributed to the specified brand within the given parent category and date range.

No binary data output is indicated.

Dependencies

  • Requires access to an external API that provides sales analytics data.
  • Needs an API key or authentication token configured in n8n credentials to authorize requests.
  • The base URL and request headers are preconfigured based on bundled swagger definitions.

Troubleshooting

  • Missing or invalid Parent Id or Brand: Ensure these required parameters are correctly set; otherwise, the API may return errors or empty results.
  • Date format errors: Dates must be in YYYY-MM-DD format; incorrect formats can cause request failures.
  • Authentication issues: Verify that the API key or authentication token is valid and properly configured in n8n.
  • API rate limits or downtime: If requests fail repeatedly, check API service status or usage limits.

Common error messages might include:

  • "Invalid parameter" if inputs are malformed.
  • "Unauthorized" if authentication fails.
  • "Not found" if the parent category or brand does not exist in the system.

Resolving these usually involves correcting input values, verifying credentials, or consulting API documentation.

Links and References

  • No direct links provided in the source code.
  • Users should refer to the external API documentation for detailed information on parameters and response formats.

Discussion