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.
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
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.
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).
Field
Required
Secret
Description
API Key
Yes
Yes
SE 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.
After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Calls GET /v1/project-management/system/search-engines.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.