Get resource usage for the current billing period

Returns brands, posts, and interactions consumed during the current billing period alongside the plan limits. -1 means unlimited (all paid plans). Period boundaries come from Stripe subscription or rolling 30-day windows for free users.

GET /usage

Get resource usage for the current billing period

cURL

curl --request GET \
  --url https://api.social-api.ai/v1/usage \
  --header 'Authorization: <api-key>'

200

{
  "brands_limit": 10,
  "brands_used": 3,
  "interactions_limit": 5000,
  "interactions_used": 1200,
  "period_end": "2026-03-15T00:00:00Z",
  "period_start": "2026-02-15T00:00:00Z",
  "posts_limit": 200,
  "posts_used": 42
}

Authorizations

Authorization · string · header · required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Response

200

application/json

Resource usage for the current billing period

brands_limit · integer

Example:

10

brands_used · integer

Example:

3

interactions_limit · integer

Example:

5000

interactions_used · integer

Example:

1200

period_end · string

Example:

"2026-03-15T00:00:00Z"

period_start · string

Example:

"2026-02-15T00:00:00Z"

posts_limit · integer

Example:

200

posts_used · integer

Example:

42