> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog and deprecations

> What changed in the Growi API, and which endpoints to move off.

## Deprecations

The old Home stats endpoints (`/stats/*` below) are deprecated: they moved to the
**Deprecated** section of this reference and keep working exactly as before. New
integrations should use the replacements.

The deprecated endpoints take `MM/DD/YYYY` dates. Their replacements take ISO 8601
(`YYYY-MM-DD`), so change your date format when you switch.

Every response from a deprecated endpoint, errors included, carries:

| Header | Example | Meaning |
| - | - | - |
| `Deprecation` | `@1793750400` | When it was deprecated, as a Unix timestamp ([RFC 9745](https://www.rfc-editor.org/rfc/rfc9745)) |
| `Link` | `<https://api.growi.io/api/public/v1/content/series>; rel="successor-version"` | The endpoint to use instead. Some list two |

| Deprecated | Use instead |
| - | - |
| [`GET /stats/snapshots`](https://growi.mintlify.site/api-reference/endpoint/get-snapshots) | [`GET /content/series`](https://growi.mintlify.site/api-reference/endpoint/content/series) |
| [`GET /stats/content_24h_data`](https://growi.mintlify.site/api-reference/endpoint/get-content-24h-data), [`GET /stats/creators_24h`](https://growi.mintlify.site/api-reference/endpoint/get-creators-24h) | [`GET /content/summary`](https://growi.mintlify.site/api-reference/endpoint/content/summary) |
| [`GET /stats/top_creators_by_engagement`](https://growi.mintlify.site/api-reference/endpoint/get-top-creators), [`GET /stats/top_creators_by_posts`](https://growi.mintlify.site/api-reference/endpoint/get-top-creators-by-posts) | [`GET /content/top_creators`](https://growi.mintlify.site/api-reference/endpoint/content/top-creators) |
| [`GET /stats/top_connected_accounts_by_engagement`](https://growi.mintlify.site/api-reference/endpoint/get-top-connected-accounts-by-engagement) | [`GET /content/top_accounts`](https://growi.mintlify.site/api-reference/endpoint/content/top-accounts) |
| [`GET /stats/top_posts_by_views`](https://growi.mintlify.site/api-reference/endpoint/get-top-posts-by-views) | [`GET /content/top_posts`](https://growi.mintlify.site/api-reference/endpoint/content/top-posts) |
| [`GET /stats/content_platform_composition`](https://growi.mintlify.site/api-reference/endpoint/get-content-platform-composition) | [`GET /content/top_platforms`](https://growi.mintlify.site/api-reference/endpoint/content/top-platforms) |
| [`GET /stats/user_contents`](https://growi.mintlify.site/api-reference/endpoint/get-user-contents) | [`GET /posts`](https://growi.mintlify.site/api-reference/endpoint/content/posting-report) and [`GET /content/post_series`](https://growi.mintlify.site/api-reference/endpoint/content/post-series) |
| [`GET /stats/filters`](https://growi.mintlify.site/api-reference/endpoint/get-filters) | [`GET /content/filters`](https://growi.mintlify.site/api-reference/endpoint/content/filters) |
| [`GET /stats/tik_tok_shop_gmv_24h`](https://growi.mintlify.site/api-reference/endpoint/get-tik-tok-shop-gmv-24h) | [`GET /tik_tok_shop/affiliate/summary`](https://growi.mintlify.site/api-reference/endpoint/tik-tok-shop/affiliate-summary) and [`GET /tik_tok_shop/summary/weekly`](https://growi.mintlify.site/api-reference/endpoint/tik-tok-shop/summary-weekly) |
| [`GET /stats/tik_tok_shop_products`](https://growi.mintlify.site/api-reference/endpoint/get-tik-tok-shop-products) | [`GET /tik_tok_shop/products`](https://growi.mintlify.site/api-reference/endpoint/get-tik-tok-shop-store-products) |
| [`GET /stats/top_creators_by_gmv`](https://growi.mintlify.site/api-reference/endpoint/get-top-creators-by-gmv), [`GET /stats/top_earning_creators`](https://growi.mintlify.site/api-reference/endpoint/get-top-earning-creators) | [`GET /stores/overview`](https://growi.mintlify.site/api-reference/endpoint/stores/overview) and [`GET /shopify/stats`](https://growi.mintlify.site/api-reference/endpoint/shopify/stats) |
| [`GET /stats/payouts_24h`](https://growi.mintlify.site/api-reference/endpoint/get-payouts-24h), [`GET /stats/manual_campaign_progress`](https://growi.mintlify.site/api-reference/endpoint/get-manual-campaign-progress) | [`GET /payouts/totals`](https://growi.mintlify.site/api-reference/endpoint/payouts/payout-totals) |
| [`GET /stats/creator_payouts`](https://growi.mintlify.site/api-reference/endpoint/get-creator-payouts) | [`GET /payouts`](https://growi.mintlify.site/api-reference/endpoint/payouts/list-payouts) |
| [`POST /stats/refresh_data`](https://growi.mintlify.site/api-reference/endpoint/refresh-data) | Nothing. The new endpoints read live data |

`/stats/mark_credit_payout`, `/stats/transactions` and the ambassador endpoints
aren't deprecated.

## November 2026

**November 2026: spikes and breakouts**

**New**

* [Spike days](https://growi.mintlify.site/api-reference/endpoint/content/spikes.md) and [what drove a day](https://growi.mintlify.site/api-reference/endpoint/content/day-breakdown.md): days that jumped above normal and the posts behind them.
* [Breakout posts](https://growi.mintlify.site/api-reference/endpoint/content/breakout-posts.md): posts gaining far faster than their own pace right now.
* [Content series by group](https://growi.mintlify.site/api-reference/endpoint/content/series-by.md), [views per post](https://growi.mintlify.site/api-reference/endpoint/content/per-post-series.md) and [post readings per day](https://growi.mintlify.site/api-reference/endpoint/content/data-health.md).
* MCP: `get_content_spikes`, `explain_day`, `list_breakout_posts`, and `group` on `get_content_series`.

**November 2026**

**New**

* Content analytics: 14 `/content/*` endpoints with the numbers on your Home page, live on every call.
* Sales and stores: `GET /stores/overview`, `GET /shopify/stats` (ambassador stats), `GET /shopify/store_creators` and its summary, and iOS and Android app analytics and creator funnels.
* Payouts: `GET /payouts`, `GET /payouts/totals` and `GET /payouts/{uuid}`, the same rows as Finance → Payouts. Each payout has a `state` (`ready`, `updating` or `canceled`).
* Meta ads performance: overview, over time, by creator and by creative.
* All of them work with viewer keys, take ISO 8601 dates and accept `organization_id`.

**Changed**

* The old Home stats endpoints are deprecated. See the table above.
* The API reference is grouped by product area, and the old stats endpoints moved to **Deprecated**.
* `GET /posts` (posting report) is documented.
* `GET /stats/creator_payouts` (now deprecated), `POST /stats/mark_credit_payout` and `GET /stats/filters` now show their parameters and responses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.