Understand your account data with Explore

What's new?

We've added Explore, a new page in the Paddle dashboard for filtering and breaking down your revenue, refunds, chargebacks, checkout conversion, and subscription metrics.

Explore is powered by two new metrics operations, so anything you can do in the dashboard you can query directly:

• GET /metrics/explore/entities lets you discover what's queryable: entities, their dimensions and measures, allowed aggregations, and permitted intervals.
• POST /metrics/explore lets you query one entity over a date range, optionally filtered, broken down by a single dimension, and paginated.

How it works

With Explore, you can go from noticing something to understanding why it happened without leaving Paddle. Start from a metric, narrow it with filters, then group the results to see what changed and where.

Explore covers seven key metrics:

You can use these metrics to filter and break down further to tailor the results to your use case. For example, you can use Explore to:

• Diagnose changes, like understanding why revenue increased or decreased over a period.
• Find where you're underperforming, like breaking down checkout conversion, refunds, and chargebacks by country, product, and billing frequency.
• Understand the shape of your business, like which markets perform best, which products carry your business, and how much of your revenue is monthly vs. annual.
• Get advanced insights by combining queries, like analyzing whether a market is growing because of more sales or higher prices.

The data that powers the metrics refreshes on a 24-hour cycle. You can look back over the last two years using the dashboard, and the last three years using the API.

API pagination

Pagination for the Explore metrics operation works differently to pagination for list operations:

• Your query lives in a request body that you POST, rather than as query parameters that you GET.
• It paginates by breakdown value rather than datapoint, so breaking revenue down by product with per_page set to 5 returns five products, each with its complete timeseries.

To paginate, you re-send your query request body with the after cursor rather than following meta.pagination.next as a URL.

For full details, see Pagination.

Next steps

Find Explore under Paddle > Analytics > Explore, or open it directly from a chart on the overview page.

Explore metrics endpoints are available in version 1 of the Paddle API. It's a non-breaking change, meaning it doesn't impact existing integrations.

To get started, see the metrics API reference for the full request and response shapes, or the Explore guide for a walkthrough of both the dashboard and the API.

Querying the API endpoints requires the metrics.read permission.