Skip to main content

Account and usage

Read your own credit balance, plan limits and auto top-up settings. These calls are free.

Base URL https://api.socialapis.io. Every call needs your API key in the x-api-token header.

Get Usage​

Get current credit usage and plan info. Free — does not consume credits.

Endpoint​

GET /usage

Parameters​

None.

Pricing​

Per call: Free.

Example Request​

curl --request GET \
  --url 'https://api.socialapis.io/usage' \
  --header 'x-api-token: YOUR_API_KEY'

Get Top-ups​

Get auto top-up settings and recent history. Free — does not consume credits.

Endpoint​

GET /usage/top-ups

Parameters​

None.

Pricing​

Per call: Free.

Example Request​

curl --request GET \
  --url 'https://api.socialapis.io/usage/top-ups' \
  --header 'x-api-token: YOUR_API_KEY'

Get Plan Limits​

Get plan limits (rate limit, max tasks, allowed top-ups). Free — does not consume credits.

Endpoint​

GET /usage/limits

Parameters​

None.

Pricing​

Per call: Free.

Example Request​

curl --request GET \
  --url 'https://api.socialapis.io/usage/limits' \
  --header 'x-api-token: YOUR_API_KEY'

Verifying what you were charged​

Every paid response carries an X-SocialAPIs-Credits-Deducted header with the exact credit amount charged for that request. Variable-priced endpoints (page and group posts, media download) report the resolved amount here, so you can reconcile usage without checking the dashboard. Prices on this page come from the live endpoint catalog when the docs were built; socialapis.io/openapi.json always has the current ones.