Get resource usage for the current billing period
curl --request GET \
--url https://api.social-api.ai/v1/usage \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/usage"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"brands_limit": 10,
"brands_used": 3,
"interactions_limit": 5000,
"interactions_used": 1200,
"page_allowance": 5,
"page_billing_exempt": false,
"period_end": "2026-03-15T00:00:00Z",
"period_start": "2026-02-15T00:00:00Z",
"posts_limit": 200,
"posts_used": 42,
"profile_units_limit": 10,
"profile_units_used": 4
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Usage
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 follow your subscription cycle, or a rolling 30-day window on the free plan.
GET
/
usage
Get resource usage for the current billing period
curl --request GET \
--url https://api.social-api.ai/v1/usage \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/usage"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"brands_limit": 10,
"brands_used": 3,
"interactions_limit": 5000,
"interactions_used": 1200,
"page_allowance": 5,
"page_billing_exempt": false,
"period_end": "2026-03-15T00:00:00Z",
"period_start": "2026-02-15T00:00:00Z",
"posts_limit": 200,
"posts_used": 42,
"profile_units_limit": 10,
"profile_units_used": 4
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Response
Resource usage for the current billing period
Example:
10
Example:
3
Example:
5000
Example:
1200
Example:
5
Example:
false
Example:
"2026-03-15T00:00:00Z"
Example:
"2026-02-15T00:00:00Z"
Example:
200
Example:
42
Example:
10
Example:
4