---
title: "GET /v1/public/stats/market-share"
method: GET
path: "/v1/public/stats/market-share"
tags: ["Stats"]
---

# GET /v1/public/stats/market-share

`GET /v1/public/stats/market-share`

Get market share statistics by model author for the AI Gateway.
Returns time series data (100% stacked) and a leaderboard of top 9 authors + others.

## Query parameters

- `timeframe` '24h' | '7d' | '30d' | '3m' | '1y'

## Response `200`

Ok

- union
  - ResultSuccessMarketShareResponse
    - `data` MarketShareResponse, required
      - `timeSeries` MarketShareTimeSeriesDataPoint[], required
        - `time` string, required
        - `authors` AuthorTokens[], required
          - `author` string, required
          - `totalTokens` number, double, required
          - `percentage` number, double, required
      - `leaderboard` MarketShareLeaderboardEntry[], required
        - `rank` number, double, required
        - `author` string, required
        - `totalTokens` number, double, required
        - `marketShare` number, double, required
        - `rankChange` number, double, nullable, required
        - `marketShareChange` number, double, nullable, required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

## Changes

- **2025-12-18** `9888008a3ce5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/helicone/apis/helicone-api/changes/v1/public/stats/market-share/get.md)

---

[API](https://skmtc.dev/helicone/apis/helicone-api.md) · [All operations](https://skmtc.dev/helicone/apis/helicone-api/llms.txt) · [OpenAPI document](https://skmtc.dev/helicone/apis/helicone-api/revisions/35826db2ca85?raw)