API Description

Backlinks

IMPORTANT: This is the Data API (api.seranking.com). For Project API (api4.seranking.com, included in Business/Enterprise plans), see Project API Docs. API keys are not interchangeable—use the correct one to avoid authentication errors.

If you’re seeing auth errors or need help, contact [email protected] for support.

Below is a list of commands available via Backlinks API along with a brief overview of their functionality.

summary

This command 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 max), you can pass multiple targets as GET parameters (separated by ‘&’) or use a POST request.

GET Request

To receive information about a single target

Title of the code block

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

Title of the code block

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'

POST Request

To receive information about multiple targets

Title of the code block

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.

Request Parameters: summary

Parameter	Data Type	Mandatory	Default Value	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	url, host, domain	domain
output	string	no	json	Output format – json – get response in JSON format. – xml – get response in XML format.	json, xml	json

Response Parameters: summary

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
backlinks	int	Total number of live backlinks	10000
refdomains	int	Number of unique domains linking to a target	1000
subnets	int	Number of unique subnets / C-blocks linking to a target	50
ips	int	Number of unique IPs linking to a target	80
nofollow_backlinks	int	Number of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	100
dofollow_backlinks	int	Number of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
from_home_page_backlinks	int	Number of backlinks coming from a home page of the referring domain	40
dofollow_from_home_page_backlinks	int	Number of ‘dofollow’ backlinks, which come from a home page of the referring domain	40
text_backlinks	int	Number of backlinks that use text as an anchor	750
edu_backlinks	int	Number of backlinks coming from .edu domains	0
gov_backlinks	int	Number of backlinks coming from .gov domains	1
inlink_rank	int	InLink Rank (Page Authority) of the target URL	21
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the target’s root domain	68
dofollow_refdomains	int	Number of referring domains with at least one ‘dofollow’ link pointing to the target	40
from_home_page_refdomains	int	Number of referring domains with at least backlink coming from a home page of the domain	40
edu_refdomains	int	Number of .edu referring domains	40
gov_refdomains	int	Number of .gov referring domains	40
anchors	int	Total number of unique anchor texts being used within all backlinks pointing to the target	50
dofollow_anchors	int	Total number of unique anchor texts being used within ‘dofollow’ backlinks pointing to the target	40
pages_with_backlinks	int	Total number of linked pages belonging to the target	500
top_anchors_by_backlinks	array	Array of the top anchor text and the number of backlinks with this anchor
top_anchors_by_backlinks.anchor	string	Anchor text used in backlinks	“SE Ranking”
top_anchors_by_backlinks.backlinks	string	Number of backlinks found that are using the anchor	40
top_anchors_by_refdomains	array	Array of the top anchor text and the number of referring domains with this anchor
top_anchors_by_refdomains.anchor	string	Anchor text used in backlinks	“SE Ranking”
top_anchors_by_refdomains.refdomains	string	Number of referring domains with at least one backlink using the anchor	40
top_pages_by_backlinks	array	Array of the top linked pages belonging to the target and the number of backlinks pointing to this page
top_pages_by_backlinks.url	string	URL of the page	https://target.com/page.html
top_pages_by_backlinks.backlinks	int	Number of backlinks pointing to this page	24
top_pages_by_refdomains	array	Array 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.refdomains	int	Number of referring domains pointing to this page	20
top_pages_by_refdomains.url	string	URL of the page	https://target.com/page.html
top_tlds	array	Array of the top TLDs which have backlinks pointing to the target
top_tlds.tld	string	TLD (top-level domain)	.com
top_tlds.count	int	Number of backlinks from the TLD pointing to the target	700
top_countries	array	Array of the top countries which have backlinks pointing to the target
top_countries.country	string	Country code	Us
top_countries.count	int	Number of backlinks from the specified country pointing to the target	600

Sample Request: summary

Title of the code block

Copy

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

Sample Response: summary

Title of the code block

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

This command returns key statistics for the 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 max), you can pass multiple targets as GET parameters (separated by ‘&’) or use a POST request.

GET Request

To receive information about a single target

Title of the code block

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

Title of the code block

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

POST Request

To receive information about multiple targets

Title of the code block

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.

Request Parameters: metrics

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: metrics

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
backlinks	int	Total number of live backlinks	10000
refdomains	int	Number of unique domains linking to a target	1000
ips	int	Number of unique IPs linking to a target	80
subnets	int	Number of unique subnets / C-blocks linking to a target	50
nofollow_backlinks	int	Number of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	100
dofollow_backlinks	int	Number of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
gov_backlinks	int	Number of backlinks coming from .gov domains	1
edu_backlinks	int	Number of backlinks coming from .edu domains	0

Sample Request: metrics

Title of the code block

Copy

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

Sample Response: metrics

Title of the code block

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

This command returns information about the backlinks 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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 }

Request Parameters: all

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
per_domain	int	no	–	Number 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).	[1; 100]	1
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json
order_by	string	no	date_found	The 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_founddomain_inlink_rankinlink_rank	date_found
inlink_rank_from	int	no	0	InLink Rank minimum value. Return backlinks with InLink Rank greater than or equal to the field value.	[0;100]	10
inlink_rank_to	int	no	100	InLink Rank maximum value. Return backlinks with InLink Rank less than or equal to the field value.	[0;100]	90
domain_inlink_rank_from	int	no	0	Domain InLink Rank minimum value. Return backlinks with Domain InLink Rank greater than or equal to the field value.	[0;100]	32
domain_inlink_rank_to	int	no	100	Domain InLink Rank maximum value. Return backlinks with Domain InLink Rank less than or equal to the field value.	[0;100]	56
url_from_filter	string	no	–	Text for url_from parameter filter.	Maximum 2063 ascii symbols.	seo-software
url_from_filter_mode	string	no	contains	Url_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 set	contains,does_not_contain	does_not_contain
url_to_filter	string	no	–	Text for url_to parameter filter.	Maximum 2063 ascii symbols.	seopowersuite.com/news/
url_to_filter_mode	string	no	contains	Url_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 set	contains,does_not_contain	contains
anchor_filter	string	no	–	Text for anchor parameter filter.	Maximum 2063 ascii symbols	seo
anchor_filter_mode	string	no	contains	Anchor 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 set	contains,does_not_contain	contains
nofollow_filter	string	no	–	Nofollow filter. Allowed values:nofollow_only – return backlinks with nofollow attributedofollow_only – return href backlinks without nofollow attributePassing an empty parameter will return all backlinks	nofollow_only,dofollow_only	dofollow_only

Response Parameters: all

Parameter	Data Type	Description	Example
url_from	string	Referring page’s URL	http://seo.jouwlinkhier.nl/
url_to	string	Destination page’s URL	https://www.seranking.com/
title	string	Referring page’s title	informatie over seo
anchor	string	Link anchor text for text links.Image alt text for image links.	Rank Tracker
alt	string	Deprecated, not used	“”
nofollow_backlinks	boolean	Is set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tag	false
image	boolean	Is set to true if the html <a> tag from which the link was extracted includes an image	false
image_source	string	The source URL of the image (for image links)	https://podnova.com/img/sps.jpg
inlink_rank	int	InLink Rank (Page Authority) of the referring page’s URL	21
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the referring page’s root domain	68
first_seen	date	The date when the backlink was discovered and added to the index	2016-10-26
last_visited	date	The date when our crawlers last visited the referring page	2019-01-08

Sample Request: all

Title of the code block

Copy

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

Sample Response: all

Title of the code block

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

This command 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 must not 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.

Please note that this command supports GET requests only (POST is not supported for this command).

GET Request

Title of the code block

Copy

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

Request Parameters: raw

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
limit	int	no	10,000	Maximum number of results to return on one page.	Should be within [1; 100,000]	10
next	string	no	–	The 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
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json
order_by	string	no	date_found	The 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_founddomain_inlink_rankinlink_rank	date_found
per_domain	int	no	–	Number 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).	[1; 100]	1

Response Parameters: raw

Parameter	Data Type	Description	Example
url_from	string	Referring page’s URL	http://seo.jouwlinkhier.nl/
url_to	string	Destination page’s URL	https:// seranking.com/rank-tracker/
title	string	Referring page’s title	informatie over seo
anchor	string	Link anchor text for text links.Image alt text for image links.	Rank Tracker
alt	string	not used	“”
nofollow_backlinks	boolean	Is set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tag	false
image	boolean	Is set to true if the html <a> tag from which the link was extracted includes an image	false
image_source	string	The source URL of the image (for image links)	https:// podnova.com/img/sps.jpg
inlink_rank	int	InLink Rank (Page Authority) of the referring page’s URL	21
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the referring page’s root domain	68
first_seen	date	The date when the backlink was discovered and added to the index	2016-10-26
last_visited	date	The date when our crawlers last visited the referring page	2019-01-08
next	string	The 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

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):

Sample Request: raw

Title of the code block

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.

Sample Response: raw

Title of the code block

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.

Sample Request: raw

Title of the code block

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=

Sample Response: raw

Title of the code block

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

This command returns the number of backlinks for the target.

GET Request

Title of the code block

Copy

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

POST Request

Title of the code block

Copy

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

  "target": [

    "https://www.seranking.com/",

    "https://www.seranking.com/"

  ],

  "mode": "host"

}

Request Parameters: count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: count

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
backlinks	int	Total number of live backlinks	10000

Sample Request: count

Title of the code block

Copy



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

Sample Response: count

Title of the code block

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "backlinks": 22402

    },

    {

      "target": "www.seranking.com",

      "backlinks": 341415

    }

  ]

}

export

This command allows for large-scale backlinks retrieval 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.

Please note that this command supports GET requests only (POST is not supported for this command).

GET Request

Title of the code block

Copy

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

Request Parameters: export

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: export

Parameter	Data Type	Description	Example
task_status	string	Status 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_id	string	The id of the CSV file preparation task	602c775d-760d-46ba-bfaf-005a6b37ac4e
download_file	string	The location of the CSV file with the requested data, ready for download	https://api.seranking.com/export/c/seranking.com-1572280448369.csv.gz

Sample Flow

Step 1

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

Sample Request: export

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

Sample Response: export

Title of the code block

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.

Sample Request: export/status

Title of the code block

Copy

GET: https://api.seranking.com/v1/backlinks/export/status?apikey=XXX&task_id=d1d2bb44-6c66-4791-a634-26103551e2da&output=json

Sample Response: export/status

Title of the code block

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:

Title of the code block

Copy

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

history

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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" }

Request Parameters: history

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
new_lost_type	string	no	“”	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.	newlost””	new
date_from	date	no	yesterday	Start date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-03-01
date_to	date	no	current day (today)	End date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-04-01
link_type	string	no	“”	Type of the backlink. One ofhrefredirectPassing an empty parameter will return all types of backlinks.	hrefredirect””	href
anchor_type	string	no	“”	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.	newlost””	text
dofollow	string	no	“”	Identifies whether the backlink is dofollow or nofollow. One ofdofollownofollowundefinedPassing an empty parameter will return all types of backlinks.	dofollownofollowundefined””	dofollow
url_from	string	no	“”	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
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
order_by	string	no	new_lost_date	The 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_datedomain_inlink_rankinlink_rank	new_lost_date
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: history

Parameter	Data Type	Description	Example
new_lost_date	date	The date when the link was found or lost	2022-10-26
new_lost_type	string	Indicates whether the backlink is new or lost:new – returns fresh backlinks that were tagged as newlost – returns backlinks that were tagged as lost	new
url_from	string	Referring page’s URL	http://seo.jouwlinkhier.nl/
url_to	string	Destination page’s URL	https:// seranking.com/rank-tracker/
title	string	Referring page’s title	informatie over seo
anchor	string	Link anchor text for text links.Image alt text for image links.	Rank Tracker
alt	string	Deprecated. Not used.	“”
link_type	string	Type 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_backlinks	boolean	Is set to true if the link has a rel=”nofollow” attribute in the <a> tag or robots meta tag	false
image	boolean	Is set to true if the html <a> tag from which the link was extracted includes an image	false
image_source	string	The source URL of the image (for image links)	https://podnova.com/img/sps.jpg
reason-lost	string	The 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_rank	int	InLink Rank (Page Authority) of the referring page’s URL	21
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the referring page’s root domain	68
first_seen	date	The date when the backlink was discovered and added to the index	2016-10-26

Sample Request: history

Title of the code block

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

Sample Response: history

Title of the code block

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

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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" }

Request Parameters: history/count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
new_lost_type	string	no	“”	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.	newlost””	new
date_from	date	no	yesterday	Start date in “YYYY-MM-DD” format (inclusive range).	Date format “YYYY-MM-DD” format	2019-03-01
date_to	date	no	current day (today)	End date in “YYYY-MM-DD” format (inclusive range).	Date format “YYYY-MM-DD” format	2019-04-01
link_type	string	no	“”	Type of backlinks to be counted. One of:hrefredirectPassing an empty parameter will count backlinks of all types.	hrefredirect””	href
anchor_type	string	no	“”	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.	textimage””	text
dofollow	string	no	“”	Identifies whether dofollow, nofollow, or undefined backlinks must be counted. One ofdofollownofollowundefinedPassing an empty parameter will count all types of backlinks.	dofollownofollowundefined””	dofollow
url_from	string	no	“”	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
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: history/count

Parameter	Data Type	Description	Example
date	date	The particular date for which new or lost backlinks have been counted.	2022-10-26
new	int	Number of new backlinks that were found at that date and match the filters specified in the request parameters	25
lost	int	Number of backlinks that were lost at that date and match the filters specified in the request parameters	25

Sample Request: history/count

Title of the code block

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

Sample Response: history/count

Title of the code block

Copy

{

  "new_lost_backlinks_count": [

    {

      "date": "2023-01-16",

      "new": 5,

      "lost": 0

    },

    {

      "date": "2023-01-15",

      "new": 5,

      "lost": 0

    }

  ]

}

history/cumulative

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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" }

Request Parameters: history/cumulative

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: only full page URL is supported.	–	http://seranking.com/index.html
mode	string	no	host	Mode 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.	urlhostdomain	domain
date_from	date	no	yesterday	Start date in “YYYY-MM-DD” format (inclusive range).	Date format”YYYY-MM-DD” format	2019-03-01
date_to	date	no	current day(today)	End date in “YYYY-MM-DD” format (inclusive range).	Date format”YYYY-MM-DD” format	2019-04-01
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters:history/cumulative

Parameter	Data Type	Description	Example
date	date	The 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
backlinks	int	Number of live backlinks that were live at that date and match the filters specified in the request parameters.	68

Sample Request: history/cumulative

Title of the code block

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

Sample Response: history/cumulative

Title of the code block

Copy

{

"backlinks_count": [

{

"date": "2023-01-16",

"backlinks": 5,

},

{

"date": "2023-01-15",

"backlinks": 5,

}]

}

anchors

This command 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.

GET Request

Title of the code block

Copy

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

POST Request

Title of the code block

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 }

Request Parameters: anchors

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
order_by	string	no	backlinks	The 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.	backlinksrefdomains	backlinks
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: anchors

Parameter	Data Type	Description	Example
anchor	string	Text of an anchor. May be empty. Case sensitive.	SE Ranking
backlinks	int	A total number of backlinks that are using anchor text. Always greater than zero.	10000
refdomains	int	Total number of referring domains that are using an anchor text. Always greater than zero.	50
nofollow_backlinks	int	Number of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	100
dofollow_backlinks	int	Number of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
first_seen	date	The date of the earliest backlink with the anchor pointing to the target in the index.	2016-10-26
last_visited	date	The last date when the backlink with the anchor pointing to the target was seen.	2019-01-08

Sample Request: anchors

Title of the code block

Copy

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

Sample Response: anchors

Title of the code block

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

This command 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.

GET Request

Title of the code block

Copy

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

POST Request

Title of the code block

Copy

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

 "target":"seranking.com",

 "mode":"domain",

 "limit":2

}

Request Parameters: refdomains

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
order_by	string	no	date_found	The 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_founddomain_inlink_rankinlink_rank	date_found
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: refdomains

Parameter	Data Type	Description	Example
refdomain	string	The name of the referring domain	frashmi.net
backlinks	int	Total number of backlinks pointing to the target from this domain	68
dofollow_backlinks	int	Number of backlinks from this domain that are NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
first_seen	date	The date when the oldest live backlink coming from this domain was found	2016-10-26
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the referring domain	68

Sample Request: refdomains

Title of the code block

Copy

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

Sample Response: refdomains

Title of the code block

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

This command returns the number of unique domains linking to a target.

GET Request

To receive information about a single target

Title of the code block

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

POST Request

To receive information about multiple targets

Title of the code block

Copy

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

  "target": [

    "https://www.seranking.com/"

  ],

  "mode": "domain"

}

Request Parameters: refdomains/count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: refdomains/count

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
refdomains	int	Number of unique domains linking to a target	1000

Sample Request: refdomains/count

Title of the code block

Copy

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

Sample Response: refdomains/count

Title of the code block

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "refdomains": 50234

    }  

]

}

refdomains/history

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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" }

Request Parameters: refdomains/history

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
new_lost_type	string	no	“”	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.	newlost””	new
date_from	date	no	yesterday	Start date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-03-01
date_to	date	no	current day (today)	End date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-04-01
order_by	string	no	new_lost_date	The 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_datedomain_inlink_rankinlink_rank	new_lost_date
limit	int	no	100	Maximum number of results to return.	Should be within[1; 10,000]	10
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: refdomains/history

Parameter	Data Type	Description	Example
new_lost_date	date	The 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_type	string	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.	new
refdomain	string	The name of the referring domain	frashmi.net
backlinks	int	Total number of backlinks pointing to the target from this domain	68
dofollow_backlinks	int	Number of backlinks from this domain that are NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
first_seen	date	The date when the oldest live backlink coming from this domain was found	2016-10-26
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the referring domain	68

Sample Request: refdomains/history

Title of the code block

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

Sample Response: refdomains/history

Title of the code block

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

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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" }

Request Parameters: refdomains/history/count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
new_lost_type	string	no	“”	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.	newlost””	new
date_from	date	no	yesterday	Start date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-03-01
date_to	date	no	current day (today)	End date in “YYYY-MM-DD” format (inclusive range).	Date value in “YYYY-MM-DD” format	2019-04-01
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: refdomains/history/count

Parameter	Data Type	Description	Example
date	date	The particular date for which new or lost refdomains have been counted.	2022-10-26
new	int	Number of new referring domains that were found at that date and match the filters specified in the request parameters	25
lost	int	Number of referring domains that were lost at that date and match the filters specified in the request parameters	25

Sample Request: refdomains/history/count

Title of the code block

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

Sample Response: refdomains/history/count

Title of the code block

Copy

{

"new_lost_refdomains_count": [

    {

      "date": "2023-01-16",

      "new": 4,

      "lost": 0

    },

    {

      "date": "2023-01-15",

      "new": 3,

      "lost": 0

    }

  ]

}

referring-ips

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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 }

Request Parameters: referring-ips

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
order_by	string	no	backlinks	The 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.	backlinksrefdomains	backlinks
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: referring-ips

Parameter	Data Type	Description	Example
ip	string	IPv4 address that serves at least one page that links to a target	123.23.25.42
backlinks	int	Total number of backlinks that point to the target and are served from the IP address. Always greater than zero.	68
refdomains	int	Total 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_backlinks	int	Number of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	100
dofollow_backlinks	int	Number of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag	900
first_seen	date	The date of the earliest backlink that points to the target and is served from the IP address.	2016-10-26
last_visited	date	The date of the latest backlink that points to the target and is served from the IP address.	2019-01-08

Sample Request: referring-ips

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

Sample Response: referring-ips

Title of the code block

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

This command returns the number of unique IPs linking to a target.

GET Request

Title of the code block

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

POST Request

Title of the code block

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"

}

Request Parameters: referring-ips/count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: referring-ips/count

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
ips	int	Number of unique IPs linking to a target	80

Sample Request: referring-ips/count

Title of the code block

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

Sample Response: referring-ips/count

Title of the code block

Copy

{

  "metrics": [

    {

      "target": "https://seranking.com",

      "ips": 75

    },

    {

      "target": "https://www.us-seranking.com",

      "ips": 2493

    }

  ]

}

referring-subnets/count

This command returns the number of unique subnets / C-blocks linking to a target.

GET Request

Title of the code block

Copy

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

POST Request

Title of the code block

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.

Request Parameters: referring-subnets/count

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: referring-subnets/count

Parameter	Data Type	Description	Example
target	string	Aim of the request: root domain, host, or URL	seranking.com
subnets	int	Number of unique subnets / C-blocks linking to a target	50

Sample Request: referring-subnets/count

Title of the code block

Copy

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

Sample Response: referring-subnets/count

Title of the code block

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "subnets": 1399

    },

    {

      "target": "us-seranking.com",

      "subnets": 7690

    }

  ]

}

indexed-pages

This command 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.

GET Request

Title of the code block

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

POST Request

Title of the code block

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 }

Request Parameters: indexed-pages

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
order_by	string	no	backlinks	The 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.	backlinksrefdomains	backlinks
limit	int	no	100	Maximum number of results to return.	Should be within [1; 10,000]	10
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: indexed-pages

Parameter	Data Type	Description	Example
url	string	URL of a page that belongs to specified in request target and mode.	http://seranking.com/landing1
backlinks	int	Total number of backlinks that point to the URL. Always greater than zero.	68
refdomains	int	Total number of referring domains that point to the URL. Always greater than zero.	25
nofollow_backlinks	int	Number of backlinks marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag.	100
dofollow_backlinks	int	Number of backlinks NOT marked as nofollow with a rel=”nofollow” attribute in the <a> tag or robots meta tag.	900
first_seen	date	The date of the earliest backlink pointing to the URL in the index.	2016-10-26
last_visited	date	The date of the latest backlink pointing to the URL in the index.	2019-01-08

Sample Request: indexed-pages

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

Sample Response: indexed-pages

Title of the code block

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

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

GET Request

To receive information about a single target

Title of the code block

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

Title of the code block

Copy

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

    "target":

    [ 

        "https://www.seranking.com/", 

        "https://www.seranking.com/rank-tracker/" 

    ]

}

Request Parameters: authority

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: authority

Parameter	Data Type	Description	Example
url	string	URL of a page that belongs to specified in request target and mode.	https://www.seranking.com/
inlink_rank	int	InLink Rank (Page Authority) of the target URL	21
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the target’s root domain	68

Sample Request: authority

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

Sample Response:

Title of the code block

Copy

{

  "pages": [

    {

      "url": "https://www.seranking.com",

      "inlink_rank": 40,

      "domain_inlink_rank": 68

    }

  ]

}

authority/domain

This command returns information about the domain InLink Rank (Domain Authority) of the target page’s root domain

GET Request

Title of the code block

Copy

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

POST Request

Title of the code block

Copy

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

  "target": [

    "https://seranking.com/",

    "https://www.seranking.com/rank-tracker/"

  ]

}

Request Parameters: authority/domain

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: authority/domain

Parameter	Data Type	Description	Example
url	string	URL of a page that belongs to specified in request target and mode.	seranking.com
domain_inlink_rank	int	Domain InLink Rank (Domain Authority) of the target’s root domain	68

Sample Request: authority/domain

Title of the code block

Copy

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

Sample Response: authority/domain

Title of the code block

Copy

{

  "pages": [

    {

      "url": "https://seranking.com",

      "domain_inlink_rank": 68

    },

    {

      "url": "https://www.seranking.com",

      "domain_inlink_rank": 87

    }

  ]

}

authority/domain/distribution

This command 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.

GET Request

Title of the code block

Copy

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

Request Parameters: authority/domain/distribution

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
mode	string	no	host	Mode 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.	urlhostdomain	domain
histogramMode	string	no	host	Mode 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	hostdomain	host
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: authority/domain/distribution

Parameter	Data Type	Description	Example
domain_inlink_rank	int	Domain InLink Rank (Domain Authority). Only dose DR values are returned that correspond to at least one referring to the specified target domain.	68
refdomains	int	Number of referring domains with the specified Domain InLink Rank.	123

Sample Request: authority/domain/distribution

Title of the code block

Copy

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

Sample Response: authority/domain/distribution

Title of the code block

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

This command returns information about the InLink Rank for a target URL.

GET Request

Title of the code block

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

POST Request

Title of the code block

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/"

  ]

}

Request Parameters: authority/page

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: root domain, host (subdomain), or URL	–	seranking.com
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: authority/page

Parameter	Data Type	Description	Example
url	string	URL of a page that belongs to specified in request target and mode.	seranking.com
inlink_rank	int	InLink Rank (Page Authority) of the target URL	21

Sample Request: authority/page

Title of the code block

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

Sample Response: authority/page

Title of the code block

Copy

{

  "pages": [

    {

      "url": "https://seranking.com",

      "inlink_rank": 19

    },

    {

      "url": "https://www.seranking.com",

      "inlink_rank": 49

    }

  ]

}

authority/page/history

This command 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.

GET Request

Title of the code block

Copy

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

Request Parameters: authority/page/history

Parameter	Data Type	Mandatory	Default Value (if not specified in request)	Description	Acceptable values	Example
apikey	string	yes	–	API key for authentication	–	–
target	string	yes	–	Aim of the request: only full page URL is supported.	–	http://seranking.com/index.html
date_from	date	no	now – 1 month	Start date in “YYYY-MM-DD” format (inclusive range).	any date	2024-01-01
date_to	date	no	now	End date in “YYYY-MM-DD” format (inclusive range).	any date	2025-02-01
granularity	enumeration	no	by_day	Granularity at which to return data. Aggregation is: the latest value within an aggregated range.	by_monthby_weekby_day	host
output	string	no	json	Output formatjson – get response in JSON format.xml – get response in XML format.	jsonxml	json

Response Parameters: authority/page/history

Parameter	Data Type	Description	Example
date	date	The 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
inlink_rank	int	InLink Rank for a date.	68

Sample Request: authority/page/history

Title of the code block

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

Sample Response: authority/page/history

Title of the code block

Copy

{

    "ranks": [

        {

            "date": "2025-04-01",

            "inlink_rank": 54

        },

        {

            "date": "2025-03-01",

            "inlink_rank": 32

        },

        {

            "date": "2025-02-01",

            "inlink_rank": 21

        }

    ]

}