Introduction

Record sales, manage creators and pull the same numbers your Growi dashboard shows, over one REST API.

The Growi API lets your systems do what the dashboard does: record sales from your own checkout, manage the creators in your campaigns, and read content, sales and payout numbers for reporting.

Base URL

https://api.growi.io/api/public/v1

​

Your first request

Create a key under Settings → Developer → API keys, then list your brands:

curl https://api.growi.io/api/public/v1/organizations/brands \
  -H "Authorization: Bearer growi-sk-YOUR-API-KEY"

​

The basics

Topic	In short
Authentication and keys	Send Authorization: Bearer <key>. A full key reads and writes. A viewer key is read-only (GET only), so it’s safe to share with a BI tool or agency.
Rate limits	40 requests per hour per key, and at least 2 seconds between calls. X-RateLimit-* headers show where you are; a 429 comes with Retry-After.
Child brands	A key belongs to your top-level organization. Pass organization_id to read one of its child brands.
Dates, money and errors	New endpoints take and return ISO 8601 dates (YYYY-MM-DD, UTC days). Errors are JSON with an error message.
Changelog and deprecations	What changed, and which endpoints are deprecated. Deprecated endpoints keep working and send a Deprecation header and a Link header that names the replacement.

​

What’s in the API

Content analytics

Views, engagement, posts and top creators: the numbers on your Home page.

Sales and stores

Record sales, send tracking events, and read store, Shopify and app stats.

Creators and campaigns

Campaign creators and their codes, applications and sample requests.

Payouts

Creator payouts, credit payouts and transactions.

TikTok Shop

Store creators, videos, LIVEs and products, plus finance, shop health and samples.

Meta ads

Ad performance by creator and creative, and building and launching ads from creator content.

Want Claude or another AI assistant to read your Growi data instead of writing code? See AI & MCP.