Get unified product performance listing

Use the productPerformanceListingItems query to retrieve a unified listing of categories and products for a Product Performance dashboard view. Supports drill-down navigation by category.

Default behavior (no filters)

When called without filters, this query returns all categories plus only uncategorized products — products assigned to a category appear inside their respective categories rather than in the top-level list. This matches the "All Products" view in the Connect UI, where only uncategorized products are surfaced at the root level.

query UnifiedListing {
  productPerformanceListingItems(first: 20) {
    pageInfo { hasNextPage count }
    nodes {
      id
      itemType
      name
      performanceMetrics {
        metrics {
          totalRevenue
          productViews
        }
      }
    }
  }
}

itemType distinguishes categories from products in the response so the consumer can render them differently.

Filter behavior

Filters on productPerformanceListingItems behave differently from filters on the other performance queries. Two filter parameters are accepted: productFilter and categoryFilter.

• productFilter only: Returns all categories plus any matching products.
• categoryFilter only: Returns only the matching category.
• Both filters together: Returns only the matching category — productFilter is effectively ignored.
• Both filters with a non-existing category: Returns an empty array.
• Both filters with non-existing product but existing category: Returns the matching category.
• Search results presentation: When searching by name / productName with contains, categories are always returned first regardless of whether their name matches the search phrase. Customers should expect to paginate through categories before reaching product matches, and the response does not surface a "no matches" state when products aren't found.

Date ranges

Date range inputs are optional. If omitted, the query defaults to the last 30 days. Max range: 60 days, no future dates, start and end must be supplied together. See Get product performance summary for the full date range model.

Authentication

This API uses API Key authentication. See Using the Connect API for instructions on how to get and use your API key.