Sign in
Stats

Retrieve Platform Trends

Changed on

Payments across all of Whop, for up to four windows at once. Break rows down by business type, industry type, account country or customer country, and let the business type ride along on industry type rows. The report covers the whole platform, so it takes no account_id and any authenticated caller can read it. A breakdown value with fewer than three businesses behind it is left out, and a filtered total that small comes back with every metric null.

get/stats/reports/platform_trends

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/stats/reports/platform_trends
  • Auth: HTTP bearer

Query parameters

breakdown_by'business_type' | 'industry_type' | 'account_country' | 'customer_country'

What each row is. Omit it for one row per window, holding the window's total.

columnsstring

Comma-separated properties and metrics to return on each row. Defaults to gross_revenue,businesses.

windowsstring

Comma-separated windows, at most four: 1d, 7d, 30d, 90d, 365d, mtd, qtd, ytd, all_time, an explicit 2026-09-01..2026-10-01, any of these prefixed prev: for the equal-length period before, or suffixed @2026-09-01 to end earlier. Defaults to 30d.

time_zonestring

IANA zone that day, month, quarter and year boundaries fall in. Defaults to Etc/UTC.

order'gross_revenue' | 'businesses' | 'payments' | 'customers' | 'aov' | 'repeat_rate' | 'median_gross_revenue' | 'new_businesses' | 'avg_business_age' | 'avg_owner_age' | 'avg_customer_age'

The requested metric that ranks rows, by its value in the first window. Defaults to the first requested metric.

direction'asc' | 'desc'

Ranking direction. Defaults to desc.

convert_tostring

Currency every money metric is converted into. Defaults to usd.

business_typestring

Only counts payments to businesses of these comma-separated business types, such as education.

industry_typestring

Only counts payments to businesses in these comma-separated industry types, such as options_trading.

account_countrystring

Only counts payments to accounts located in these comma-separated countries, as ISO 3166-1 alpha-2 codes such as US.

customer_countrystring

Only counts payments from customers in these comma-separated countries, as ISO 3166-1 alpha-2 codes such as US.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

Response

Platform trends for each requested window, with rows in the same order in every window.

Example response

{
  "data": {
    "breakdown_by": "industry_type",
    "columns": [
      {
        "key": "industry_type",
        "name": "Industry type",
        "type": "property"
      },
      {
        "key": "business_type",
        "name": "Business type",
        "type": "property"
      },
      {
        "aggregate": "sum",
        "key": "gross_revenue",
        "name": "Gross revenue",
        "type": "metric",
        "unit": "money",
        "weight": null
      },
      {
        "aggregate": "sum",
        "key": "businesses",
        "name": "Businesses",
        "type": "metric",
        "unit": "count",
        "weight": null
      }
    ],
    "data_as_of": "2026-10-07T04:48:34Z",
    "report": "platform_trends",
    "reports": [
      {
        "rows": [
          {
            "business_type": {
              "id": "services",
              "name": "Services"
            },
            "businesses": 828,
            "gross_revenue": {
              "amount": "7002670.25",
              "currency": "usd",
              "decimals": 2,
              "display_decimals": 2
            },
            "industry_type": {
              "id": "marketing_agency",
              "name": "Marketing Agency"
            }
          }
        ],
        "window": {
          "as_of": null,
          "from": "2026-09-30T04:00:00Z",
          "key": "7d",
          "kind": "range",
          "time_zone": "Etc/UTC",
          "to": "2026-10-07T04:00:00Z"
        }
      },
      {
        "rows": [
          {
            "business_type": {
              "id": "services",
              "name": "Services"
            },
            "businesses": 796,
            "gross_revenue": {
              "amount": "5841223.30",
              "currency": "usd",
              "decimals": 2,
              "display_decimals": 2
            },
            "industry_type": {
              "id": "marketing_agency",
              "name": "Marketing Agency"
            }
          }
        ],
        "window": {
          "as_of": null,
          "from": "2026-09-23T04:00:00Z",
          "key": "prev:7d",
          "kind": "range",
          "time_zone": "Etc/UTC",
          "to": "2026-09-30T04:00:00Z"
        }
      }
    ]
  },
  "page_info": {
    "end_cursor": "MQ",
    "has_next_page": true,
    "has_previous_page": false,
    "start_cursor": "MQ"
  }
}

Changes