API

API / Getting API access

Getting API access

SE Ranking provides two APIs for integrating SEO data and platform management capabilities into your workflows and applications:

Data API: Designed for retrieving large volumes of raw SEO and marketing data (e.g., backlinks, keywords). It operates on a flexible, usage-based credit model.
Project API: Designed for automating and managing your SEO projects (e.g., creating websites, managing keywords, running audits). Access is based on your subscription limits.

This guide explains the access requirements, pricing models, and steps to generate API keys for both APIs.

Data API

The Data API provides direct access to SE Ranking’s datasets. To use it, your account must have API credits. Credits can be obtained in one of the following ways:

Growth Plan: Automatically includes 100,000 Data API credits.
API Standalone Plan: Provides full Data API access with packages starting at 24 million credits annually.
Data API Add-On: Available for Core or Growth plan users who need additional credits. Packages start at 12 million credits annually.

For more information or to upgrade your plan, see the Subscription page.

1. Ensure you have credits

To use the Data API, you must have a positive credit balance. If you are on a Growth plan, you already have credits allocated. If you are on another plan or need more volume, purchase an add-on or standalone package.

How many credits do you need?

The cost of Data API requests is measured in credits. The number of credits consumed depends on the specific endpoint and the volume of data requested.

Cost per Record: Many endpoints charge per line of data returned.
Cost per Request: Some endpoints have a fixed cost per successful call.

For example, for a specific keyword report that prices 10 credits per keyword (record), retrieving 1,000 keywords for 50 domains would cost (1,000 keywords * 10 credits/record * 50 domains = 500,000 credits).

We recommend forecasting your usage before executing large workflows. You can find specific costs for each endpoint in the Data API cost documentation.

2. Generate a Data API key

Once you have an active plan with API credits, you can generate your access key.

1. Navigate to the API Dashboard. You can access this by clicking the API icon in the main left-hand navigation menu.

2. On the API Dashboard, click the + CREATE API KEY button located in the top-right corner.

3. In the “Create API key” dialog box:

a. Enter a descriptive name in the API key name field (e.g., “Demo”).

b. Under Type of API, select the Data option.

c. Click CREATE KEY.

4. Your new key will be generated and listed in the API Keys table. You can create multiple Data API keys for different applications or environments.

Project API

The Project API allows you to automate tasks within your SE Ranking account. It uses your subscription limits rather than API credits.

1. Subscription requirements

Access to the Project API is available exclusively to users with an active Core or Growth subscription. For more information, see the Subscription page.

2. Generate a Project API key

If you have a qualifying subscription, follow these steps to generate your key:

1. Navigate to the API Dashboard by clicking the API icon in the left-hand navigation menu.

2. Click the + CREATE API KEY button in the top-right corner of the dashboard.

3. In the “Create API key” dialog box:

a. Under Type of API, select the Project option.

b. Click CREATE KEY.

4. Your Project API key will be generated and appear in the “API Keys” table with the type “Project”.

Note: You can only have one active Project API key per account. You can regenerate the key at any time from this dashboard if needed.

You can monitor your subscription limits under Profile & Preferences > Billing.

Custom and enterprise solutions

If you have high-volume data needs exceeding standard plans or require a custom API solution, contact our team to discuss enterprise options, custom rate limiting, and pricing. You can reach us at [email protected].

Using your API key

Your API key is a secret token used for authentication. Keep it secure and do not expose it in client-side code or public repositories.

To authenticate your requests, include the API key in the Authorization header of your HTTP requests, using the Token scheme.

Example (cURL):

Copy

curl -X GET "https://api.seranking.com/v1/backlinks/summary?target=yourdomain.com" \

     -H "Authorization: Token YOUR_API_KEY"