Backlinks
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
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
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
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
GET: https://api.seranking.com/v1/backlinks/summary?apikey=XXX&target=seranking.com&mode=domain&output=json
Sample Response: summary
{
"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
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
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
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
GET: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX&target=seranking.com&mode=host&output=json
Sample Response: metrics
{
"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
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
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.
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
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
{
"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
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
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
{
"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
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
{
"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.
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
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
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.
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
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
{
"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
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
Sample Response: export
{
"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
GET: https://api.seranking.com/v1/backlinks/export/status?apikey=XXX&task_id=d1d2bb44-6c66-4791-a634-26103551e2da&output=json
Sample Response: export/status
{
"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:
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
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
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.
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
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
{
"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
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
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.
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
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
{
"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
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
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.
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
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
{
"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
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
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.
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
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
{
"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
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
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.
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
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
{
"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.
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
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
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.
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
GET: https://api.seranking.com/v1/backlinks/refdomains/count?apikey=XXX&target=seranking.com&mode=domain&output=json
Sample Response: refdomains/count
{
"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
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
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.
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
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=jsonSample Response: refdomains/history
{
"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
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
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.
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
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
{
"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
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
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.
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
{
"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.
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
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
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.
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
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
{
"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.
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
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
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
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
{
"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
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
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.
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
{
"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.
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
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
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.
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:
{
"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
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
GET: https://api.seranking.com/v1/backlinks/authority/domain?apikey=XXX&target=https://seranking.com&target=https://www.seranking.com&output=json
POST Request
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.
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
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
{
"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
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.
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
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
{
"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.
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
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
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.
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
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
{
"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
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.
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
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
{
"ranks": [
{
"date": "2025-04-01",
"inlink_rank": 54
},
{
"date": "2025-03-01",
"inlink_rank": 32
},
{
"date": "2025-02-01",
"inlink_rank": 21
}
]
}