API Description
Account & system
IMPORTANT: This is the Data API (api.seranking.com). For Project API (api4.seranking.com, included in Business/Enterprise plans), see Project API Docs. API keys are not interchangeable—use the correct one to avoid authentication errors.
If you’re seeing auth errors or need help, contact [email protected] for support.
If you’re seeing auth errors or need help, contact [email protected] for support.
subscription
This command returns information on existing subscriptions along with the current API balance for the authenticated API key.
Request Parameters: subscription
Parameter | Data Type | Mandatory | Default Value | Description | Acceptable values | Example |
---|---|---|---|---|---|---|
output | string | no | json | Output format | json, xml | json |
GET Request
To receive information about the subscription
curl -X GET 'https://api.seranking.com/v1/account/subscription?output=json' \
-H 'Authorization: Token YOUR_API_KEY'
Response Parameters: subscription
Parameter | Data Type | Description | Example |
---|---|---|---|
status | string | Current status of the API subscription plan. One of: active, inactive, expired, disabled. | active |
start_date | datetime | Subscription start date in “YYYY-MM-DD HH:MM:SS” format. | 2025-05-07 15:10:27 |
expiration_date | datetime | Subscription expiration date in “YYYY-MM-DD HH:MM:SS” format. | 2026-05-07 15:10:27 |
units_limit | long | Quota (total number of API units) for this subscription | 50000000 |
units_left | long | Current API balance, i.e. number of API units left. | 123546 |
Sample Request: subscription
curl -X GET 'https://api.seranking.com/v1/account/subscription' \
-H 'Authorization: Token YOUR_API_KEY'
Sample Response: subscription
{
"subscription_info": {
"status": "active",
"start_date": "2024-01-18 14:20:02",
"expiraton_date": "2024-02-18 14:20:02",
"units_limit": 5000000,
"units_left": 4975033
}
}