API

Account

You are reading the Project API docs

Base URL: api4.seranking.com

Data API and Project API keys are not interchangeable — use the correct one to avoid authentication errors.

Data apikey example:
80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3
(UUID format)
Project apikey example:
253a73adxxxxxxxxxxxxxx340aa0a939
(40-char hex)

API keys are available in your account. For any questions or 401 errors, email [email protected] for support.

Account balance

The method allows to check the balance of a user account.

Request format

Copy
GET /account/balance

Result

If successful, the server returns an array containing the account currency, currency code and current account balance.

NameRequiredDescription
currencyYesAccount currency (outdated, use currency_code instead)
currency_codeYesAccount currency code
valueYesCurrent account balance

Response example

Copy
{
"currency": "USD",  
  "currency_code": "USD",
"value": 99964.91699
}

User profile

The method allows you to get information about the currently logged in user.

Request format

Copy
GET /account/profile

Result

If successful, the server returns an array containing account data.

NameRequiredTypeDescription
emailYesStringAccount email 
email_verifiedYesBoolEmail confirmed (1 – yes, 2 – no)
first_nameYesStringAccount name
last_nameYesStringAccount surname
langYesStringAccount language (ISO 639-1 alpha-2)
pictureYesString|nullLink to the user’s avatar. Null if missing

Response example

Copy
{    
"email": "[email protected]",  
  "email_verified": true,    
"first_name": "John",   
 "last_name": "Doe",   
 "lang": "en",   
 "picture": "https://online.seranking.com/files/public/avatar/se.png"
}

Subscription data

The method allows you to get information about the currently logged in user’s subscription.

Request format

Copy
GET /account/subscription

Result

If successful, the server returns an array containing subscription data.

NameRequiredTypeDescription
typeYesStringmanual (pay for checks) | trial (trial account) | subscription 
balanceNoArray{‘currency’ => Currency code (USD | RUB)‘amount’ => Account balance}
is_expiredNoBooleantrue if the license is expired.Only for type=trial and type=subscription

Response example

Copy
{   
"type": "subscription",   
 "is_expired": "false",   
  "balance": {   
   "currency": "USD",    
    "amount": 100.00  
}
}

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product expert, Alex.

He’ll walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

Request a free demo to see our tools and integrations in action

By clicking this button, you agree to SE Ranking’s Terms of Services and Privacy Policy.