WbAnalytics icon

WbAnalytics

n8n node to interact with WB API

Actions19

Overview

This node interacts with a Wildberries analytics API to retrieve detailed search report data for specific products based on their article IDs (nmIds). It is designed to fetch and compare search query statistics over two periods (current and past), allowing users to analyze product search performance trends. The node supports sorting and limiting the number of search queries returned, making it useful for marketing analysts, product managers, or e-commerce specialists who want to understand how customers find and interact with products on the Wildberries platform.

Practical examples:

  • Comparing search query positions and conversions for a set of products between two time periods.
  • Identifying top search queries that lead to adding products to cart or placing orders.
  • Analyzing conversion rates from search results to cart additions or orders to optimize product listings.

Properties

Name Meaning
Current Period The current date range for which to retrieve search report data. JSON object with start and end dates, e.g., { "start": "2024-02-10", "end": "2024-02-10" }.
Past Period Optional comparison period with start and end dates. Should be equal or shorter in duration than the current period. Used to compare historical search data.
Nm Ids List of Wildberries product article IDs (numeric) to query search reports for, e.g., [162579635, 166699779].
Top Order By Field by which to sort the top search queries. Options include:
- openCard: Number of times users opened product cards from search.
- addToCart: Added to cart from search.
- openToCart: Conversion to cart.
- orders: Number of orders from search.
- cartToOrder: Conversion from cart to order.
Order By Sorting parameters as a JSON object with:
- field: Field name to sort by (e.g., "avgPosition").
- mode: Sort direction ("asc" or "desc").
Limit Maximum number of search queries to return per product. Numeric value, e.g., 20.

Output

The node outputs JSON data containing search report details for the specified products and periods. The structure includes metrics such as average position in search results, counts of user actions (opening product cards, adding to cart, ordering), and conversion rates between these steps. This structured data enables further analysis or visualization downstream in workflows.

No binary data output is produced by this node.

Dependencies

  • Requires access to the Wildberries analytics API.
  • Needs an API key credential configured in n8n for authentication with the Wildberries API.
  • The node uses JSON-formatted input properties that are parsed and sent in the request body.
  • Network connectivity to the Wildberries API endpoint is necessary.

Troubleshooting

  • Invalid Date Format: Ensure that the Current Period and Past Period JSON objects contain valid ISO date strings for start and end.
  • API Authentication Errors: If the node fails due to authentication, verify that the API key credential is correctly set up and has sufficient permissions.
  • Empty or Incorrect nmIds: Providing invalid or empty product IDs will result in no data returned. Confirm that the list contains valid numeric article IDs.
  • Sorting Parameter Issues: The orderBy field must be a valid JSON object with correct fields; otherwise, the API may reject the request.
  • Limit Exceeded: Setting a very high limit might cause performance issues or API rate limits; use reasonable values.

Links and References

Discussion