API

Backlinks

Backlinks API retrieves backlink data for a target domain, host, or URL. It provides aggregated metrics such as counts of backlinks, referring domains, IPs, and subnets, as well as anchor texts, top pages, TLDs, and countries. The API includes endpoints for summary metrics, historical data, raw backlink lists, export options, and authority scores.

Using the API, you can:

Retrieve backlink summary metrics, including counts of backlinks, referring domains, IPs, subnets, top anchors, TLDs, and countries
Retrieve key backlink metrics in batch for multiple targets
List all backlinks for a single target
Fetch backlinks in batches for large datasets
Track new, lost, cumulative, and daily backlink changes
Retrieve backlink anchor texts
Access referring domains, including counts and new/lost domains
Access referring IPs and subnets, including counts
List indexed pages with backlinks
Retrieve page and domain authority metrics, including distributions and historical values
Export backlink data for large-scale analysis

Get backlink summary

GET / POST https://api.seranking.com/v1/backlinks/summary
Cost: 100 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

To receive information about a single target:

Copy

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

  -H 'Authorization: Token YOUR_API_KEY'

To receive information about multiple targets:

Copy

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

  -H 'Authorization: Token YOUR_API_KEY'

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"

  }'

Response parameters

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

Response example

Copy

{

  "summary": [

    {

      "target": "seranking.com",

      "backlinks": 22407,

      "refdomains": 2329,

      "subnets": 1403,

      "ips": 1961,

      "nofollow_backlinks": 3718,

      "dofollow_backlinks": 18689,

      "edu_backlinks": 40,

      "gov_backlinks": 0,

      "inlink_rank": 24,

      "domain_inlink_rank": 68,

      "from_home_page_backlinks": 88,

      "dofollow_from_home_page_backlinks": 60,

      "text_backlinks": 21427,

      "dofollow_refdomains": 1291,

      "from_home_page_refdomains": 64,

      "edu_refdomains": 6,

      "gov_refdomains": 0,

      "anchors": 720,

      "dofollow_anchors": 522,

      "pages_with_backlinks": 87,

      "top_anchors_by_backlinks": [

        {"anchor": "SE Ranking","backlinks": 1853},

        {"anchor": "social listening","backlinks": 1542},

        {"anchor": "seranking.com","backlinks": 1209},

        {"anchor": "Buy SE Ranking tools - place secure order online","backlinks": 1157},

        {"anchor": "Search Engine Optimization","backlinks": 890},

        {"anchor": "the website","backlinks": 872},

        {"anchor": "SEO","backlinks": 864},

        {"anchor": "search bar (I’ve","backlinks": 849},

        {"anchor": "the site","backlinks": 836},

        {"anchor": "search bar (I have actually","backlinks": 831}

      ],

      "top_anchors_by_refdomains": [

        {"anchor": "SE Ranking","refdomains": 454},

        {"anchor": "seranking.com","refdomains": 192},

        {"anchor": "SE Ranking","refdomains": 155},

        {"anchor": "https://www.seranking.com/","refdomains": 116},

        {"anchor": "SE Ranking Pro","refdomains": 111},

        {"anchor": "seranking","refdomains": 106},

        {"anchor": "SEO software tools for results-driven site owners.","refdomains": 66},

        {"anchor": "","refdomains": 64},

        {"anchor": "SEO software tools for results-driven site owners","refdomains": 56},

        {"anchor": "Go Now","refdomains": 44}

      ],

      "top_pages_by_backlinks": [

        {"url": "https://www.seranking.com/","backlinks": 16724},

        {"url": "http://seranking.com/","backlinks": 1932},

        {"url": "https://www.seranking.com/buy.html","backlinks": 1188},

        {"url": "http://www.seranking.com/","backlinks": 900},

        {"url": "https://www.seranking.com/rank-tracker/","backlinks": 356}

      ],

      "top_pages_by_refdomains": [

        {"url": "https://www.seranking.com/","refdomains": 1235},

        {"url": "http://www.seranking.com/","refdomains": 236},

        {"url": "http://seranking.com/","refdomains": 221},

        {"url": "https://www.seranking.com/rank-tracker/","refdomains": 172},

        {"url": "https://www.seranking.com/site-audit/","refdomains": 88}

      ],

      "top_tlds": [

        {"tld": "com","count": 1183},

        {"tld": "pw","count": 112},

        {"tld": "net","count": 96},

        {"tld": "org","count": 65},

        {"tld": "it","count": 63}

      ],

      "top_countries": [

        {"country": "us","count": 1140},

        {"country": "co","count": 166},

        {"country": "sg","count": 124},

        {"country": "de","count": 87},

        {"country": "gb","count": 84}

      ]

    }

  ]

}

Get backlink metrics

GET / POST https://api.seranking.com/v1/backlinks/metrics
Cost: 100 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

To receive information about a single target:

Copy

GET: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX

&target=https://www.seranking.com&mode=url&output=json

To receive information about multiple targets:

Copy

GET: https://api.seranking.com/v1/backlinks/metrics?apikey=XXX

&target=https://www.seranking.com&target=https://www.seranking.com&mode=url&output=json

Copy

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

{

  "target": [

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

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

  ],

  "mode": "url"

}

Response parameters

Parameter	Type	Description
target	String	Aim of the request: root domain, host, or URL (e.g., `seranking.com`).
backlinks	Integer	Total number of live backlinks.
refdomains	Integer	Number of unique domains linking to a target.
ips	Integer	Number of unique IPs linking to a target.
subnets	Integer	Number of unique subnets/C-blocks linking to a target.
nofollow_backlinks	Integer	Number of backlinks marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
dofollow_backlinks	Integer	Number of backlinks NOT marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
gov_backlinks	Integer	Number of backlinks coming from .gov domains.
edu_backlinks	Integer	Number of backlinks coming from .edu domains.

Response example

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "backlinks": 22402,

      "refdomains": 2325,

      "subnets": 1399,

      "ips": 1957,

      "nofollow_backlinks": 3717,

      "dofollow_backlinks": 18685,

      "edu_backlinks": 40,

      "gov_backlinks": 0

    }

  ]

}

List all backlinks

GET / POST https://api.seranking.com/v1/backlinks/all
Cost: 1 credit per target

Returns information about backlinks pointing to a target.

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

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
per_domain	Integer	No	N/A	Number of backlinks per referring domain to be provided in the response. Passing an empty parameter returns all backlinks (even if there are more than 100). Must be within the range `[1, 100]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.
order_by	String	No	`date_found`	Field by which results are 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.
inlink_rank_from	Integer	No	`0`	InLink Rank minimum value. Returns backlinks with InLink Rank greater than or equal to the field value. Must be within the range `[0, 100]`.
inlink_rank_to	Integer	No	`100`	InLink Rank maximum value. Returns backlinks with InLink Rank less than or equal to the field value. Must be within the range `[0, 100]`.
domain_inlink_rank_from	Integer	No	`0`	Domain InLink Rank minimum value. Returns backlinks with Domain InLink Rank greater than or equal to the field value. Must be within the range `[0, 100]`.
domain_inlink_rank_to	Integer	No	`100`	Domain InLink Rank maximum value. Returns backlinks with Domain InLink Rank less than or equal to the field value. Must be within the range `[0, 100]`.
url_from_filter	String	No	N/A	Text for `url_from` parameter filter. Maximum 2063 ASCII symbols. For example: `seo-software`.
url_from_filter_mode	String	No	`contains`	Mode for filtering backlinks by `url_from`. Allowed values: `contains` – return backlinks where `url_from` contains `url_from_filter` text. `does_not_contain` – return backlinks where `url_from` doesn’t contain `url_from_filter` text. Filter not applied if `url_from_filter` parameter is not set.
url_to_filter	String	No	N/A	Text for `url_to` parameter filter. Maximum 2063 ASCII symbols. For example: `seopowersuite.com/news/`.
url_to_filter_mode	String	No	`contains`	Text for anchor parameter filter. Maximum 2063 ASCII symbols. For example: `contains`.
anchor_filter	String	No	N/A	Text for anchor parameter filter. Maximum 2063 ASCII symbols. For example: `seo`.
anchor_filter_mode	String	No	`contains`	Mode for filtering backlinks by `anchor`. Allowed values: `contains` – return backlinks where `anchor` contains `anchor_filter` text. `does_not_contain` – return backlinks where `anchor` doesn’t contain `anchor_filter` text. Filter not applied if `anchor_filter` parameter is not set.
nofollow_filter	String	No	N/A	Mode for filtering backlinks by `nofollow` attribute. Allowed values: `nofollow_only` – return backlinks with `nofollow` attribute. `dofollow_only` – return backlinks without `nofollow` attribute. All backlinks are returned if the parameter is empty.

Request examples

Copy

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

Copy

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

{

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

  "order_by": "date_found",

  "mode": "domain",

  "limit": 10,

  "per_domain": 1

}

Response parameters

Parameter	Type	Description
url_from	String	Referring page’s URL.
url_to	String	Destination page’s URL.
title	String	Referring page’s title.
anchor	String	Link anchor text for text links. Image alt text for image links.
alt	String	Deprecated, not used.
nofollow_backlinks	Boolean	Indicates whether the link has a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
image	Boolean	Indicates whether the HTML `<a>` tag containing the link includes an image.
image_source	String	Source URL of the image (for image links).
inlink_rank	Integer	InLink Rank (Page Authority) of the referring page’s URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	Date	Date when the backlink was discovered and added to the index.
last_visited	Date	Date when our crawlers last visited the referring page.

Response example

Copy

{

  "backlinks": [

    {

      "url_from": " https://zoekmachine-optimalisatie-seo.beginthier.nl/",

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

      "title": "Zoekmachine Optimalisatie (SEO)",

      "anchor": "SEO software tools",

      "alt": "",

      "nofollow": false,

      "image": false,

      "image_source": "",

      "inlink_rank": 67,

      "domain_inlink_rank": 77,

      "first_seen": "2021-11-05",

      "last_visited": "2023-06-01"

    },

    {

      "url_from": " https://zoekmachine-optimalisatie.verzamelgids.nl/",

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

      "title": "Zoekmachine Optimalisatie (SEO)",

      "anchor": "SEO software tools",

      "alt": "",

      "nofollow": false,

      "image": false,

      "image_source": "",

      "inlink_rank": 66,

      "domain_inlink_rank": 75,

      "first_seen": "2021-11-12",

      "last_visited": "2023-06-01"

    }

  ]

}

Fetch backlinks in batches

GET https://api.seranking.com/v1/backlinks/raw
Cost: 1 credit per target

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

Unlike the List all backlinks method (which supports sorting/ordering and is most commonly used to quickly get top backlinks by InLink Rank or to get the most recent backlinks), this method is aimed at fetching backlinks in batches — one batch after another.

It uses the so-called “cursor-based pagination,” which is the most efficient method of paging. A cursor refers to a random string of characters that 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.

The next parameter must not be included when requesting the first page of data. Including it will result in an error.
If the next parameter is missing in the response, this indicates the last page of data. Stop paging when the cursor is no longer returned.
This endpoint supports GET requests only; POST requests are not supported.

Request parameters

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL.
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
limit	Integer	No	`10,000`	Maximum number of results to return on one page. Must be within the range `[1, 100,000]`.
next	String	No	N/A	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; – is NOT returned in the response for the last page of data (if no more backlinks to the target exist).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.
order_by	String	No	`date_found`	Field by which results are 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.
per_domain	Integer	No	N/A	Number of backlinks per referring domain to be provided in the response. Passing an empty parameter returns all backlinks (even if there are more than 100). Must be within the range `[1, 100]`.

Request example

Copy

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

Response parameters

Parameter	Type	Description
url_from	String	Referring page’s URL.
url_to	String	Destination page’s URL.
title	String	Referring page’s title.
anchor	String	Link anchor text for text links. Image alt text for image links.
alt	String	Deprecated. Not used.
nofollow_backlinks	Boolean	Indicates whether the link has a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
image	Boolean	Indicates whether the HTML `<a>` tag containing the link includes an image.
image_source	String	Source URL of the image (for image links).
inlink_rank	Integer	InLink Rank (Page Authority) of the referring page’s URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	Date	Date when the backlink was discovered and added to the index.
last_visited	Date	Date when our crawlers last visited the referring page.
next	String	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; – is NOT returned in the response for the last page of data (if no more backlinks to the target exist).

Response examples (sample flow)

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

Copy

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

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

Copy

{

  "backlinks": [

    {

      "url_from": "https://www.pbmug.org/efficient-backlinks-checking.html",

      "url_to": "https://seranking.com/backlinks-checker.html",

      "title": "Backlinks Checker ",

      "anchor": "",

      "alt": "",

      "nofollow": false,

      "image": false,

      "image_source": "",

      "inlink_rank": 16,

      "domain_inlink_rank": 45,

      "first_seen": "2021-05-06",

      "last_visited": "2021-05-06"

    },

    {

      "url_from": "https://www.pbmug.org/seranking-enterprise-6-40-8.html",

      "url_to": "https:// seranking.com/themes/standard/images/index-scr-3-big.png",

      "title": "The best SEO software - Pbmug.org",

      "anchor": "",

      "alt": "",

      "nofollow": false,

      "image": false,

      "image_source": "",

      "inlink_rank": 15,

      "domain_inlink_rank": 45,

      "first_seen": "2021-05-06",

      "last_visited": "2021-05-06"

    }

  ],

  "next": "ezDLWp6Peqx6tE77/mV9XtWGP92lrdwTI3ZZ2b24ZPMXA/NpRCJm45biWgPerwN_0uqT9iHmZTYjeS2VRiNL7ySiFgV0KFGv9O9Y="

}

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

Copy

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

Copy

{

  "backlinks": [

    {

      "url_from": "https://fity.club/lists/1/seo-software-tools-for-resultsdriven-site-owners/",

      "url_to": "https://cdn.seranking.com/themes/standard/images/works-on.png",

      "title": "Seo Software Tools For Resultsdriven Site Owners",

      "anchor": "seranking.com",

      "alt": "",

      "nofollow": true,

      "image": false,

      "image_source": "",

      "inlink_rank": 9,

      "domain_inlink_rank": 13,

      "first_seen": "2023-08-07",

      "last_visited": "2023-08-07"

    },

    {

      "url_from": "https://www.bjskqx.com/11043.html",

      "url_to": "https://cn.seranking.com/seranking.html",

      "title": "seo外链发布有用吗，seo外链发布平台有哪些-帮发锚文本外链网",

      "anchor": "SE Ranking",

      "alt": "",

      "nofollow": false,

      "image": false,

      "image_source": "",

      "inlink_rank": 15,

      "domain_inlink_rank": 38,

      "first_seen": "2023-07-08",

      "last_visited": "2023-07-08"

    }

  ],

  "next": "sPpKCdfMEKN5zO3RsuyEZIMp7wHaJF5wuT/1tebFkazXfosEFuotIQYeHxV/beypHQ3a9DHFgCkNnh_f0cP9EoHBtcyYFuGA=="

}

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

Get total backlinks count

GET / POST https://api.seranking.com/v1/backlinks/count
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL.
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

  "target": [

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

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

  ],

  "mode": "host"

}

Response parameters

Parameter	Type	Description
target	String	Aim of the request: root domain, host, or URL (e.g., `seranking.com`).
backlinks	Integer	Total number of live backlinks.

Response example

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "backlinks": 22402

    },

    {

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

      "backlinks": 341415

    }

  ]

}

Export backlinks data

GET https://api.seranking.com/v1/backlinks/export
Cost: 1 credit per target

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

Request parameters

Note: This endpoint supports GET requests only; POST requests are not supported.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request example

Copy

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

Response parameters

Parameter	Type	Description
task_status	String	Status of the CSV file preparation task. Possible values: `queued_for_processing` – the task has successfully started preparing the requested data. `processing` – the task is currently running. `complete` – the task has successfully prepared the data. The CSV file is ready for download. `rejected` – the task couldn’t be started because a previous task is still being processed. Wait for the previous task to complete. `unknown` — the task ID is unknown, deleted, or you don’t have access. You should only query the status of tasks previously queued for processing.
task_id	String	ID of the CSV file preparation task.
download_file	String	Location of the CSV file with the requested data, ready for download.

Response examples (sample flow)

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

Copy

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

Copy

{

  "task_status": "queued_for_processing",

  "task_id": "d1d2bb44-6c66-4791-a634-26103551e2da"

}

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

Copy

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

Copy

{

  "task_status": "complete",

  "task_id": "d1d2bb44-6c66-4791-a634-26103551e2da",

  "download_file": "http://116.202.112.205/export/b/seranking.com-1695672292259.csv.gz"

}

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

Copy

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

List new and lost backlinks

GET / POST https://api.seranking.com/v1/backlinks/history
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
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.
date_from	Date	No	yesterday	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	current day (today)	End date in `YYYY-MM-DD` format (inclusive range).
link_type	String	No	“”	Type of the backlink. Possible values: `href` – standard hyperlink. `redirect` – redirect link. Passing an empty parameter will return all types of backlinks.
anchor_type	String	No	“”	Identifies whether the backlink is a text or image link. Possible values: text – text link. `image` – image link. If the anchor contains both text and an image, it is classified as image. `undefined` -anchor type is not defined. Passing an empty parameter will return backlinks with any anchor type.
dofollow	String	No	“”	Identifies whether the backlink is dofollow or nofollow. Possible values: `dofollow`, `nofollow`, `undefined`. Passing an empty parameter will return all types of backlinks.
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/`.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range [1, 10,000].
order_by	String	No	`new_lost_date`	Field by which results are 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.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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"

}

Response parameters

Parameter	Type	Description
new_lost_date	Date	Date when the link was found or lost.
new_lost_type	String	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.
url_from	String	Referring page’s URL.
url_to	String	Destination page’s URL.
title	String	Referring page’s title.
anchor	String	Link anchor text for text links. Image alt text for image links.
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.
nofollow_backlinks	Boolean	Indicates whether the link has a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
image	Boolean	Indicates whether the HTML `<a>` tag containing the link includes an image.
image_source	String	Source URL of the image (for image links).
reason-lost	String	Reason why the backlink’s status changed from live to lost. Possible values: `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 (different from a 404). `page_dropped` – the referring page was removed (dropped) from our index for a reason such as being considered untrustworthy or poorly rated. `redirect` – the referring page returned a 3XX redirect status during the re-crawl. `not_canonical` – the canonical link on the referring page now sends the crawler to another page. `noindex` – the referring page includes a `noindex` meta tag or returned a `noindex` HTTP response header. `link_removed` – the crawler didn’t find the backlink on the referring page, or a redirect previously considered 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., uncategorized internal errors).
inlink_rank	Integer	InLink Rank (Page Authority) of the referring page’s URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	Date	Reason why the backlink’s status changed from live to lost. Possible values: `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 (different from a 404). `page_dropped` – the referring page was removed (dropped) from our index for a reason such as being considered untrustworthy or poorly rated. `redirect` – the referring page returned a 3XX redirect status during the re-crawl. `not_canonical` – the canonical link on the referring page now sends the crawler to another page. `noindex` – the referring page includes a `noindex` meta tag or returns a `noindex` HTTP response header. `link_removed` – the crawler didn’t find the backlink on the referring page, or a redirect previously considered 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., uncategorized internal errors).

Response example

Copy

{

  "new_lost_backlinks": [

    {

      "new_lost_date": "2023-01-15",

      "new_lost_type": "new",

      "url_from": "https://agenciatgx.com.br/blog/melhores-ferramentas-de-seo-para-otimizar/",

      "url_to": "http://www.seranking.com/",

      "title": "Melhores Ferramentas de SEO Para Otimizar o Desempenho do Seu Site - Agência TGX",

      "anchor": "SE Ranking",

      "alt": null,

      "link_type": "href",

      "nofollow": false,

      "image": false,

      "image_source": null,

      "redirect_chain": false,

      "redirect_chain_urls": [],

      "reason_lost": null,

      "inlink_rank": 1,

      "domain_inlink_rank": 18,

      "first_seen": "2023-01-15"

    },

    {

      "new_lost_date": "2023-01-15",

      "new_lost_type": "lost",

      "url_from": "http://technicalproducts.org/category/seoandperformance",

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

      "title": "SEO & Performance – Technical Products",

      "anchor": "SE Ranking",

      "alt": null,

      "link_type": "href",

      "nofollow": false,

      "image": false,

      "image_source": null,

      "redirect_chain": false,

      "redirect_chain_urls": [],

      "reason_lost": "link_removed",

      "inlink_rank": 1,

      "domain_inlink_rank": 1,

      "first_seen": "2023-01-15"

    }

  ]

}

Get daily count of new and lost backlinks

GET / POST https://api.seranking.com/v1/backlinks/history/count
Cost: 100 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, particular URL.
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.
date_from	Date	No	yesterday	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	current day (today)	End date in `YYYY-MM-DD` format (inclusive range).
link_type	String	No	“”	Type of backlinks to be counted. Possible values: `href` – standard hyperlink. `redirect` – redirect link. Passing an empty parameter will count backlinks of all types.
anchor_type	String	No	“”	Identifies whether text or image backlinks must be counted. Possible values: text – text link. `image` – image link. If the anchor contains both text and an image, it is classified as image. `undefined` -anchor type is not defined. Passing an empty parameter will count backlinks with any anchor type.
dofollow	String	No	“”	Identifies whether dofollow, nofollow, or undefined backlinks must be counted. Possible values: `dofollow`, `nofollow`, `undefined`. Passing an empty parameter will count all types of backlinks.
url_from	String	No	“”	Allows getting 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/`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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"

}

Response parameters

Parameter	Type	Description
date	Date	Particular date for which new or lost backlinks have been counted.
new	Integer	Number of backlinks that were lost on that date and match the filters specified in the request parameters
lost	Integer	Number of backlinks that were lost on that date and match the filters specified in the request parameters.

Response example

Copy

{

  "new_lost_backlinks_count": [

    {

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

      "new": 5,

      "lost": 0

    },

    {

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

      "new": 5,

      "lost": 0

    }

  ]

}

Get cumulative backlinks over time

GET / POST https://api.seranking.com/v1/backlinks/history/cumulative
Cost: 100 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: only full page URL is supported. For example: `http://seranking.com/index.html`.
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
date_from	Date	No	yesterday	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	current day(today)	End date in `YYYY-MM-DD` format (inclusive range).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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"

}

Response parameters

Parameter	Type	Description
date	Date	Date associated with the domain rank value (for example, `2022-10-26`). The meaning of this field depends on the selected granularity: `by_week` – the first day of the corresponding week (Monday). `by_month` – the first day of the corresponding month. `by_day` – the exact day on which the rank is calculated. In the response, the first record corresponds to the first day of the requested date range. Subsequent records are returned according to the specified granularity.
backlinks	Integer	Number of live backlinks that were live at that date and match the filters specified in the request parameters.

Response example

Copy

{

"backlinks_count": [

{

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

"backlinks": 5,

},

{

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

"backlinks": 5,

}]

}

Get backlink anchor texts

GET / POST https://api.seranking.com/v1/backlinks/anchors
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which the results are sorted in descending order: `backlinks` – total number of backlinks using the anchor text. `refdomains` – total number of referring domains using the anchor text.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

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

  "order_by": "backlinks",

  "mode": "domain",

  "limit": 2

}

Response parameters

Parameter	Type	Description
anchor	String	Case-sensitive anchor text that may be empty.
backlinks	Integer	Total number of backlinks using the anchor text. Always greater than zero.
refdomains	Integer	Total number of referring domains using the anchor text. Always greater than zero.
nofollow_backlinks	Integer	Number of backlinks marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
dofollow_backlinks	Integer	Number of backlinks NOT marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
first_seen	Date	Date of the earliest backlink with the anchor pointing to the target in the index.
last_visited	Date	Last date when the backlink with the anchor pointing to the target was seen.

Response example

Copy

{ 

   "anchors": [ 

        { 

            "anchor": "SE Ranking", 

            "backlinks": 1844, 

            "refdomains": 445, 

            "dofollow_backlinks": 1595, 

            "nofollow_backlinks": 249, 

            "first_seen": "2016-12-07", 

            "last_visited": "2023-10-19" 

        }, 

        { 

            "anchor": "social listening", 

            "backlinks": 1542, 

            "refdomains": 7, 

            "dofollow_backlinks": 1542, 

            "nofollow_backlinks": 0, 

            "first_seen": "2020-04-30", 

            "last_visited": "2022-04-01" 

        } 

    ] 

}

List referring domains

GET / POST https://api.seranking.com/v1/backlinks/refdomains
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
order_by	String	No	`date_found`	Field by which the results are 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 their home page first.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

 "target":"seranking.com",

 "mode":"domain",

 "limit":2

}

Response parameters

Parameter	Type	Description
refdomain	String	Name of the referring domain.
backlinks	Integer	Total number of backlinks pointing to the target from this domain.
dofollow_backlinks	Integer	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.
first_seen	Date	Date when the oldest live backlink coming from this domain was found.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring domain.

Response example

Copy

{ 

    "refdomains": [ 

        { 

            "refdomain": "daveyandkrista.com", 

            "backlinks": 1, 

            "dofollow_backlinks": 1, 

            "first_seen": "2022-06-30", 

            "domain_inlink_rank": 73 

        }, 

        { 

            "refdomain": "isearch.avg.com", 

            "backlinks": 72, 

            "dofollow_backlinks": 72, 

            "first_seen": "2019-02-22", 

            "domain_inlink_rank": 90 

        } 

    ] 

}

Get total referring domains count

GET / POST https://api.seranking.com/v1/backlinks/refdomains/count
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

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

Copy

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

{

  "target": [

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

  ],

  "mode": "domain"

}

Response parameters

Parameter	Type	Description
target	String	Aim of the request: root domain, host, or URL (e.g., `seranking.com`).
refdomains	Integer	Number of unique domains linking to a target.

Response example

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "refdomains": 50234

    }  

]

}

List new and lost referring domains

GET / POST https://api.seranking.com/v1/backlinks/refdomains/history
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
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.
date_from	Date	No	yesterday	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	current day (today)	End date in `YYYY-MM-DD` format (inclusive range).
order_by	String	No	`new_lost_date`	Field by which the results are 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.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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"

}

Response parameters

Parameter	Type	Description
new_lost_date	Date	Date when the oldest live backlink coming from this domain was found, or the last backlink from this domain was lost.
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.
refdomain	String	Name of the referring domain.
backlinks	Integer	Total number of backlinks pointing to the target from this domain.
dofollow_backlinks	Integer	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.
first_seen	Date	The date when the oldest live backlink coming from this domain was found.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring domain.

Response example

Copy

{

  "new_lost_refdomains": [

    {

      "new_lost_date": "2023-01-16",

      "new_lost_type": "new",

      "refdomain": "agenzia-seo.it",

      "backlinks": 1,

      "dofollow_backlinks": 1,

      "first_seen": "2023-01-16",

      "domain_inlink_rank": 32

    },

    {

      "new_lost_date": "2023-01-15",

      "new_lost_type": "lost",

      "refdomain": "doso.com.au",

      "backlinks": 1,

      "dofollow_backlinks": 1,

      "first_seen": "2023-01-15",

      "domain_inlink_rank": 25

    }

  ]

}

Get daily count of new and lost referring domains

GET / POST https://api.seranking.com/v1/backlinks/refdomains/history/count
Cost: 100 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (`seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
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.
date_from	Date	No	yesterday	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	current day (today)	End date in `YYYY-MM-DD` format (inclusive range).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

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

  "mode": "domain",

  "new_lost_type": "new",

  "date_from": "2023-01-15",

  "date_to": "2023-01-16"

}

Response parameters

Parameter	Type	Description
date	date	Number of new referring domains that were found on that date and match the filters specified in the request parameters.
new	Integer	Number of new referring domains that were found on that date and match the filters specified in the request parameters.
lost	Integer	Number of referring domains that were lost at that date and match the filters specified in the request parameters.

Response example

Copy

{

"new_lost_refdomains_count": [

    {

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

      "new": 4,

      "lost": 0

    },

    {

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

      "new": 3,

      "lost": 0

    }

  ]

}

List referring IPs

GET / POST https://api.seranking.com/v1/backlinks/referring-ips
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which results are sorted in descending order: `backlinks` – total number of backlinks using the anchor text. `refdomains` – total number of referring domains using the anchor text.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

POST: https://api.seranking.com/v1/backlinks/referring-ips?apikey=XXX&output=json

{

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

  "order_by": "backlinks",

  "mode": "domain",

  "limit": 2

}

Response parameters

Parameter	Type	Description
ip	String	IPv4 address that serves at least one page linking to the target.
backlinks	Integer	Total number of backlinks that point to the target and are served from the IP address. Always greater than zero.
refdomains	Integer	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.
nofollow_backlinks	Integer	Number of backlinks marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
dofollow_backlinks	Integer	Number of backlinks NOT marked as nofollow with a `rel=”nofollow”` attribute in the `<a>` tag or `robots` meta tag.
first_seen	Date	Date of the earliest backlink that points to the target and is served from the IP address.
last_visited	Date	Date of the latest backlink that points to the target and is served from the IP address.

Response examples

Copy

{

  "ips": [

    {

      "ip": "123.234.23.43",

      "backlinks": 188,

      "refdomains": 144,

      "first_seen": "2020-10-19",

      "last_visited": "2022-03-15"

    },

    {

      "ip": "32.114.53.3",

      "backlinks": 68,

      "refdomains": 60,

      "first_seen": "2019-04-24",

      "last_visited": "2022-02-21"

    }

  ]

}

Get total referring IPs count

GET / POST https://api.seranking.com/v1/backlinks/referring-ips/count
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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"

}

Response parameters

Parameter	Type	Description
target	String	Aim of the request: root domain, host, or URL (e.g., `seranking.com`).
ips	Integer	Number of unique IPs linking to a target.

Response example

Copy

{

  "metrics": [

    {

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

      "ips": 75

    },

    {

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

      "ips": 2493

    }

  ]

}

Get total referring subnets count

GET / POST https://api.seranking.com/v1/backlinks/referring-subnets/count
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

  "target": [

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

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

  ],

  "mode": "host"

}

Response parameters

Parameter	Type	Description
target	String	Aim of the request: root domain, host, or URL (e.g., `seranking.com`).
subnets	Integer	Number of unique subnets/C-blocks linking to a target (e.g., `50`).

Response example

Copy

{

  "metrics": [

    {

      "target": "seranking.com",

      "subnets": 1399

    },

    {

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

      "subnets": 7690

    }

  ]

}

List indexed pages with backlinks

GET / POST https://api.seranking.com/v1/backlinks/indexed-pages
Cost: 1 credit per target

Returns information about site pages that belong to a target. The target parameter accepts only a single value. A page is included in the response if at least one backlink references it. If a page that was previously referenced no longer has any backlinks, it is excluded from the response.

The returned list doesn’t contain duplicate pages. Difference in protocols is taken into account; otherwise, the same pages are treated as non-duplicates.

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain), or URL (`seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which results are sorted in descending order: `backlinks` – total number of backlinks using the anchor text. `refdomains` – total number of referring domains using the anchor text.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range `[1, 10,000]`.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

POST: https://api.seranking.com/v1/backlinks/indexed-pages?apikey=XXX&output=json

{

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

  "order_by": "backlinks",

  "mode": "domain",

  "limit": 2

}

Response parameters

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

Response example

Copy



{

  "pages": [

{

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

      "backlinks": 16696,

      "refdomains": 1227,

      "dofollow_backlinks": 14708,

      "nofollow_backlinks": 1978,

      "first_seen": "2017-01-03",

      "last_visited": "2023-10-23"

    },

    {

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

      "backlinks": 1926,

      "refdomains": 220,

      "dofollow_backlinks": 1254,

      "nofollow_backlinks": 671,

      "first_seen": "2017-09-15",

      "last_visited": "2023-10-21"

    }

  ]

}

Get page and domain authority

GET / POST https://api.seranking.com/v1/backlinks/authority
Cost: 100 credits per target

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

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

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain) or URL (e.g., `seranking.com`).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

To receive information about a single target:

Copy

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

To receive information about multiple targets:

Copy

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

{

    "target":

    [ 

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

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

    ]

}

Response parameters

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

Response example

Copy

{

  "pages": [

    {

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

      "inlink_rank": 40,

      "domain_inlink_rank": 68

    }

  ]

}

Get domain authority

GET / POST https://api.seranking.com/v1/backlinks/authority/domain
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain, or URL (e.g., `seranking.com`).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

  "target": [

    "https://seranking.com/",

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

  ]

}

Response parameters

Parameter	Type	Description
url	String	URL of a page that belongs to specified in request target and mode (e.g., `seranking.com`).
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the target’s root domain (e.g., `68`).

Response example

Copy

{

  "pages": [

    {

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

      "domain_inlink_rank": 68

    },

    {

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

      "domain_inlink_rank": 87

    }

  ]

}

Get distribution of domain authority

GET https://api.seranking.com/v1/backlinks/authority/domain/distribution
Cost: 1 credit per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain, or URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: `domain` (.example.com/) – analyzes all URLs that belong to this domain, including its subdomains. `host` (www.example.com/*) – analyzes all URLs that belong to this host (subdomains excluded). `url` (http://www.example.com/) – analyzes a single, specific URL.
histogramMode	String	No	`host`	Mode of aggregation: `domain` – for each unique Domain InLink Rank value number of base domains with that rank will be calculated. `host` – for each unique Domain InLink Rank value number of hosts with that rank will be calculated.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request example

Copy

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

Response parameters

Parameter	Type	Description
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority). Only those DR values are returned that correspond to at least one referring to the specified target domain (e.g., `68`).
refdomains	Integer	Number of referring domains with the specified Domain InLink Rank (e.g., `123`).

Response example

Copy

{

    "histogram": [

        {

            "domain_inlink_rank": 0,

            "refdomains": 250

        },

        {

            "domain_inlink_rank": 1,

            "refdomains": 872

        },

        {

            "domain_inlink_rank": 2,

            "refdomains": 567

        },

        {

            "domain_inlink_rank": 3,

            "refdomains": 347

        },

        {

            "domain_inlink_rank": 4,

            "refdomains": 268

        }

]

}

Get page authority

GET / POST https://api.seranking.com/v1/backlinks/authority/page
Cost: 10 credits per target

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

Request parameters

Note:

The apikey (required) and output (optional) parameters must always be included as GET parameters, even if other parameters are sent via POST.
Any POST data in the request body should be in JSON format.

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: root domain, host (subdomain, or URL (e.g., `seranking.com`).
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request examples

Copy

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

Copy

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

{

  "target": [

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

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

  ]

}

Response parameters

Parameter	Type	Description
url	String	URL of a page that belongs to specified in request target and mode (e.g., `seranking.com`).
inlink_rank	Integer	InLink Rank (Page Authority) of the target URL (e.g., `21`).

Response example

Copy

{

  "pages": [

    {

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

      "inlink_rank": 19

    },

    {

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

      "inlink_rank": 49

    }

  ]

}

Get page authority history

GET https://api.seranking.com/v1/backlinks/authority/page/history
Cost: 1 credit per target

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

Request parameters

Parameter	Type	Required	Default (if not specified in request)	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Aim of the request: only full page URL is supported (e.g., `http://seranking.com/index.html`).
date_from	Date	No	now – 1 month	Start date in `YYYY-MM-DD` format (inclusive range).
date_to	Date	No	now	End date in `YYYY-MM-DD` format (inclusive range).
granularity	Enumeration	No	`by_day`	Granularity at which to return data (e.g., `by_month`, `by_week`, `by_day`). Aggregation is the latest value within an aggregated range.
output	String	No	`json`	Output format: `json` – get response in JSON format. `xml` – get response in XML format.

Request example

Copy

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

Response parameters

Parameter	Type	Description
date	Date	Date associated with the domain rank value (e.g., `2022-10-26`). The meaning of this field depends on the selected granularity: by_week – the first day of the corresponding week (Monday). by_month – the first day of the corresponding month. by_day – the exact day on which the rank is calculated. In the response, the first record corresponds to the first day of the requested range. Subsequent records are returned according to the specified granularity.
inlink_rank	Integer	InLink Rank for a date (e.g., `68`).

Response example

Copy

{

    "ranks": [

        {

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

            "inlink_rank": 54

        },

        {

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

            "inlink_rank": 32

        },

        {

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

            "inlink_rank": 21

        }

    ]

}

Backlinks

You are reading the Data API docs

Get backlink summary

Request parameters

Request examples

Response parameters

Response example

Get backlink metrics

Request parameters

Request examples

Response parameters

Response example

List all backlinks

Request parameters

Request examples

Response parameters

Response example

Fetch backlinks in batches

Request parameters

Request example

Response parameters

Response examples (sample flow)

Get total backlinks count

Request parameters

Request examples

Response parameters

Response example

Export backlinks data

Request parameters

Request example

Response parameters

Response examples (sample flow)

List new and lost backlinks

Request parameters

Request examples

Response parameters

Response example

Get daily count of new and lost backlinks

Request parameters

Request examples

Response parameters

Response example

Get cumulative backlinks over time

Request parameters

Request examples

Response parameters

Response example

Get backlink anchor texts

Request parameters

Request examples

Response parameters

Response example

List referring domains

Request parameters

Request examples

Response parameters

Response example

Get total referring domains count

Request parameters

Request examples

Response parameters

Response example

List new and lost referring domains

Request parameters

Request examples

Response parameters

Response example

Get daily count of new and lost referring domains

Request parameters

Request examples

Response parameters

Response example

List referring IPs

Request parameters

Request examples

Response parameters

Response examples

Get total referring IPs count

Request parameters

Request examples