Product rankings and impressions

Product rankings endpoint

  • Get product rankings: Retrieves the rank and impressions of products within the webshop, utilizing advanced models to analyze their performance in both search and browse contexts, offering a comprehensive technical overview of market positioning and visibility.

Query Types

Search:

  • In this mode, the endpoint focuses on data related to product rankings in list pages created through explicit user search terms, like 'harry potter', without any redirections or additional manipulations.

  • Provides detailed insights into the product’s ranking for each associated search term, along with the number of impressions for these terms.

  • Partners can leverage this data in combination with search frequency information (available through the 'Get search results' endpoint) to conduct in-depth analyses of search trends and product performance in response to direct consumer queries.

Browse:

  • This mode generates data for list pages where the products are categorized not by search terms but by unique identifiers, typically category IDs. These IDs often link to specific navigational choices or promotional activities within the webshop.

  • The endpoint provides category IDs (categoryId) associated with a product’s EAN, essential for understanding the product’s placement within specific categories.

  • Partners can utilize these category IDs to retrieve extensive lists of related products and detailed category hierarchies through 'Get product list' and 'Get product list filters' endpoints, enabling a comprehensive category-level market analysis.

Handling Mixed Type:

  • When the type parameter is left unspecified, the endpoint aggregates and provides a comprehensive response that includes data from both BROWSE and SEARCH modes. This offers a holistic view of the product’s overall webshop performance.

Comparison of Insight Types:

Table 1. Insight types
Context SEARCH BROWSE

Definition

The context where users search for products using specific search terms in the webshop.

The context where products are listed without specific search terms, often based on categorization or promotional criteria.

Focus

Understanding where a product ranks in response to specific search queries made by users.

Understanding how a product is positioned within its category or in specific sections of the webshop (e.g., promotional areas or banner clicks).

Use Cases

Important for improving SEO strategies and understanding consumer search behavior.

Essential for analyzing category-level performance, understanding product placement and visibility within the webshop, and assessing the impact of navigation and promotional strategies.

Types of Data

Ranking and impression data for the product in response to specific search queries.

Ranking and impression data for the product within its category or relevant webshop sections.

Analysis Goals

Examining product performance in response to search queries.

Analyzing category-level performance, product visibility and positioning within the webshop, and assessing the impact of navigation and promotional strategies.

Remarks and availability of the data

  • The Date parameter supports data retrieval for a time window extending back three months from the current date, with a limit of one day before the current date for the most recent data.

  • Data remains stable and consistent for specific dates and products, aligning with the endpoint’s purpose of offering current and recent trend analysis, rather than serving as a historical archive.

Usage of the given response fields

In the response, this endpoint provides you the following:

  • categoryId: The categoryId field indicates the ID of the category to which the product belongs in the BROWSE mode. It helps categorize the product and understand its placement within the webshop’s category hierarchy.

  • searchTerm: The searchTerm field provides the search term associated with the rank in the SEARCH mode. It helps identify the specific search query or term that led to the product’s ranking.

  • wasSponsored: This boolean field serves as an indicator of whether the product was sponsored or not. It helps distinguish between sponsored and non-sponsored product placements.

  • impressions: The impressions field specifies the number of times the product has been displayed or viewed. It quantifies the visibility of the product in search or browse results.

  • hasNextPage: This boolean field indicates whether there is a next page of ranks available. If true, it suggests that there are more ranks to retrieve, allowing for pagination of results.

Advanced Integration with Complementary Endpoints

Get product list and Get product list filters endpoints:

These endpoints are critical for extending the insights gained from the primary endpoint. They provide a deeper dive into the overall product landscape within specific categories and the interrelations of these categories. This integration is crucial for developing a multi-layered understanding of market dynamics, product placement strategies, and identifying potential areas for competitive advantage.