API unit balance

Basics docs divider

Last updated: April 9, 2024

When you add an API package to your subscription, you'll have a limited amount of API units to make calls.

API requests consume API units per request or line.

The total request price is calculated based on the number of lines in the report or particular request.

Price: free

To make sure you have enough API units to make calls, you can check your balance on the Subscription info page or make a free API request.

Whenever you run out of API units, you can buy more on the Subscription info page or contact our sales representatives.

Endpoint

http://www.semrush.com/users/countapiunits.html

Request example

http://www.semrush.com/users/countapiunits.html?key=YOUR_API_KEY

Response example

1,000

Depending on the report and API version, you'll get either an error or a partial number of lines.

If you don't have enough API units for the requested number of lines or requests:

In API version 3, for reports that cost per line, you will get the number of lines for which you have enough API units.

Therefore, it's important to check API unit balance, so you don't lose data.

Response example (API v4)

{
  "error": {
    "code": 403,
    "message": "????",
    "description": "????"
  }
}

Intro