API

Backlinks

You are reading the Data API docs

Base URL: api.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.

The Backlinks API allows retrieving detailed backlink data for a target domain, host, or URL. It provides statistics such as the number of backlinks, referring domains, subnets, IPs, anchors, top pages, top TLDs, and top countries. The API offers multiple endpoints to access summary metrics, historical data, raw backlink lists, export options, and authority scores.

summary

GET / POST https://api.seranking.com/v1/backlinks/summary

Cost: 100 credits per target

Returns the extended statistics for the target, such as: number of backlinks to the target, number of referring domains, subnets, IPs, top anchors, top TLDs, etc. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for multiple targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’) or use a POST request.

Request parameters

ParameterTypeRequiredDefaultDescriptionExample
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain), or URL.seranking.com
modeStringNohostMode of operation:
– domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.
– host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).
– url (http://www.example.com/) – analysis will be done for the particular URL only.
domain
outputStringNojsonOutput format:
– json – get response in JSON format.
– xml – get response in XML format.
json

Request examples

To receive information about a single target:

Copy
curl -X GET 'https://api.seranking.com/v1/backlinks/summary?target=rubyonrails.org&mode=host&output=json' \
-H 'Authorization: Token YOUR_API_KEY'

To receive information about multiple targets:

Copy
 curl -X GET 'https://api.seranking.com/v1/backlinks/summary?target=https://www.seranking.com&target=https://www.seranking.com&mode=url&output=json' \
-H 'Authorization: Token YOUR_API_KEY'

To receive information about multiple targets:

Copy
curl -X POST \
'https://api.seranking.com/v1/backlinks/summary?output=json' \
-H 'Authorization: Token YOUR_API_KEY' \
-d '{
"target": [
"https://www.seranking.com/",
"https://www.seranking.com/"
],
"mode": "host"
}'

Please note that the apikey (optional) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription

target

String

Aim of the request: root domain, host, or URL (e.g., seranking.com).
backlinksIntegerTotal number of live backlinks (e.g., 10000).
refdomainsIntegerNumber of unique domains linking to a target (e.g., 1000).
subnetsIntegerNumber of unique subnets / C-blocks linking to a target (e.g., 50).
ipsIntegerNumber of unique IPs linking to a target (e.g., 80).
nofollow_backlinksIntegerNumber of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag (e.g., 100).
dofollow_backlinksIntegerNumber of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag (e.g., 900).
from_home_page_backlinksIntegerNumber of backlinks coming from a home page of the referring domain (e.g., 40).
dofollow_from_home_page_backlinksIntegerNumber of ‘dofollow’ backlinks, which come from a home page of the referring domain (e.g., 40).
text_backlinksIntegerNumber of backlinks that use text as an anchor (e.g., 750).
edu_backlinksIntegerNumber of backlinks coming from .edu domains (e.g., 0).
gov_backlinksIntegerNumber of backlinks coming from .gov domains (e.g., 1).
inlink_rankIntegerInLink Rank (Page Authority) of the target URL (e.g., 21).
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the target’s root domain (e.g., 68).
dofollow_refdomainsIntegerNumber of referring domains with at least one ‘dofollow’ link pointing to the target (e.g., 40).
from_home_page_refdomainsIntegerNumber of referring domains with at least backlink coming from a home page of the domain (e.g., 40).
edu_refdomainsIntegerNumber of .edu referring domains (e.g., 40).
gov_refdomainsIntegerNumber of .gov referring domains (e.g., 40).
anchorsIntegerTotal number of unique anchor texts being used within all backlinks pointing to the target (e.g., 50).
dofollow_anchorsIntegerTotal number of unique anchor texts being used within ‘dofollow’ backlinks pointing to the target (e.g., 40).
pages_with_backlinksIntegerTotal number of linked pages belonging to the target (e.g., 500).
top_anchors_by_backlinksArrayArray of the top anchor text and the number of backlinks with this anchor.
top_anchors_by_backlinks.anchorStringAnchor text used in backlinks (e.g., SE Ranking).
top_anchors_by_backlinks.backlinksStringNumber of backlinks found that are using the anchor (e.g., 40).
top_anchors_by_refdomainsArrayArray of the top anchor text and the number of referring domains with this anchor.
top_anchors_by_refdomains.anchorStringAnchor text used in backlinks (e.g., SE Ranking).
top_anchors_by_refdomains.refdomainsStringNumber of referring domains with at least one backlink using the anchor (e.g., 40).
top_pages_by_backlinksArrayArray of the top linked pages belonging to the target and the number of backlinks pointing to this page.
top_pages_by_backlinks.urlStringURL of the page (e.g., https://target.com/page.html).
top_pages_by_backlinks.backlinksIntegerNumber of backlinks pointing to this page (e.g., 24).
top_pages_by_refdomainsArrayArray of the top linked pages belonging to the target URLs and the number of unique referring domains pointing to this page.
top_pages_by_refdomains.refdomainsIntegerNumber of referring domains pointing to this page (e.g., 20).
top_pages_by_refdomains.urlStringURL of the page (e.g., https://target.com/page.html).
top_tldsArrayArray of the top TLDs which have backlinks pointing to the target.
top_tlds.tldStringTLD (top-level domain) (e.g., .com).
top_tlds.countIntegerNumber of backlinks from the TLD pointing to the target (e.g., 700).
top_countriesArrayArray of the top countries which have backlinks pointing to the target.
top_countries.countryStringCountry code (e.g., Us).
top_countries.countIntegerNumber of backlinks from the specified country pointing to the target (e.g., 600).

Response example

Copy
{
  "summary": [
    {
      "target": "seranking.com",
      "backlinks": 22407,
      "refdomains": 2329,
      "subnets": 1403,
      "ips": 1961,
      "nofollow_backlinks": 3718,
      "dofollow_backlinks": 18689,
      "edu_backlinks": 40,
      "gov_backlinks": 0,
      "inlink_rank": 24,
      "domain_inlink_rank": 68,
      "from_home_page_backlinks": 88,
      "dofollow_from_home_page_backlinks": 60,
      "text_backlinks": 21427,
      "dofollow_refdomains": 1291,
      "from_home_page_refdomains": 64,
      "edu_refdomains": 6,
      "gov_refdomains": 0,
      "anchors": 720,
      "dofollow_anchors": 522,
      "pages_with_backlinks": 87,
      "top_anchors_by_backlinks": [
        {"anchor": "SE Ranking","backlinks": 1853},
        {"anchor": "social listening","backlinks": 1542},
        {"anchor": "seranking.com","backlinks": 1209},
        {"anchor": "Buy SE Ranking tools - place secure order online","backlinks": 1157},
        {"anchor": "Search Engine Optimization","backlinks": 890},
        {"anchor": "the website","backlinks": 872},
        {"anchor": "SEO","backlinks": 864},
        {"anchor": "search bar (I’ve","backlinks": 849},
        {"anchor": "the site","backlinks": 836},
        {"anchor": "search bar (I have actually","backlinks": 831}
      ],
      "top_anchors_by_refdomains": [
        {"anchor": "SE Ranking","refdomains": 454},
        {"anchor": "seranking.com","refdomains": 192},
        {"anchor": "SE Ranking","refdomains": 155},
        {"anchor": "https://www.seranking.com/","refdomains": 116},
        {"anchor": "SE Ranking Pro","refdomains": 111},
        {"anchor": "seranking","refdomains": 106},
        {"anchor": "SEO software tools for results-driven site owners.","refdomains": 66},
        {"anchor": "","refdomains": 64},
        {"anchor": "SEO software tools for results-driven site owners","refdomains": 56},
        {"anchor": "Go Now","refdomains": 44}
      ],
      "top_pages_by_backlinks": [
        {"url": "https://www.seranking.com/","backlinks": 16724},
        {"url": "http://seranking.com/","backlinks": 1932},
        {"url": "https://www.seranking.com/buy.html","backlinks": 1188},
        {"url": "http://www.seranking.com/","backlinks": 900},
        {"url": "https://www.seranking.com/rank-tracker/","backlinks": 356}
      ],
      "top_pages_by_refdomains": [
        {"url": "https://www.seranking.com/","refdomains": 1235},
        {"url": "http://www.seranking.com/","refdomains": 236},
        {"url": "http://seranking.com/","refdomains": 221},
        {"url": "https://www.seranking.com/rank-tracker/","refdomains": 172},
        {"url": "https://www.seranking.com/site-audit/","refdomains": 88}
      ],
      "top_tlds": [
        {"tld": "com","count": 1183},
        {"tld": "pw","count": 112},
        {"tld": "net","count": 96},
        {"tld": "org","count": 65},
        {"tld": "it","count": 63}
      ],
      "top_countries": [
        {"country": "us","count": 1140},
        {"country": "co","count": 166},
        {"country": "sg","count": 124},
        {"country": "de","count": 87},
        {"country": "gb","count": 84}
      ]
    }
  ]
}

metrics

GET / POST https://api.seranking.com/v1/backlinks/metrics

Cost: 100 credits per target

Returns key statistics for a target such as: number of backlinks to the target, number of referring domains, etc. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’) or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain), or URL.seranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

To receive information about a single target:

Copy
GET: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX
&target=https://www.seranking.com&mode=url&output=json

To receive information about multiple targets:

Copy
GET: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX
&target=https://www.seranking.com&target=https://www.seranking.com&mode=url&output=json

To receive information about multiple targets:

Copy
POST: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/",
    "https://www.seranking.com/"
  ],
  "mode": "url"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
targetStringAim of the request: root domain, host, or URL.seranking.com
backlinksIntegerTotal number of live backlinks.10000
refdomainsIntegerNumber of unique domains linking to a target.1000
ipsIntegerNumber of unique IPs linking to a target.80
subnetsIntegerNumber of unique subnets / C-blocks linking to a target.50
nofollow_backlinksIntegerNumber of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag.100
dofollow_backlinksIntegerNumber of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag.900
gov_backlinksIntegerNumber of backlinks coming from .gov domains1
edu_backlinksIntegerNumber of backlinks coming from .edu domains.0

Response example

Copy
{
  "metrics": [
    {
      "target": "seranking.com",
      "backlinks": 22402,
      "refdomains": 2325,
      "subnets": 1399,
      "ips": 1957,
      "nofollow_backlinks": 3717,
      "dofollow_backlinks": 18685,
      "edu_backlinks": 40,
      "gov_backlinks": 0
    }
  ]
}

all

GET / POST https://api.seranking.com/v1/backlinks/all

Cost: 1 credit per target

Returns information about backlinks pointing to a target.

Note: The inlink_rank value in the response is based on background-processed data. It can be up to one month behind the real-time value shown in the /backlinks/authority method.

The command supports both GET and POST requests, but doesn’t allow making batch requests and accepts only a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain), or URL.seranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
per_domainIntegerNoN/ANumber of backlinks per referring domain to be provided in the response.Passing an empty parameter will return all backlinks (even if there are more than 100). Should be within [1; 100].1
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json
order_byStringNodate_foundThe field by which the results will be sorted in the response:date_found – returns the most recent (new) backlinks first.domain_inlink_rank – returns backlinks with the highest Domain InLink Rank first.inlink_rank – returns backlinks with the highest InLink Rank first.date_found
inlink_rank_fromIntegerNo0InLink Rank minimum value. Return backlinks with InLink Rank greater than or equal to the field value. Should be within [0; 100].10
inlink_rank_toIntegerNo100InLink Rank maximum value. Return backlinks with InLink Rank less than or equal to the field value. Should be within [0; 100].90
domain_inlink_rank_fromIntegerNo0Domain InLink Rank minimum value. Return backlinks with Domain InLink Rank greater than or equal to the field value. Should be within [0; 100].32
domain_inlink_rank_toIntegerNo100Domain InLink Rank maximum value. Return backlinks with Domain InLink Rank less than or equal to the field value. Should be within [0; 100].56
url_from_filterStringNoN/AText for url_from parameter filter. Maximum 2063 ascii symbols.seo-software
url_from_filter_modeStringNocontainsUrl_from filter mode. Allowedvalues:contains – return backlinks with url_from parameter that contains url_from_filter text value.does_not_contain – return backlinks with url_from parameter that does not contain url_from_filter text value.Filter is not applied in case url_from_filter parameter is not setdoes_not_contain
url_to_filterStringNoN/AText for url_to parameter filter. Maximum 2063 ascii symbols.seopowersuite.com/news/
url_to_filter_modeStringNocontainsUrl_to filter mode. Allowed values:contains – return backlinks with url_to parameter that contains url_to_filter text value.does_not_contain – return backlinks with url_to parameter that does not contain url_to_filter text value.Filter is not applied in case url_to_filter parameter is not setcontains
anchor_filterStringNoN/AText for anchor parameter filter. Maximum 2063 ascii symbols.seo
anchor_filter_modeStringNocontainsAnchor filter mode. Allowed values:contains – return backlinks with anchor parameter that contains anchor_filter text value.does_not_contain – return backlinks with anchor parameters that do not contain anchor_filter text value.Filter is not applied in case anchor _filter parameter is not setcontains
nofollow_filterStringNoN/ANofollow filter. Allowed values:nofollow_only – return backlinks with nofollow attributedofollow_only – return href backlinks without nofollow attributePassing an empty parameter will return all backlinksdofollow_only

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/all?apikey=XXX&target= seranking.com&mode=domain&limit=100&order_by=inlink_rank&per_domain=1&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/all?apikey=XXX&output=json

{
  "target": "https://www.seranking.com/",
  "order_by": "date_found",
  "mode": "domain",
  "limit": 10,
  "per_domain": 1
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
url_fromStringReferring page’s URLhttp://seo.jouwlinkhier.nl/
url_toStringDestination page’s URLhttps://www.seranking.com/
titleStringReferring page’s titleinformatie over seo
anchorStringLink anchor text for text links.Image alt text for image links.Rank Tracker
altStringDeprecated, not used“”
nofollow_backlinksBooleanIs set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tagfalse
imageBooleanIs set to true if the html <a> tag from which the link was extracted includes an imagefalse
image_sourceStringSource URL of the image (for image links)https://podnova.com/img/sps.jpg
inlink_rankIntegerInLink Rank (Page Authority) of the referring page’s URL21
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the referring page’s root domain68
first_seenDateDate when the backlink was discovered and added to the index2016-10-26
last_visitedDateDate when our crawlers last visited the referring page2019-01-08

Response example

Copy
{
  "backlinks": [
    {
      "url_from": " https://zoekmachine-optimalisatie-seo.beginthier.nl/",
      "url_to": " https://www.seranking.com/",
      "title": "Zoekmachine Optimalisatie (SEO)",
      "anchor": "SEO software tools",
      "alt": "",
      "nofollow": false,
      "image": false,
      "image_source": "",
      "inlink_rank": 67,
      "domain_inlink_rank": 77,
      "first_seen": "2021-11-05",
      "last_visited": "2023-06-01"
    },
    {
      "url_from": " https://zoekmachine-optimalisatie.verzamelgids.nl/",
      "url_to": " https://www.seranking.com/",
      "title": "Zoekmachine Optimalisatie (SEO)",
      "anchor": "SEO software tools",
      "alt": "",
      "nofollow": false,
      "image": false,
      "image_source": "",
      "inlink_rank": 66,
      "domain_inlink_rank": 75,
      "first_seen": "2021-11-12",
      "last_visited": "2023-06-01"
    }
  ]
}

raw

GET https://api.seranking.com/v1/backlinks/raw

Cost: 1 credit per target

Returns information about all backlinks pointing to a target in batches using a cursor-based pagination approach. This method supports pagination but doesn’t offer any ordering or filtering possibilities.

Unlike the backlinks/all method (which supports sorting/ordering and is most commonly used to quickly get top backlinks by InLink Rank or to get most recent backlinks), this method is aimed to fetch backlinks in batches – one batch after another. It uses an approach called “cursor-based pagination,” which is the most efficient method of paging. A cursor refers to a random string of characters which marks a specific item in a list of data. Unless this item is deleted, the cursor always points to the same part of the list but is invalidated if an item is removed. Therefore, you may assume that they will be valid within the next 24 hours, even if new items are added to the list in-between requests.

This cursor-paginated method supports the next parameter which is being used as a cursor that will return the next page of data.

Note: The next parameter mustn’t be included in the request when asking for the first page of data (you’ll get an error if it is). If the next parameter is not included in the response, this is the last page of data. Stop paging when the next cursor no longer appears.

This command supports GET requests only (POST is not supported for this command).

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
limitIntegerNo10,000Maximum number of results to return on one page. Should be within [1; 100,000].10
nextStringNoN/AThe cursor that points to the end of the page of data that has been returned. – Must NOT be present among the request parameters if the request to get backlinks to a new target is being made for the first time. – Will NOT be returned in response for the last page of data (if no more backlinks to the target exist).uaputGo_eWXvSEWZCpBxgAW
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json
order_byStringNodate_foundThe field by which the results will be sorted in the response:date_found – returns the most recent (new) backlinks first.domain_inlink_rank – returns backlinks with the highest Domain InLink Rank first.inlink_rank – returns backlinks with the highest InLink Rank first.date_found
per_domainIntegerNoN/ANumber of backlinks per referring domain to be provided in the response. Passing an empty parameter will return all backlinks (even if there are more than 100). Should be within [1; 100].1

Request example

Copy
GET: https://api.seranking.com/v1/backlinks/raw?apiKey=XXX&target=seranking.com&mode=domain&limit=50000&output=json&next=YYY

Response parameters

ParameterTypeDescriptionExample
url_fromStringReferring page’s URLhttp://seo.jouwlinkhier.nl/
url_toStringDestination page’s URLhttps:// seranking.com/rank-tracker/
titleStringReferring page’s titleinformatie over seo
anchorStringLink anchor text for text links.Image alt text for image links.Rank Tracker
altStringNot used.“”
nofollow_backlinksBooleanIs set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tagfalse
imageBooleanIs set to true if the html <a> tag from which the link was extracted includes an imagefalse
image_sourceStringThe source URL of the image (for image links)https:// podnova.com/img/sps.jpg
inlink_rankIntegerInLink Rank (Page Authority) of the referring page’s URL21
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the referring page’s root domain68
first_seenDateThe date when the backlink was discovered and added to the index2016-10-26
last_visitedDateThe date when our crawlers last visited the referring page2019-01-08
nextStringThe cursor that points to the end of the page of data that has been returned.Must NOT be present among the request parameters if the request to get backlinks to a new target is being made for the first time. Will NOT be returned in response for the last page of data (if no more backlinks to the target exist).a8RMaGJNHWemdJkYq

Response examples (sample flow)

Step 1

Send a request to get the very first page of data for the target (the example below will return the first 1,000 backlinks to the domain seranking.com):

Copy
GET: https://api.seranking.com/v1/backlinks/raw?apiKey=XXX&target=seranking.com&mode=domain&limit=2&output=json

Important: Do NOT send the next parameter when making a request for the first batch of data – if you do, an error will be returned.

Copy
{
  "backlinks": [
    {
      "url_from": "https://www.pbmug.org/efficient-backlinks-checking.html",
      "url_to": "https://seranking.com/backlinks-checker.html",
      "title": "Backlinks Checker ",
      "anchor": "",
      "alt": "",
      "nofollow": false,
      "image": false,
      "image_source": "",
      "inlink_rank": 16,
      "domain_inlink_rank": 45,
      "first_seen": "2021-05-06",
      "last_visited": "2021-05-06"
    },
    {
      "url_from": "https://www.pbmug.org/seranking-enterprise-6-40-8.html",
      "url_to": "https:// seranking.com/themes/standard/images/index-scr-3-big.png",
      "title": "The best SEO software - Pbmug.org",
      "anchor": "",
      "alt": "",
      "nofollow": false,
      "image": false,
      "image_source": "",
      "inlink_rank": 15,
      "domain_inlink_rank": 45,
      "first_seen": "2021-05-06",
      "last_visited": "2021-05-06"
    }
  ],
  "next": "ezDLWp6Peqx6tE77/mV9XtWGP92lrdwTI3ZZ2b24ZPMXA/NpRCJm45biWgPerwN_0uqT9iHmZTYjeS2VRiNL7ySiFgV0KFGv9O9Y="
}

Step 2

Get the next page of data. Use the next parameter that was returned in Step 1.

Copy
GET: https://api.seranking.com/v1/backlinks/raw?apiKey=XXX&target=seranking.com&mode=domain&limit=2&output=json&next=ezDLWp6Peqx6tE77/mV9XtWGP92lrdwTI3ZZ2b24ZPMXA/NpRCJm45biWgPerwN_0uqT9iHmZTYjeS2VRiNL7ySiFgV0KFGv9O9Y=
Copy
{
  "backlinks": [
    {
      "url_from": "https://fity.club/lists/1/seo-software-tools-for-resultsdriven-site-owners/",
      "url_to": "https://cdn.seranking.com/themes/standard/images/works-on.png",
      "title": "Seo Software Tools For Resultsdriven Site Owners",
      "anchor": "seranking.com",
      "alt": "",
      "nofollow": true,
      "image": false,
      "image_source": "",
      "inlink_rank": 9,
      "domain_inlink_rank": 13,
      "first_seen": "2023-08-07",
      "last_visited": "2023-08-07"
    },
    {
      "url_from": "https://www.bjskqx.com/11043.html",
      "url_to": "https://cn.seranking.com/seranking.html",
      "title": "seo外链发布有用吗,seo外链发布平台有哪些-帮发锚文本外链网",
      "anchor": "SE Ranking",
      "alt": "",
      "nofollow": false,
      "image": false,
      "image_source": "",
      "inlink_rank": 15,
      "domain_inlink_rank": 38,
      "first_seen": "2023-07-08",
      "last_visited": "2023-07-08"
    }
  ],
  "next": "sPpKCdfMEKN5zO3RsuyEZIMp7wHaJF5wuT/1tebFkazXfosEFuotIQYeHxV/beypHQ3a9DHFgCkNnh_f0cP9EoHBtcyYFuGA=="
}

Step 3

Iterate until no next parameter is returned – it means this is the last page of data.

count

GET / POST https://api.seranking.com/v1/backlinks/count

Cost: 10 credits per target

Returns the number of backlinks for the target. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format.
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/count?apikey=a9c5a917-d645-470a-96b0-8f2436ed2078&target=seranking.com&target=seranking.commode=host&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/count?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/",
    "https://www.seranking.com/"
  ],
  "mode": "host"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
targetStringAim of the request: root domain, host, or URLseranking.com
backlinksIntegerTotal number of live backlinks10000

Response example

Copy
{
  "metrics": [
    {
      "target": "seranking.com",
      "backlinks": 22402
    },
    {
      "target": "www.seranking.com",
      "backlinks": 341415
    }
  ]
}

export

GET https://api.seranking.com/v1/backlinks/export

Cost: 1 credit per target

Retrieves large-scale backlinks and returns information about all backlinks pointing to a target. Due to the high volume of data to process, this command will always work asynchronously with results being made available as a downloadable .GZ compressed CSV file.

Note: This command supports GET requests only (POST is not supported for this command).

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request example

Copy
GET: https://api.seranking.com/v1/backlinks/export?apikey=XXX&target=https://seranking.com&mode=domain&output=json

Response parameters

ParameterTypeDescriptionExample
task_statusStringStatus of the CSV file preparation task. One ofqueued_for_processing – the task successfully started preparing the requested data.processing – the task is running.complete – the task successfully prepared the data, you can start downloading the CSV file.rejected – the task cannot be started due to the fact that the previous task is being still processed by the system and hasn’t been finished yet. Please wait for the previous task to complete.task id is unknown or deleted – the task with the requested ID is unknown or you don’t have access to it. You should only ask for the status of those tasks which have been previously queued for processing.queued_for_processing
task_idStringThe id of the CSV file preparation task602c775d-760d-46ba-bfaf-005a6b37ac4e
download_fileStringThe location of the CSV file with the requested data, ready for downloadhttps://api.seranking.com/export/c/seranking.com-1572280448369.csv.gz 

Response examples (sample flow)

Step 1

Formulate the request for downloading a list of all backlinks for the target and put it into an execution queue:

https://api.seranking.com/v1/backlinks/export?apikey=XXX&target=http://seranking.com&mode=domain&output=json

Copy
{
  "task_status": "queued_for_processing",
  "task_id": "d1d2bb44-6c66-4791-a634-26103551e2da"
}

Step 2

Check if the data you’ve requested is ready. Use the task_id that was returned in Step 1.

Copy
GET: https://api.seranking.com/v1/backlinks/export/status?apikey=XXX&task_id=d1d2bb44-6c66-4791-a634-26103551e2da&output=json
Copy
{
  "task_status": "complete",
  "task_id": "d1d2bb44-6c66-4791-a634-26103551e2da",
  "download_file": "http://116.202.112.205/export/b/seranking.com-1695672292259.csv.gz"
}

Step 3

Fetch your CSV file with the data requested by simply accessing it at the location returned in the download_file parameter:

Copy
GET: https://api.seranking.com/export/c/seranking.com-1572280448369.csv.gz

history

GET / POST https://api.seranking.com/v1/backlinks/history

Cost: 1 credit per target

Returns a list of backlinks (newly) found or lost within the specified date range for the specified target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain), or URL.seranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
new_lost_typeStringNo“”Indicates whether the backlink is new or lost:new – returns fresh backlinks that were tagged as new.lost – returns backlinks that were tagged as lost.Passing an empty parameter will return both new and lost backlinks.new
date_fromDateNoyesterdayStart date in “YYYY-MM-DD” format (inclusive range).2019-03-01
date_toDateNocurrent day (today)End date in “YYYY-MM-DD” format (inclusive range).2019-04-01
link_typeStringNo“”Type of the backlink. One ofhrefredirectPassing an empty parameter will return all types of backlinks.href
anchor_typeStringNo“”Identifies whether the backlink is a text or image link. One of:textimageundefined””Note: If anchor text consists of both text and an image, the backlink’s anchor type will be set to “image”. Passing an empty parameter will return backlinks with any anchor type.text
dofollowStringNo“”Identifies whether the backlink is dofollow or nofollow. One ofdofollownofollowundefinedPassing an empty parameter will return all types of backlinks.dofollow
url_fromStringNo“”Allows to get a list of backlinks with Referring Page URLs that belong to this domain, including its subdomains.Passing an empty parameter will return backlinks from all domains/subdomains.Example: http://seo.jouwlinkhier.nl/path will return backlinks pointing from *seo.jouwlinkhier.nl/*text
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
order_byStringNonew_lost_dateThe field by which the results will be sorted in the response:new_lost_date – returns new/lost backlinks in order of being found or lost (starting from the most recent ones).domain_inlink_rank – returns backlinks with the highest Domain InLink Rank first.inlink_rank – returns backlinks with the highest InLink Rank first.new_lost_date
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/history?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2023-01-15&date_to=2023-01-15&link_type=href&anchor_type=text&dofollow=dofollow&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/history?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2019-01-14&date_to=2019-08-28&link_type=href&anchor_type=text&dofollow=dofollow&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/history?apikey=XXX&output=json

{
  "target": "https://www.seranking.com",
  "mode": "domain",
  "date_from": "2023-01-15",
  "date_to": "2023-01-15"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
new_lost_dateDateThe date when the link was found or lost2022-10-26
new_lost_typeStringIndicates whether the backlink is new or lost:new – returns fresh backlinks that were tagged as newlost – returns backlinks that were tagged as lostnew
url_fromStringReferring page’s URLhttp://seo.jouwlinkhier.nl/
url_toStringDestination page’s URLhttps:// seranking.com/rank-tracker/
titleStringReferring page’s titleinformatie over seo
anchorStringLink anchor text for text links.Image alt text for image links.Rank Tracker
altStringDeprecated. Not used.“”
link_typeStringType of backlink. href – the link was parsed from the href attribute within the page.redirect – a link derived from a redirect HTTP header.href
nofollow_backlinksBooleanIs set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tagfalse
imageBooleanIs set to true if the html <a> tag from which the link was extracted includes an imagefalse
image_sourceStringThe source URL of the image (for image links)https://podnova.com/img/sps.jpg
reason-lostStringThe reason why the backlink’s status was changed from live to lost. One of:page_not_found – the referring page returned a 404 status code during the re-crawl.crawl_error – a fetching error occurred during the re-crawl of the referring page (this is different from a 404 code).page_dropped – the referring page was removed (dropped) from our index for some reason (e.g., we consider it untrustworthy and/or poorly rated).redirect – the referring page returned a 3XX status code during the re-crawl.not_canonical – the canonical link on the referring page now sends the crawler to another page.noindex – the referring page has included a noindex meta tag in its HTML code or returned a noindex HTTP response header.link_removed – the crawler didn’t find the backlink on the referring page; or the redirect which we considered to be a backlink no longer exists.broken_redirect – the crawler failed to identify the type of redirect.other – any other reason not covered by the cases above (e.g., non-categorized internal errors).page_not_found
inlink_rankIntegerInLink Rank (Page Authority) of the referring page’s URL21
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the referring page’s root domain68
first_seenDateThe date when the backlink was discovered and added to the index2016-10-26

Response example

Copy
{
  "new_lost_backlinks": [
    {
      "new_lost_date": "2023-01-15",
      "new_lost_type": "new",
      "url_from": "https://agenciatgx.com.br/blog/melhores-ferramentas-de-seo-para-otimizar/",
      "url_to": "http://www.seranking.com/",
      "title": "Melhores Ferramentas de SEO Para Otimizar o Desempenho do Seu Site - Agência TGX",
      "anchor": "SE Ranking",
      "alt": null,
      "link_type": "href",
      "nofollow": false,
      "image": false,
      "image_source": null,
      "redirect_chain": false,
      "redirect_chain_urls": [],
      "reason_lost": null,
      "inlink_rank": 1,
      "domain_inlink_rank": 18,
      "first_seen": "2023-01-15"
    },
    {
      "new_lost_date": "2023-01-15",
      "new_lost_type": "lost",
      "url_from": "http://technicalproducts.org/category/seoandperformance",
      "url_to": "https://www.seranking.com/",
      "title": "SEO & Performance – Technical Products",
      "anchor": "SE Ranking",
      "alt": null,
      "link_type": "href",
      "nofollow": false,
      "image": false,
      "image_source": null,
      "redirect_chain": false,
      "redirect_chain_urls": [],
      "reason_lost": "link_removed",
      "inlink_rank": 1,
      "domain_inlink_rank": 1,
      "first_seen": "2023-01-15"
    }
  ]
}

history/count

GET / POST https://api.seranking.com/v1/backlinks/history/count

Cost: 100 credits per target

Returns a number of (newly) found or lost backlinks for every day within the specified date range for the specified target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
new_lost_typeStringNo“”Indicates whether the count for new or lost backlinks should be returned:new – returns the number of fresh backlinks that were tagged as new.lost – returns the number of backlinks that were tagged as lost.Passing an empty parameter will return the number of both new and lost backlinks.new
date_fromDateNoyesterdayStart date in “YYYY-MM-DD” format (inclusive range).2019-03-01
date_toDateNocurrent day (today)End date in “YYYY-MM-DD” format (inclusive range).2019-04-01
link_typeStringNo“”Type of backlinks to be counted. One of:hrefredirectPassing an empty parameter will count backlinks of all types.href
anchor_typeStringNo“”Identifies whether text or image backlinks must be counted. One of:textimageundefined””Note: if anchor text consists of both text and an image, the backlink’s anchor type will be set to “image”. Passing an empty parameter will count backlinks with any anchor type.text
dofollowStringNo“”Identifies whether dofollow, nofollow, or undefined backlinks must be counted. One ofdofollownofollowundefinedPassing an empty parameter will count all types of backlinks.dofollow
url_fromStringNo“”Allows to get a number of backlinks with Referring Page URLs that belong to this domain, including its subdomains.Passing an empty parameter will return the number of backlinks from all domains/subdomains.Example: http://seo.jouwlinkhier.nl/path will return the number of backlinks pointing from *seo.jouwlinkhier.nl/*text
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format.
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/history/count?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2019-01-14&date_to=2019-01-16&link_type=href&anchor_type=text&dofollow=dofollow&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/history/count?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2019-01-14&date_to=2019-01-16&link_type=href&anchor_type=text&dofollow=dofollow&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/history/count?apikey=XXX&output=json

{
  "target": "https://www.seranking.com",
  "mode": "domain",
  "date_from": "2023-01-15",
  "date_to": "2023-01-15"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
dateDateParticular date for which new or lost backlinks have been counted.2022-10-26
newIntegerNumber of new backlinks that were found at that date and match the filters specified in the request parameters25
lostIntegerNumber of backlinks that were lost at that date and match the filters specified in the request parameters 25

Response example

Copy
{
  "new_lost_backlinks_count": [
    {
      "date": "2023-01-16",
      "new": 5,
      "lost": 0
    },
    {
      "date": "2023-01-15",
      "new": 5,
      "lost": 0
    }
  ]
}

history/cumulative

GET / POST https://api.seranking.com/v1/backlinks/history/cumulative

Cost: 100 credits per target

Returns a number of live backlinks for every day within the specified date range for the specified target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: only full page URL is supported.http://seranking.com/index.html
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
date_fromDateNoyesterdayStart date in “YYYY-MM-DD” format (inclusive range).2019-03-01
date_toDateNocurrent day(today)End date in “YYYY-MM-DD” format (inclusive range).2019-04-01
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/history/cumulative?apikey=XXX&target=https://www.seopowersuite.com&mode=domain&date_from=2019-01-14&date_to=2019-01-16&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/history/cumulative?apikey=XXX&target=https://seopowersuite.com&mode=domain &date_from=2023-01-14&date_to=2023-01-16&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/history/cumulative?apikey=XXX&output=json

{
"target": "https://www.seopowersuite.com",
"mode": "domain",
"date_from": "2023-01-15",
"date_to": "2023-01-15"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
dateDateThe date of the corresponding domain rank value.For by_week granularity – the first day of the corresponding week (Monday).For by_month granularity – the first day of the corresponding month.For by_day granularity – the day the rank is calculated.In the response, the first result should be the first day of the requested range, followed by the data according to the requested granularity.2022-10-26
backlinksIntegerNumber of live backlinks that were live at that date and match the filters specified in the request parameters.68

Response example

Copy
{
"backlinks_count": [
{
"date": "2023-01-16",
"backlinks": 5,
},
{
"date": "2023-01-15",
"backlinks": 5,
}]
}

anchors

GET / POST https://api.seranking.com/v1/backlinks/anchors

Cost: 1 credit per target

Returns information about the anchor texts of backlinks that point to a target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
order_byStringNobacklinksThe field by which the results will be descending sorted by in the response:backlinks – total number of backlinks that are using an anchor text.refdomains – total number of referring domains that are using an anchor text.backlinks
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
https://api.seranking.com/v1/backlinks/anchors?apikey=XXX&target=https://seranking.com&mode=domain&limit=2&order_by=backlinks&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/anchors?apikey=XXX&target=https://seranking.com&mode=domain&limit=2&order_by=backlinks&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/anchors?apikey=XXX&output=json

{
  "target": "https://www.seranking.com/",
  "order_by": "backlinks",
  "mode": "domain",
  "limit": 2
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
anchorStringText of an anchor. May be empty. Case sensitive.SE Ranking
backlinksIntegerA total number of backlinks that are using anchor text. Always greater than zero.10000
refdomainsIntegerTotal number of referring domains that are using an anchor text. Always greater than zero.50
nofollow_backlinksIntegerNumber of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag100
dofollow_backlinksIntegerNumber of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag900
first_seenDateThe date of the earliest backlink with the anchor pointing to the target in the index.2016-10-26
last_visitedDateThe last date when the backlink with the anchor pointing to the target was seen.2019-01-08

Response example

Copy

   "anchors": [ 
        { 
            "anchor": "SE Ranking", 
            "backlinks": 1844, 
            "refdomains": 445, 
            "dofollow_backlinks": 1595, 
            "nofollow_backlinks": 249, 
            "first_seen": "2016-12-07", 
            "last_visited": "2023-10-19" 
        }, 
        { 
            "anchor": "social listening", 
            "backlinks": 1542, 
            "refdomains": 7, 
            "dofollow_backlinks": 1542, 
            "nofollow_backlinks": 0, 
            "first_seen": "2020-04-30", 
            "last_visited": "2022-04-01" 
        } 
    ] 
}

refdomains

GET / POST https://api.seranking.com/v1/backlinks/refdomains

Cost: 1 credit per target

Returns information about the referring domains pointing to a target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
order_byStringNodate_foundThe field by which the results will be sorted in the response:date_found – returns most recent (new) referring domains/hosts first.domain_inlink_rank – returns domains/hosts with the highest Domain InLink Rank first.inlink_rank – returns domains/hosts with the highest InLink Rank of its home page first.date_found
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format.
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/refdomains?apikey=XXX&target=seranking.com&mode=domain&limit=2&order_by=inlink_rank&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/refdomains?apikey=XXX&output=json

{
 "target":"seranking.com",
 "mode":"domain",
 "limit":2
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
refdomainStringThe name of the referring domainfrashmi.net
backlinksIntegerTotal number of backlinks pointing to the target from this domain68
dofollow_backlinksIntegerNumber of backlinks from this domain that are NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag900
first_seenDateThe date when the oldest live backlink coming from this domain was found2016-10-26
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the referring domain68

Response example

Copy

    "refdomains": [ 
        { 
            "refdomain": "daveyandkrista.com", 
            "backlinks": 1, 
            "dofollow_backlinks": 1, 
            "first_seen": "2022-06-30", 
            "domain_inlink_rank": 73 
        }, 
        { 
            "refdomain": "isearch.avg.com", 
            "backlinks": 72, 
            "dofollow_backlinks": 72, 
            "first_seen": "2019-02-22", 
            "domain_inlink_rank": 90 
        } 
    ] 
}

refdomains/count

GET / POST https://api.seranking.com/v1/backlinks/refdomains/count

Cost: 10 credits per target

Returns the number of unique domains linking to a target. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/refdomains/count?apikey=XXX&target=seranking.com&mode=domain&output=json

To receive information about a single target:

Copy
GET: https://api.seranking.com/v1/backlinks/refdomains/count?apikey=XXX&target=https://www.seranking.com&target=https://www.seranking.com&mode=url&output=json

To receive information about multiple targets:

Copy
POST: https://api.seranking.com/v1/backlinks/refdomains/count?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/"
  ],
  "mode": "domain"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
targetStringAim of the request: root domain, host, or URLseranking.com
refdomainsIntegerNumber of unique domains linking to a target 1000

Response example

Copy
{
  "metrics": [
    {
      "target": "seranking.com",
      "refdomains": 50234
    }  
]
}

refdomains/history

GET / POST https://api.seranking.com/v1/backlinks/refdomains/history

Cost: 1 credit per target

Returns a list of referring domains, at least one backlink from which was (newly) found or lost in the specified date range for the specified target. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
new_lost_typeStringNo“”Indicates whether the refdomain is new or lost:new – returns referring domains, at least one backlink from which was newly found.lost – returns referring domains, at least one backlink from which was tagged as lost.Passing an empty parameter will return both new and lost refdomains.new
date_fromDateNoyesterdayStart date in “YYYY-MM-DD” format (inclusive range).2019-03-01
date_toDateNocurrent day (today)End date in “YYYY-MM-DD” format (inclusive range).2019-04-01
order_byStringNonew_lost_dateThe field by which the results will be sorted in the response:new_lost_date – returns new/lost refdomains in order of being found or lost (starting from the most recent ones).domain_inlink_rank – returns backlinks with the highest Domain InLink Rank first.inlink_rank – returns backlinks with the highest InLink Rank first.new_lost_date
limitIntegerNo100Maximum number of results to return. Should be within[1; 10,000].10
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/refdomains/history?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2023-01-15&date_to=2023-01-16&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/refdomains/history?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2023-01-15&date_to=2023-01-16&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/refdomains/history?apikey=XXX&output=json

{
  "target": "https://www.seranking.com",
  "mode": "domain",
  "new_lost_type": "new",
  "date_from": "2023-01-15",
  "date_to": "2023-01-16"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
new_lost_dateDateThe date when the oldest live backlink coming from this domain was found or the last backlink from this domain was lost.2022-10-26
new_lost_typeStringIndicates whether the refdomain is new or lost:new – returns referring domains, at least one backlink from which was newly found.lost – returns referring domains, at least one backlink from which was tagged as lost.new
refdomainStringThe name of the referring domainfrashmi.net
backlinksIntegerTotal number of backlinks pointing to the target from this domain68
dofollow_backlinksIntegerNumber of backlinks from this domain that are NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag900
first_seenDateThe date when the oldest live backlink coming from this domain was found2016-10-26
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the referring domain68

Response example

Copy
{
  "new_lost_refdomains": [
    {
      "new_lost_date": "2023-01-16",
      "new_lost_type": "new",
      "refdomain": "agenzia-seo.it",
      "backlinks": 1,
      "dofollow_backlinks": 1,
      "first_seen": "2023-01-16",
      "domain_inlink_rank": 32
    },
    {
      "new_lost_date": "2023-01-15",
      "new_lost_type": "lost",
      "refdomain": "doso.com.au",
      "backlinks": 1,
      "dofollow_backlinks": 1,
      "first_seen": "2023-01-15",
      "domain_inlink_rank": 25
    }
  ]
}

refdomains/history/count

GET / POST https://api.seranking.com/v1/backlinks/refdomains/history/count

Cost: 100 credits per target

Returns the number of referring domains, at least one backlink from which was newly found or lost in the specified date range for the specified target. The data is broken down by day. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
new_lost_typeStringNo“”Indicates whether the count of new or lost refdomain should be returned:new – returns the count of referring domains, at least one backlink from which was newly found.lost – returns the count of referring domains, at least one backlink from which was tagged as lost.Passing an empty parameter will return the count of both new and lost refdomains.new
date_fromDateNoyesterdayStart date in “YYYY-MM-DD” format (inclusive range).2019-03-01
date_toDateNocurrent day (today)End date in “YYYY-MM-DD” format (inclusive range).2019-04-01
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/refdomains/history/count?apikey=XXX&target=https://www.seranking.com&mode=domain&new_lost_type=new&date_from=2023-01-15&date_to=2023-01-16&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/refdomains/history/count?apikey=XXX&output=json

{
  "target": "https://www.seranking.com",
  "mode": "domain",
  "new_lost_type": "new",
  "date_from": "2023-01-15",
  "date_to": "2023-01-16"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
datedateThe particular date for which new or lost refdomains have been counted.2022-10-26
newIntegerNumber of new referring domains that were found at that date and match the filters specified in the request parameters25
lostIntegerNumber of referring domains that were lost at that date and match the filters specified in the request parameters25

Response example

Copy
{
"new_lost_refdomains_count": [
    {
      "date": "2023-01-16",
      "new": 4,
      "lost": 0
    },
    {
      "date": "2023-01-15",
      "new": 3,
      "lost": 0
    }
  ]
}

referring-ips

GET / POST https://api.seranking.com/v1/backlinks/referring-ips

Cost: 1 credit per target

Returns information about IPv4 that belong to backlinks that point to a target. Information about IPv6 is not served. The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
order_byStringNobacklinksThe field by which the results will be descending sorted by in the response:backlinks – total number of backlinks that are using an anchor text.refdomains – total number of referring domains that are using an anchor text.backlinks
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/referring-ips?apikey=XXX&target=https://seranking.com&mode=domain&limit=100&order_by=backlinks&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/referring-ips?apikey=XXX&output=json

{
  "target": "https://www.seranking.com/",
  "order_by": "backlinks",
  "mode": "domain",
  "limit": 2
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
ipStringIPv4 address that serves at least one page that links to a target123.23.25.42
backlinksIntegerTotal number of backlinks that point to the target and are served from the IP address. Always greater than zero.68
refdomainsIntegerTotal number of referring domains that point to the target and have at least one page served from the IP address. Always greater than zero.25
nofollow_backlinksIntegerNumber of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag100
dofollow_backlinksIntegerNumber of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag900
first_seenDateThe date of the earliest backlink that points to the target and is served from the IP address.2016-10-26
last_visitedDateThe date of the latest backlink that points to the target and is served from the IP address.2019-01-08

Response examples

Copy
{
  "ips": [
    {
      "ip": "123.234.23.43",
      "backlinks": 188,
      "refdomains": 144,
      "first_seen": "2020-10-19",
      "last_visited": "2022-03-15"
    },
    {
      "ip": "32.114.53.3",
      "backlinks": 68,
      "refdomains": 60,
      "first_seen": "2019-04-24",
      "last_visited": "2022-02-21"
    }
  ]
}

referring-ips/count

GET / POST https://api.seranking.com/v1/backlinks/referring-ips/count

Cost: 10 credits per target

Returns the number of unique IPs linking to a target. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 max), you can pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format.
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/referring-ips/count?apikey=XXX&target=https://seranking.com&target=https://www.us-seranking.com&mode=url&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/referring-ips/count?apikey=XXX&target=https://www.seranking.com&target=https://www.us-seranking.com&mode=url&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/referring-ips/count?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/",
    "https://www.us-seranking.com/"
  ],
  "mode": "host"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
targetStringAim of the request: root domain, host, or URLseranking.com
ipsIntegerNumber of unique IPs linking to a target80

Response example

Copy
{
  "metrics": [
    {
      "target": "https://seranking.com",
      "ips": 75
    },
    {
      "target": "https://www.us-seranking.com",
      "ips": 2493
    }
  ]
}

referring-subnets/count

GET / POST https://api.seranking.com/v1/backlinks/referring-subnets/count

Cost: 10 credits per target

Returns the number of unique subnets/C-blocks linking to a target. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/referring-subnets/count?apikey=XXX&target=seranking.com&target=us-seranking.com&mode=host&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/referring-subnets/count?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/",
    "https://www.us-seranking.com/"
  ],
  "mode": "host"
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST).

POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescriptionExample
targetStringAim of the request: root domain, host, or URLseranking.com
subnetsIntegerNumber of unique subnets / C-blocks linking to a target 50

Response example

Copy
{
  "metrics": [
    {
      "target": "seranking.com",
      "subnets": 1399
    },
    {
      "target": "us-seranking.com",
      "subnets": 7690
    }
  ]
}

indexed-pages

GET / POST https://api.seranking.com/v1/backlinks/indexed-pages

Cost: 1 credit per target

Returns information about site pages that belong to a target. Target parameter can take only a single parameter. 

If at least one backlink references some page that belongs to target, then this page will be returned in response. If no more backlinks reference some page that previously was referenced, then this page is excluded from returned list. Returned list does not contain duplicated pages. Difference in protocols is taken into account – otherwise same pages are treated as non-duplicates.

The command supports both GET and POST requests, but doesn’t allow making batch requests, and only takes a single target input parameter.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)DescriptionExample
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain), or URLseranking.com
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.domain
order_byStringNobacklinksThe field by which the results will be descending sorted by in the response:backlinks – total number of backlinks that are using an anchor text.refdomains – total number of referring domains that are using an anchor text.backlinks
limitIntegerNo100Maximum number of results to return. Should be within [1; 10,000].10
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format
json

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/indexed-pages?apikey=XXX&target=https://seranking.com&mode=domain&limit=100&order_by=backlinks&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/indexed-pages?apikey=XXX&output=json

{
  "target": "https://www.seranking.com/",
  "order_by": "backlinks",
  "mode": "domain",
  "limit": 2
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
urlStringURL of a page that belongs to specified in request target and mode (e.g., http://seranking.com/landing1).
backlinksIntegerTotal number of backlinks that point to the URL. Always greater than zero (e.g., 68).
refdomainsIntegerTotal number of referring domains that point to the URL. Always greater than zero (e.g., 25).
nofollow_backlinksIntegerNumber of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag (e.g., 100).
dofollow_backlinksIntegerNumber of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag (e.g., 900).
first_seenDateDate of the earliest backlink pointing to the URL in the index (e.g., 2016-10-26).
last_visitedDateDate of the latest backlink pointing to the URL in the index (e.g., 2019-01-08).

Response example

Copy

{
  "pages": [
{
      "url": "https://www.seranking.com/",
      "backlinks": 16696,
      "refdomains": 1227,
      "dofollow_backlinks": 14708,
      "nofollow_backlinks": 1978,
      "first_seen": "2017-01-03",
      "last_visited": "2023-10-23"
    },
    {
      "url": "http://seranking.com/",
      "backlinks": 1926,
      "refdomains": 220,
      "dofollow_backlinks": 1254,
      "nofollow_backlinks": 671,
      "first_seen": "2017-09-15",
      "last_visited": "2023-10-21"
    }
  ]
}

authority

GET / POST https://api.seranking.com/v1/backlinks/authority

Cost: 100 credits per target

Returns information about the InLink Rank (Page Authority) and Domain InLink Rank (Domain Authority) for a target URL.

Note: The inlink_rank value in the response is calculated in real time, so it may differ from the cached value returned by /backlinks/all.

This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’) or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)Description
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain) or URL (e.g., seranking.com).
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format

GET Request

To receive information about a single target:

Copy
GET: https://api.seranking.com/v1/backlinks/authority?apikey=XXX&target=https://www.seranking.com&output=json

POST Request

To receive information about multiple targets:

Copy
POST: https://api.seranking.com/v1/backlinks/authority?apikey=XXX&output=json

{
    "target":
    [ 
        "https://www.seranking.com/", 
        "https://www.seranking.com/rank-tracker/" 
    ]
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
urlStringURL of a page that belongs to specified in request target and mode (e.g., https://www.seranking.com/).
inlink_rankIntegerInLink Rank (Page Authority) of the target URL (e.g., 21).
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the target’s root domain (e.g., 68).

Response example

Copy
{
  "pages": [
    {
      "url": "https://www.seranking.com",
      "inlink_rank": 40,
      "domain_inlink_rank": 68
    }
  ]
}

authority/domain

GET / POST https://api.seranking.com/v1/backlinks/authority/domain

Cost: 10 credits per target

Returns information about the domain InLink Rank (Domain Authority) of the target page’s root domain. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)Description
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain, or URL (e.g., seranking.com).
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/authority/domain?apikey=XXX&target=https://seranking.com&target=https://www.seranking.com&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/authority/domain?apikey=XXX&target=https://seranking.com&target=https://www.seranking.com&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/authority/domain?apikey=XXX&output=json

{
  "target": [
    "https://seranking.com/",
    "https://www.seranking.com/rank-tracker/"
  ]
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
urlStringURL of a page that belongs to specified in request target and mode (e.g., seranking.com).
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority) of the target’s root domain (e.g., 68).

Response example

Copy
{
  "pages": [
    {
      "url": "https://seranking.com",
      "domain_inlink_rank": 68
    },
    {
      "url": "https://www.seranking.com",
      "domain_inlink_rank": 87
    }
  ]
}

authority/domain/distribution

GET https://api.seranking.com/v1/backlinks/authority/domain/distribution

Cost: 1 credit per target

Returns information about the distribution of Domain InLink Rank (Domain Authority) of all the domains that reference a specific target. This command does not support batching multiple targets into a single request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)Description
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: root domain, host (subdomain, or URL (e.g., seranking.com).
modeStringNohostMode of operation:domain (*.example.com/*) – analysis will be done for all URLs that belong to this domain, including its subdomains.host (www.example.com/*) – analysis will be done for all URLs that belong to this host (subdomains will not be included).url (http://www.example.com/) – analysis will be done for the particular URL only.
histogramModeStringNohostMode of aggregation:domain – for each unique Domain InLink Rank value number of base domains with that rank will be calculatedhost – for each unique Domain InLink Rank value number of hosts with that rank will be calculated
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format

Request example

Copy
GET: https://api.seranking.com/v1/backlinks/authority/domain/distribution?apikey=XXX&output=json&target=seranking.com&mode=host&histogramMode=domain
Copy
GET: https://api.seranking.com/v1/backlinks/authority/domain/distribution?apikey=XXX&target=https://seranking.com&output=json

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
domain_inlink_rankIntegerDomain InLink Rank (Domain Authority). Only those DR values are returned that correspond to at least one referring to the specified target domain (e.g., 68).
refdomainsIntegerNumber of referring domains with the specified Domain InLink Rank (e.g., 123).

Response example

Copy
{
    "histogram": [
        {
            "domain_inlink_rank": 0,
            "refdomains": 250
        },
        {
            "domain_inlink_rank": 1,
            "refdomains": 872
        },
        {
            "domain_inlink_rank": 2,
            "refdomains": 567
        },
        {
            "domain_inlink_rank": 3,
            "refdomains": 347
        },
        {
            "domain_inlink_rank": 4,
            "refdomains": 268
        }
]
}

authority/page

GET / POST https://api.seranking.com/v1/backlinks/authority/page

Cost: 10 credits per target

Returns information about the InLink Rank for a target URL. This command supports batching multiple targets into a single request. If you need to make a batch request and get metrics for a number of targets (100 maximum), pass multiple targets as GET parameters (separated by ‘&’), or use a POST request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)Description
apikeyStringYesN/AAPI key for authentication
targetStringYesN/AAim of the request: root domain, host (subdomain, or URL (e.g., seranking.com).
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format

Request examples

Copy
GET: https://api.seranking.com/v1/backlinks/authority/page?apikey=XXX&target=https://seranking.com&target=https://www.seranking.com&mode=url&output=json
Copy
GET: https://api.seranking.com/v1/backlinks/authority/page?apikey=XXX&target=https://seranking.com&target=https://www.us-seranking.com&mode=url&output=json
Copy
POST: https://api.seranking.com/v1/backlinks/authority/page?apikey=XXX&output=json

{
  "target": [
    "https://www.seranking.com/",
    "https://www.seranking.com/rank-tracker/"
  ]
}

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
urlStringURL of a page that belongs to specified in request target and mode (e.g., seranking.com).
inlink_rankIntegerInLink Rank (Page Authority) of the target URL (e.g., 21).

Response example

Copy
{
  "pages": [
    {
      "url": "https://seranking.com",
      "inlink_rank": 19
    },
    {
      "url": "https://www.seranking.com",
      "inlink_rank": 49
    }
  ]
}

authority/page/history

GET https://api.seranking.com/v1/backlinks/authority/page/history

Cost: 1 credit per target

Returns information about the historical values of InLink Rank for a specific target page. This command does not support batching multiple targets into a single request.

Request parameters

ParameterTypeRequiredDefault (if not specified in request)Description
apikeyStringYesN/AAPI key for authentication.
targetStringYesN/AAim of the request: only full page URL is supported (e.g., http://seranking.com/index.html).
date_fromDateNonow – 1 monthStart date in “YYYY-MM-DD” format (inclusive range).
date_toDateNonowEnd date in “YYYY-MM-DD” format (inclusive range).
granularityEnumerationNoby_dayGranularity at which to return data (e.g., by_month, by_week, by_day). Aggregation is: the latest value within an aggregated range.
outputStringNojsonOutput format:
json – get response in JSON format
xml – get response in XML format

Request example

Copy
GET: https://api.seranking.com/v1/backlinks/authority/page/history?apikey=XXX&output=json&target=seranking.com&date_from=2025-02-01&date_to=2025-04-01&granularity=by_month
Copy
GET: https://api.seranking.com/v1/backlinks/authority/page/history?apikey=XXX&target=https://seranking.com&output=json

Please note that the apikey (mandatory) and output (optional) parameters must always come as GET parameters (even if the rest of the parameters come through POST). POST data that comes in the request body should be in JSON format.

Response parameters

ParameterTypeDescription
dateDateDate of the corresponding domain rank value (e.g., 2022-10-26). For by_week granularity – the first day of the corresponding week (Monday). For by_month granularity – the first day of the corresponding month. For by_day granularity – the day the rank is calculated. In the response, the first result should be the first day of the requested range, followed by the data according to the requested granularity.
inlink_rankIntegerInLink Rank for a date (e.g., 68).

Response example

Copy
{
    "ranks": [
        {
            "date": "2025-04-01",
            "inlink_rank": 54
        },
        {
            "date": "2025-03-01",
            "inlink_rank": 32
        },
        {
            "date": "2025-02-01",
            "inlink_rank": 21
        }
    ]
}

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.