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.

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

Title of the code block

Copy

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

Title of the code block

Copy

curl -X GET 'https://api.seranking.com/v1/account/subscription' \

  -H 'Authorization: Token YOUR_API_KEY'

Sample Response: subscription

Title of the code block

Copy

{

  "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

  }

}