Skip to main content

SE Ranking

SE Ranking is an SEO platform for rank tracking, website audits, competitor research, backlink analysis, and keyword research. The SE Ranking connector reads your projects, keyword rank history, project competitors, and site audits through the Project API, and domain traffic, domain keywords and competitors, backlinks, referring domains, and keyword metrics through the Data API. It can also create projects and add keywords to them.

SE Ranking icon

Power end-to-end data operations for your SE Ranking API with Nexla. Our bi-directional SE Ranking connector is purpose-built for SE Ranking, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to SE Ranking or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your SE Ranking workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Nexla connects to SE Ranking's Data API and Project API with one API key; the same key works for both. To create a key:

  1. Sign in to SE Ranking. If you don't have an account, you can start a trial from the API pricing page.

  2. In the left menu, go to API > Dashboard, and click + Create API key.

  3. Name the key, create it, and copy it. Store it securely.

For details, see SE Ranking's How to get an API key guide.

The Project API templates work with the projects in your SE Ranking account and count against your plan's limits. The Data API templates analyze any domain or keyword and are billed in API credits from your SE Ranking balance.

Data API templates spend credits

SE Ranking charges API credits for every successful Data API request. Each Data API template below lists its cost: for example, a domain overview costs 100 credits per run, backlink lists cost 1 credit per backlink returned, and related or similar keyword lists cost 10 credits per keyword returned. Keep Max Results small while testing, and check your balance with the Get Credit Balance template, which is free.

SE Ranking API rate limits

SE Ranking allows 5 requests per second for each API method and returns HTTP 429 when the limit is exceeded; repeated violations block the key for 10 minutes. See SE Ranking's rate limits page.

Authenticate​

Credentials required​

One SE Ranking API key covers both the Project API and the Data API, sent as Authorization: Token <key>. The connection test reads the subscription (0 credits).

FieldRequiredSecretDescription
API KeyYesYesSE Ranking API key from API > Dashboard > + Create API key in your SE Ranking account. The same key works for the Project API and the Data API.

Create a credential in Nexla​

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Paste your SE Ranking API key into the API Key field. Nexla sends it in the Authorization header as Token <key>; enter only the key.

    The API key is sensitive and should be kept secure. If it is exposed, delete it in SE Ranking under API > Dashboard, create a new key, and update this credential.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Nexla tests the credential by reading your API subscription, which does not use credits.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the SE Ranking connector tile, then select the credential that will be used to connect to your SE Ranking account, and click Next; or, create a new SE Ranking credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common SE Ranking endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below, grouped by area.

Each template makes a single request per run, except List Site Audits, which pages through every audit. Templates that take a Max Results setting return one page of that size. Templates that need an ID, such as a project or competitor ID, read data for that one object; use the matching list template to find the ID.

Projects and rank tracking (Project API)​

These templates do not use API credits.

List Projects

Lists every project (tracked site) in your SE Ranking account, with its ID, name, title, group, active flag, and check frequency. Use it first to find the Project ID that the other project templates need.

Get Project Summary

Returns one project's ranking summary: today's and yesterday's average position, the number of keywords that moved up and down, the counts in the top 5, 10, and 30, and visibility.

  • Calls GET /v1/project-management/sites/summary?site_id={Project ID}.
  • Project ID (required): The project ID. Use List Projects to find it.
  • See the SE Ranking API reference for the response fields.

List Project Search Engines

Lists the search engines a project tracks, with the site engine ID, search engine ID, region, language, and keyword count.

  • Calls GET /v1/project-management/sites/search-engines?site_id={Project ID}.
  • Project ID (required): The project ID. Use List Projects to find it.
  • See the SE Ranking API reference for the response fields.

List Project Keywords

Lists the keywords tracked in a project, with each keyword's ID, text, keyword group, target URL, and tags. Use it to match keyword IDs in Get Keyword Positions to keyword text.

  • Calls GET /v1/project-management/keywords?site_id={Project ID}.
  • Project ID (required): The project ID. Use List Projects to find it.
  • See the SE Ranking API reference for the response fields.

Get Keyword Positions

Returns the rank tracking history of a project's keywords over a date range: one record per tracked keyword with its daily positions, position change, search volume, and landing pages, for every search engine in the project.

  • Calls GET /v1/project-management/sites/positions?site_id={Project ID}&date_from={Start Date}&date_to={End Date}.
  • Project ID (required): The project ID. Use List Projects to find it.
  • Start Date (required; default {now-30}): The first day of the period, in yyyy-MM-dd format. The default, {now-30}, is 30 days ago.
  • End Date (required; default {now}): The last day of the period, in yyyy-MM-dd format. The default, {now}, is today.
  • Records carry the keyword ID, not its text; use List Project Keywords to look up the text. Records for different search engines are not labeled with the engine.
  • See the SE Ranking API reference for the response fields.

List Project Competitors

Lists the competitors added to a project, with each competitor's ID, name, URL, and domain trust. Use the competitor ID with Get Competitor Positions.

  • Calls GET /v1/project-management/competitors?site_id={Project ID}.
  • Project ID (required): The project ID. Use List Projects to find it.
  • See the SE Ranking API reference for the response fields.

Get Competitor Positions

Returns the rank history of one project competitor for the project's keywords over a date range: one record per keyword with daily positions and position change.

  • Calls GET /v1/project-management/competitors/positions?competitor_id={Competitor ID}&date_from={Start Date}&date_to={End Date}.
  • Competitor ID (required): The competitor ID. Use List Project Competitors to find it.
  • Start Date (required; default {now-30}): The first day of the period, in yyyy-MM-dd format. The default, {now-30}, is 30 days ago.
  • End Date (required; default {now}): The last day of the period, in yyyy-MM-dd format. The default, {now}, is today.
  • See the SE Ranking API reference for the response fields.

List Available Search Engines

Lists every country search engine that SE Ranking can track, with its ID, name (such as Google USA), and region ID. Use it as a reference when setting up projects.

Site audits (Project API)​

These templates do not use API credits.

List Site Audits

Lists the website audits in your account, newest first, with each audit's ID, URL, project, status, last update, and score, error, warning, and notice counts. Use the audit ID with Get Site Audit Report.

  • Calls GET /v1/project-management/audits.
  • Results are paged automatically, 100 audits per page.
  • See the SE Ranking API reference for the response fields.

Get Site Audit Report

Returns the full report of one website audit as one record: health score, page and issue totals, domain properties, and every check by section with its issue code, status, and count.

  • Calls GET /v1/project-management/audits/report?audit_id={Audit ID}.
  • Audit ID (required): The audit ID. Use List Site Audits to find it.
  • See the SE Ranking API reference for the response fields.

Domain analysis (Data API)​

These templates spend API credits on every run.

Get Domain Overview

Returns organic and paid search statistics for a domain in one country database as one record: keyword counts, traffic, traffic cost, position distribution, and new and lost keywords.

  • Cost: 100 credits per run.
  • Calls GET /v1/domain/overview/db?source={Regional Database}&domain={Domain}.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Domain (required; default seranking.com): The domain to analyze, for example example.com.
  • See the SE Ranking API reference for the response fields.

Get Worldwide Domain Overview

Returns a domain's organic and paid traffic, keyword counts, and traffic cost summed across all countries for the current month, as one record.

  • Cost: 100 credits per run.
  • Calls GET /v1/domain/overview/worldwide?domain={Domain}.
  • Domain (required; default seranking.com): The domain to analyze, for example example.com.
  • See the SE Ranking API reference for the response fields.

List Domain Keywords

Lists the keywords a domain ranks for in one country database, organic or paid, sorted by traffic, with position, search volume, CPC, difficulty, and ranking URL.

  • Cost: 100 credits per run, whatever the number of results.
  • Calls GET /v1/domain/keywords?source={Regional Database}&domain={Domain}&type={Traffic Type}&limit={Max Results}&order_field=traffic&order_type=desc.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Domain (required; default seranking.com): The domain to analyze, for example example.com.
  • Traffic Type (required; default organic): organic for organic search results, or adv for paid search (ads). Options: organic, adv.
  • Max Results (required; default 100): The number of keywords to return, from 1 to 1,000. Only one page is read.
  • See the SE Ranking API reference for the response fields.

List Domain Competitors

Lists the domains that compete with a domain in one country database, organic or paid, with common and missing keywords, relevance, and traffic.

  • Cost: 100 credits per run.
  • Calls GET /v1/domain/competitors?source={Regional Database}&domain={Domain}&type={Traffic Type}.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Domain (required; default seranking.com): The domain to analyze, for example example.com.
  • Traffic Type (required; default organic): organic for organic search results, or adv for paid search (ads). Options: organic, adv.
  • See the SE Ranking API reference for the response fields.

These templates spend API credits on every run.

Get Backlinks Summary

Returns the backlink profile of a domain, host, or URL: backlinks, referring domains, IPs, subnets, dofollow and nofollow counts, InLink Rank, and top anchors and TLDs.

  • Cost: 100 credits per run.
  • Calls GET /v1/backlinks/summary?target={Target}&mode={Mode}.
  • Target (required; default seranking.com): The root domain, host, or URL to analyze, for example example.com.
  • Mode (required; default host): domain covers the whole domain with its subdomains, host covers only this host, and url covers one exact URL. Options: domain, host, url.
  • See the SE Ranking API reference for the response fields.

List Backlinks

Lists the backlinks pointing to a domain, host, or URL, newest first, with source and destination URL, anchor text, nofollow flag, InLink Rank, and first-seen date.

  • Cost: 1 credit per backlink returned.
  • Calls GET /v1/backlinks/all?target={Target}&mode={Mode}&limit={Max Results}&order_by=date_found.
  • Target (required; default seranking.com): The root domain, host, or URL to analyze, for example example.com.
  • Mode (required; default host): domain covers the whole domain with its subdomains, host covers only this host, and url covers one exact URL. Options: domain, host, url.
  • Max Results (required; default 100): The number of backlinks to return, from 1 to 10,000. Only one page is read, and each backlink costs 1 credit.
  • See the SE Ranking API reference for the response fields.

List Referring Domains

Lists the domains that link to a domain, host, or URL, strongest first, with backlink and dofollow backlink counts, first-seen date, and Domain InLink Rank.

  • Cost: 1 credit per referring domain returned.
  • Calls GET /v1/backlinks/refdomains?target={Target}&mode={Mode}&limit={Max Results}&order_by=domain_inlink_rank.
  • Target (required; default seranking.com): The root domain, host, or URL to analyze, for example example.com.
  • Mode (required; default host): domain covers the whole domain with its subdomains, host covers only this host, and url covers one exact URL. Options: domain, host, url.
  • Max Results (required; default 100): The number of referring domains to return, from 1 to 10,000. Only one page is read, and each domain costs 1 credit.
  • See the SE Ranking API reference for the response fields.

Keyword research (Data API)​

These templates spend API credits on every run.

Get Keyword Metrics

Returns metrics for a list of keywords in one country database: search volume, CPC, competition, difficulty, intent, and volume trend, with one record per keyword.

  • Cost: 100 credits per run.
  • Calls POST /v1/keywords/export?source={Regional Database}.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Keywords (required; default ["seo"]): A JSON array of the keywords to look up, for example ["seo", "rank tracker"].
  • This template reads data; it uses POST only because SE Ranking takes the keyword list in the request body.
  • See the SE Ranking API reference for the response fields.

List Related Keywords

Lists keywords that are topically related to a seed keyword (they share search result URLs), with search volume, CPC, difficulty, intent, and relevance.

  • Cost: 10 credits per keyword returned.
  • Calls GET /v1/keywords/related?source={Regional Database}&keyword={Seed Keyword}&limit={Max Results}.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Seed Keyword (required; default seo): The seed keyword to expand, for example rank tracker.
  • Max Results (required; default 50): The number of keywords to return, from 1 to 1,000. Only one page is read, and each keyword costs 10 credits.
  • See the SE Ranking API reference for the response fields.

List Similar Keywords

Lists keywords similar to a seed keyword, such as synonyms and variations, with search volume, CPC, difficulty, and intent.

  • Cost: 10 credits per keyword returned.
  • Calls GET /v1/keywords/similar?source={Regional Database}&keyword={Seed Keyword}&limit={Max Results}.
  • Regional Database (required; default us): The country code of SE Ranking's regional keyword database, for example us, uk, de, or fr.
  • Seed Keyword (required; default seo): The seed keyword to expand, for example rank tracker.
  • Max Results (required; default 50): The number of keywords to return, from 1 to 1,000. Only one page is read, and each keyword costs 10 credits.
  • See the SE Ranking API reference for the response fields.

Account​

Get Credit Balance

Returns your API subscription's status, start and expiry dates, credit limit (units_limit), and remaining credits (units_left). This template does not use credits.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

SE Ranking data sources can also be manually configured to ingest data from any valid SE Ranking API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new SE Ranking data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination​

Click the + icon on the Nexset that will be sent to the SE Ranking destination, and select the Send to Destination option from the menu. Select the SE Ranking connector from the list of available destination connectors, then select the credential that will be used to connect to your SE Ranking account, and click Next; or, create a new SE Ranking credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common SE Ranking endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

These templates change your SE Ranking account and use your plan's limits. They call the Project API and do not use API credits.

Add Keywords to Project

Adds a keyword to a project's rank tracking for each record. Each keyword counts against your plan's keyword limit.

  • Sends POST /v1/project-management/keywords?site_id={Project ID}.
  • Project ID (required): The ID of the project to add keywords to. Use the List Projects data source template to find it.
  • Each record is sent as a one-item JSON array in the request body, one request per record. Include keyword; group_id, target_url, is_strict, and site_engine_ids are optional.
  • See the SE Ranking API reference for the request fields.

Create Project

Creates a new SE Ranking project for each record. Each project uses one of your plan's project slots.

  • Sends POST /v1/project-management/sites.
  • Each record is sent as the JSON request body, one request per record. Include url and title; depth, check_freq, subdomain_match, exact_url, and site_group_id are optional.
  • See the SE Ranking API reference for the request fields.

Manual configuration​

SE Ranking destinations can also be manually configured to send data to any valid SE Ranking API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Save & activate​

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured SE Ranking endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the SE Ranking endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.