enEnglish

Why SE Ranking
- column
  - Scalable solution
- column
  - Trusted by users
- column
  - ABOUT SE Ranking
- All-in-one SEO platform
Features
- column
  - Featured tools
  - Other products in our family
    - SE Visible
      Analyze AI visibility strategically
    - Planable
      Manage your socials as a team
- column
  - AI Toolkit
  - Keyword research
    - Keyword Tool
    - Keyword Grouper
  - Content Marketing
- column
  - Other seo tools
  - Tools for agencies
  - Explore all features
- All features
- Win the AI search game with AI Search Toolkit. Start with the right tools
Plans & pricing
Resources
- column
  - Education
    - SEO Blog
      Thorough SEO guides, client case studies, and more
    - Webinars
      On-demand and upcoming online events with industry experts
    - Academy
      Practical online courses for SEO experts and agency owners
- column
  - user resources
    - Agency Hub
      Ultimate Guide to Navigating for Agency Success
    - Agency Catalog
      Handpicked list of leading SEO agencies worldwide
    - How to pick an SEO agency
      Tips for finding the right agency for you
    - What’s new?
      Latest product updates from the SE Ranking team

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. Data is refreshed on a monthly basis.

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 extended statistics for a target, including the number of backlinks, referring domains, subnets, IPs, top anchors, top TLDs, and more. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (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'

GET (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'

POST (multiple targets)

Copy

curl -X POST \

  'https://api.seranking.com/v1/backlinks/summary?output=json' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -d '{

    "target": [

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

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

    ],

    "mode": "host"

  }'

Response parameters

Parameter	Type	Description
target	String	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
backlinks	Integer	Number of live backlinks linking to the target.
refdomains	Integer	Number of unique domains linking to the target.
subnets	Integer	Number of unique subnets (C-blocks) linking to the target.
ips	Integer	Number of unique IP addresses linking to the target.
nofollow_backlinks	Integer	Number of backlinks classified as nofollow.
dofollow_backlinks	Integer	Number of backlinks classified as dofollow.
from_home_page_backlinks	Integer	Number of backlinks originating from the home page of the referring domain.
dofollow_from_home_page_backlinks	Integer	Number of dofollow backlinks originating from the home page of the referring domain.
text_backlinks	Integer	Number of backlinks with text anchors.
edu_backlinks	Integer	Number of backlinks originating from `.edu` domains.
gov_backlinks	Integer	Number of backlinks originating from .gov domains.
inlink_rank	Integer	InLink Rank (Page Authority) of the target URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the target’s root domain.
dofollow_refdomains	Integer	Number of referring domains with at least one dofollow backlink.
from_home_page_refdomains	Integer	Number of referring domains linking from the home page.
edu_refdomains	Integer	Number of `.edu` referring domains.
gov_refdomains	Integer	Number of `.gov` referring domains.
anchors	Integer	Number of unique anchor texts used across all backlinks.
dofollow_anchors	Integer	Number of unique anchor texts used in dofollow backlinks.
pages_with_backlinks	Integer	Number of target pages that have at least one backlink.
top_anchors_by_backlinks	Array	Top anchor texts sorted by number of backlinks (descending).
top_anchors_by_backlinks.anchor	String	Anchor text used in backlinks (by total backlinks).
top_anchors_by_backlinks.backlinks	Integer	Number of backlinks using this anchor text.
top_anchors_by_refdomains	Array	Top anchor texts sorted by number of referring domains (descending).
top_anchors_by_refdomains.anchor	String	Anchor text used in backlinks (by referring domains).
top_anchors_by_refdomains.refdomains	Integer	Number of referring domains with at least one backlink using this anchor text.
top_pages_by_backlinks	Array	Target pages sorted by number of backlinks (descending).
top_pages_by_backlinks.url	String	URL of the target page.
top_pages_by_backlinks.backlinks	Integer	Number of backlinks pointing to this page.
top_pages_by_refdomains	Array	Target pages sorted by number of referring domains (descending).
top_pages_by_refdomains.url	String	URL of the target page.
top_pages_by_refdomains.refdomains	Integer	Number of referring domains pointing to this page.
top_tlds	Array	Top-level domains (TLDs) sorted by number of backlinks (descending).
top_tlds.tld	String	Top-level domain (e.g., `.com`).
top_tlds.count	Integer	Number of backlinks originating from this TLD.
top_countries	Array	Top countries sorted by number of backlinks (descending).
top_countries.country	String	Country code.
top_countries.count	Integer	Number of backlinks originating from this country.

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, including the number of backlinks and referring domains. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (single target)

Copy

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

GET (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

POST (multiple targets)

Copy

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

{

  "target": [

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

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

  ],

  "mode": "url"

}

Response parameters

Parameter	Type	Description
target	String	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
backlinks	Integer	Number of live backlinks linking to the target.
refdomains	Integer	Number of unique domains linking to the target.
ips	Integer	Number of unique IP addresses linking to the target.
subnets	Integer	Number of unique subnets (C-blocks) linking to the target.
nofollow_backlinks	Integer	Number of backlinks classified as nofollow.
dofollow_backlinks	Integer	Number of backlinks classified as dofollow.
gov_backlinks	Integer	Number of backlinks originating from `.gov` domains.
edu_backlinks	Integer	Number of backlinks originating 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 backlink

Returns information about backlinks pointing to a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per request.

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.

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – 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 to return per referring domain. Must be within the range: `[1, 100]`. When set to `1`, each returned backlink comes from a different referring domain. If empty, all backlinks are returned, even beyond the limit of 100.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.
order_by	String	No	`date_found`	Field by which results are sorted: • `date_found` – returns the most recent 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`	Minimum InLink Rank. Returns backlinks ≥ this value. Must be within the range: `[0, 100]`.
inlink_rank_to	Integer	No	`100`	Maximum InLink Rank. Returns backlinks ≤ this value. Must be within the range: `[0, 100]`.
domain_inlink_rank_from	Integer	No	`0`	Minimum Domain InLink Rank. Returns backlinks ≥ this value. Must be within the range: `[0, 100]`.
domain_inlink_rank_to	Integer	No	`100`	Maximum Domain InLink Rank. Returns backlinks ≤ this value. Must be within the range: `[0, 100]`.
url_from_filter	String	No	N/A	Text filter for referring page URL (e.g., `seo-software`). Maximum 2063 ASCII symbols.
url_from_filter_mode	String	No	`contains`	Filter mode: • `contains` – returns backlinks where `url_from` contains `url_from_filter` text. • `does_not_contain` – returns backlinks where `url_from` doesn’t contain `url_from_filter` text. Ignored if `url_from_filter` parameter is not set.
url_to_filter	String	No	N/A	Text filter for destination URL (e.g., `seranking.com/blog/`). Maximum 2063 ASCII symbols.
url_to_filter_mode	String	No	`contains`	Filter mode: • `contains` – returns backlinks where `url_to` contains `url_to_filter` text. • `does_not_contain` – returns backlinks where `url_to` doesn’t contain `url_to_filter` text. Ignored if `url_to_filter` parameter is not set.
anchor_filter	String	No	N/A	Text filter for link anchor (e.g., `seo`). Maximum 2063 ASCII symbols.
anchor_filter_mode	String	No	`contains`	Filter mode: • `contains` – returns backlinks where `anchor` contains `anchor_filter` text. • `does_not_contain` – returns backlinks where `anchor` doesn’t contain `anchor_filter` text. Ignored if `anchor_filter` parameter is not set.
nofollow_filter	String	No	N/A	Filter mode: • `nofollow_only` – returns only backlinks classified as nofollow. • `dofollow_only` – returns only backlinks classified as dofollow. If empty, all backlinks are returned.

Request examples

GET

Copy

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

POST

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 URL.
url_to	String	Destination page URL.
title	String	Referring page title.
anchor	String	Link anchor text (or image alt text if the link contains an image).
nofollow	Boolean	Indicates whether the backlink is noffolow.
image	Boolean	Indicates whether the backlink contains an image.
image_source	String	Source URL of the image if present.
inlink_rank	Integer	InLink Rank (Page Authority) of the referring page.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	String	Date the backlink was first found (YYYY-MM-DD).
last_visited	String	Date the referring page was last crawled (YYYY-MM-DD).

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 backlink

Returns all backlinks pointing to a target using cursor-based pagination. Backlinks are delivered in sequential batches. This method supports pagination and doesn’t provide sorting or filtering. Unlike the List all backlinks method, which supports ordering (e.g., by InLink Rank or recency), this endpoint is designed for complete backlink retrieval, batch by batch.

Pagination is handled via a cursor (next parameter). The cursor marks a specific position in the dataset and remains valid unless the item is removed. Cursors are typically valid for up to 24 hours, even if new backlinks are added.

The next parameter must not be included when requesting the first page of data. Doing so will return an error.
If the response doesn’t return next, you have reached the last page of data.

Request parameters

Parameter	Type	Required	Default	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
limit	Integer	No	`10,000`	Maximum number of results to return in one page. Must be within the range: `[1, 100,000]`.
next	String	No	N/A	Cursor pointing to the end of the previously returned page. • Must not be included for the first page request. • Not returned in the last page of data.
output	String	No	`json`	Response format (`json` or `xml`).
per_domain	Integer	No	N/A	Coming soon. Number of backlinks to return per referring domain. Must be within the range: `[1, 100]`. When set to `1`, each returned backlink comes from a different referring domain. If empty, all backlinks are returned, even beyond the limit of 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 URL.
url_to	String	Destination page URL.
title	String	Referring page title.
anchor	String	Link anchor text (or image alt text if the link contains an image).
nofollow	Boolean	Indicates whether the backlink is nofollow.
image	Boolean	Indicates whether the backlink contains an image.
image_source	String	Source URL of the image if present.
inlink_rank	Integer	InLink Rank (Page Authority) of the referring page.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	String	Date the backlink was first found (YYYY-MM-DD).
last_visited	String	Date the referring page was last crawled (YYYY-MM-DD).
next	String	Cursor pointing to the end of the returned page of data. Not included if this is the last page.

Response examples (pagination flow)

Step 1. Request the first page of data for a target. The example below returns the first batch of backlinks for the domain seranking.com.

Important: Do NOT include the next parameter when requesting the first page. Including it will result in an error.

Copy

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

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. Retrieve the next page using the next value 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. Continue requesting pages until the next parameter is no longer returned. This indicates that the last page of data has been reached.

Get total backlinks count

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

Returns the total number of backlinks for a target. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (single target)

Copy

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

POST (multiple targets)

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	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
backlinks	Integer	Total number of live backlinks pointing to the target.

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 backlink

Exports information about all backlinks pointing to a target. Due to the potentially large data volume, this endpoint works asynchronously and returns the complete dataset as a downloadable .csv.gz file once processing is complete.

Request parameters

Parameter	Type	Required	Default	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`).

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 export task: • `queued_for_processing` – task accepted and queued. • `processing` – task is running. • `complete` – export is ready for download. • `rejected` – another export task is already in progress. • `unknown` — task ID is invalid or inaccessible.
task_id	String	Unique ID of the export task.
download_file	String	Location of the generated `.csv.gz` file (available when status is `complete`).

Response examples (export flow)

Step 1. Queue the export task.

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. Poll task status using 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. Download the file from download_file once complete.

Copy

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 backlink

Returns backlinks that were newly found or lost within a specified date range for a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
new_lost_type	String	No	“”	Backlink status filter: • `new` – returns newly found backlinks. • `lost` – returns backlinks tagged as lost. If empty, both are returned.
date_from	String	No	yesterday	Start date (`YYYY-MM-DD`), inclusive.
date_to	String	No	today	End date (`YYYY-MM-DD`), inclusive.
link_type	String	No	“”	Type of backlink: • `href` – returns standard hyperlinks. • `redirect` – returns redirect links. If empty, all types are returned.
anchor_type	String	No	“”	Anchor type: • `text` – returns text links. • `image` – returns image links (if the anchor contains both text and an image, it is classified as image). • `undefined` – returns undefined links. If empty, all types are returned.
dofollow	String	No	“”	Follow status (`dofollow`, `nofollow`, `undefined`). If empty, all statuses are returned.
url_from	String	No	“”	Referring domain filter (including subdomains). Example: `http://seo.jouwlinkhier.nl/path` returns backlinks originating from `seo.jouwlinkhier.nl/*`. If empty, backlinks from all domains and subdomains are returned.
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: • `new_lost_date` – returns new or lost backlinks ordered by the date they were found or lost (most recent first). • `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`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

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

POST

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	String	Date when the backlink was found or lost (YYYY-MM-DD).
new_lost_type	String	Backlink status: • `new` – newly found backlinks. • `lost` – backlinks that were lost.
url_from	String	Referring page URL.
url_to	String	Destination pag URL.
title	String	Referring page title.
anchor	String	Link anchor text (or image alt text if the link contains an image).
link_type	String	Type of backlink: • `href` – standard hyperlinks. • `redirect` – redirect links.
nofollow	Boolean	Indicates whether the backlink is classified as nofollow.
image	Boolean	Indicates whether the backlink is an image link.
image_source	String	Source URL of the image if present.
reason-lost	String	Reason the backlink was lost: • `page_not_found` – referring page returned a 404 status code during re-crawl. • `crawl_error` – fetching error occurred during re-crawl (different from a 404). • `page_dropped` – referring page was removed from the index (e.g., considered untrustworthy or low quality). • `redirect` – referring page returned a 3XX redirect status during re-crawl. • `not_canonical` – canonical link on the referring page now points to another page. • `noindex` – referring page includes a noindex meta tag or returned a noindex HTTP response. • `link_removed` – backlink no longer found on the referring page. • `broken_redirect` – 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 URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the referring page’s root domain.
first_seen	String	Date when the backlink was first found (YYYY-MM-DD).

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 the daily count of newly found or lost backlinks for a specified target with the given date range. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
new_lost_type	String	No	“”	Backlink status filter: • `new` – counts newly found backlinks. • `lost` – returns backlinks tagged as lost. If empty, both are returned.
date_from	String	No	yesterday	Start date (`YYYY-MM-DD`), inclusive.
date_to	Sting	No	today	End date (`YYYY-MM-DD`), inclusive.
link_type	String	No	“”	Type of backlink: • `href` – returns standard hyperlinks. • `redirect` – returns redirect links. If empty, all types are counted.
anchor_type	String	No	“”	Anchor type: • `text` – returns text links. • `image` – returns image links (if the anchor contains both text and an image, it is classified as image). • `undefined` – returns undefined links. If empty, all types are returned.
dofollow	String	No	“”	Follow status (`dofollow`, `nofollow`, `undefined`). If empty, all statuses are counted.
url_from	String	No	“”	Referring domain filter (including subdomains). Example: `http://seo.jouwlinkhier.nl/path` returns backlinks originating from `seo.jouwlinkhier.nl/*`. If empty, backlinks from all domains and subdomains are returned.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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	String	Date for which the count is provided (YYYY-MM-DD).
new	Integer	Number of newly found backlinks on this date matching the request filters.
lost	Integer	Number of backlinks lost on this date matching the request filters.

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 the number of live backlinks for each day within the given date range for a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: only full page URL is supported (e.g., `http://seranking.com/index.html`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
date_from	String	No	yesterday	Start date (`YYYY-MM-DD`), inclusive.
date_to	String	No	today	End date (`YYYY-MM-DD`), inclusive.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

Copy

POST: https://api.seranking.com/v1/backlinks/history/cumulative?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	String	Date for which the count is provided (YYYY-MM-DD).
backlinks	Integer	Number of live backlinks on that date matching the filters specified in the request.

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 anchor text

Returns information about anchor texts of backlinks pointing to a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which results are sorted (descending): • `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`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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 (may be empty).
backlinks	Integer	Number of backlinks using this anchor text (> 0).
refdomains	Integer	Number of referring domains using this anchor text (> 0).
nofollow_backlinks	Integer	Number of backlinks classified as nofollow.
dofollow_backlinks	Integer	Number of backlinks not classified as nofollow.
first_seen	String	Date of the earliest backlink with this anchor text in the index (YYYY-MM-DD).
last_visited	String	Last date the backlink with this anchor text was seen (YYYY-MM-DD).

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 refdomain

Returns information about referring domains pointing to a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
order_by	String	No	`date_found`	Field by which results are sorted: • `new_lost_date` – returns most recent referring domains first. • `domain_inlink_rank` – returns referring domains with the highest Domain InLink Rank first. • `inlink_rank` – returns referring domains 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`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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	Number of live backlinks linking to the target from this referring domain.
dofollow_backlinks	Integer	Number of backlinks classified as dofollow.
first_seen	String	Date the oldest live backlink from this referring domain was found (YYYY-MM-DD).
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 endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (multiple targets)

Copy

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

POST (single target)

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	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
refdomains	Integer	Number of unique domains linking to the 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 refdomain

Returns referring domains for which at least one backlink was newly found or lost in the given date range for a target. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
new_lost_type	String	No	“”	Refdomain status filter: • `new` – returns referring domains from which at least one backlink was newly found. • `lost` – returns referring domains from which at least one backlink was lost. If empty, both are returned.
date_from	String	No	yesterday	Start date (`YYYY-MM-DD`), inclusive.
date_to	String	No	today	End date (`YYYY-MM-DD`), inclusive.
order_by	String	No	`new_lost_date`	Field by which results are sorted: • `new_lost_date` – returns new or lost referring domains ordered by the date they were found or lost (most recent first). • `domain_inlink_rank` – returns referring domains with the highest Domain InLink Rank first. • `inlink_rank` – returns referring domains 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`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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	String	Date when the oldest live backlink from this referring domain was found, or the last backlink from this referring domain was lost (YYYY-MM-DD).
new_lost_type	String	Refdomain status: • `new` – referring domains with at least one backlink newly found. • `lost` – referring domains with at least one backlink lost.
refdomain	String	Name of the referring domain.
backlinks	Integer	Number of backlinks linking to the target from this refdomain.
dofollow_backlinks	Integer	Number of backlinks from this referring domain classified as dofollow.
first_seen	String	Date the oldest live backlink from this refdomain was found (YYYY-MM-DD).
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 with at least one backlink newly found or lost in the given date range for a target. The data is broken down by day. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
new_lost_type	String	No	“”	Refdomain status filter: • `new` – returns referring domains from which at least one backlink was newly found. • `lost` – returns referring domains from which at least one backlink was lost. If empty, both are returned.
date_from	String	No	yesterday	Start date (`YYYY-MM-DD`), inclusive.
date_to	String	No	today	End date (`YYYY-MM-DD`), inclusive.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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	String	Date for which new or lost referring domains were counted (`YYYY-MM-DD`).
new	Integer	Number of new referring domains on this date matching the request filters.
lost	Integer	Number of lost referring domains on this date matching the request filters.

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 referring IP

Returns information about IPv4 addresses from which backlinks linking to a target originate. IPv6 addresses are not supported. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which results are sorted (descending): • `backlinks` – returns IPs with the highest number of backlinks first. • `refdomains` – returns IPs with the highest number of referring domains first.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range: `[1, 10,000]`.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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	Number of live backlinks linking to the target from this IP (> 0).
refdomains	Integer	Number of referring domains linking to the target from this IP (> 0).
nofollow_backlinks	Integer	Number of backlinks from this IP classified as nofollow.
dofollow_backlinks	Integer	Number of backlinks from this IP classified as dofollow.
first_seen	String	Date the earliest backlink from this IP was found (YYYY-MM-DD).
last_visited	String	Date the most recent backlink from this IP was last seen (YYYY-MM-DD).

Response example

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 endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (multiple targets)

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

POST (multiple targets)

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	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
ips	Integer	Number of unique IP addresses linking to the 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 endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (multiple targets)

Copy

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

GET (multiple targets)

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	Target analyzed: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
subnets	Integer	Number of unique subnets (C-blocks) linking to the 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 site page

Returns information about pages that belong to a target under the following conditions:

A page is included if it has at least one live backlink.
Pages that no longer have backlinks are excluded.

The returned list contains no duplicate pages, with protocol differences taken into account when determining page uniqueness. This endpoint supports GET and POST requests, but doesn’t support batching. Only a single target can be specified per 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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
order_by	String	No	`backlinks`	Field by which results are sorted (descending): • `backlinks` – returns pages with the highest number of backlinks first. • `refdomains` – returns pages with the highest number of referring domains first.
limit	Integer	No	`100`	Maximum number of results to return. Must be within the range: `[1, 10,000]`.
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET

Copy

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

POST

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 the target specified in the request.
backlinks	Integer	Number of live backlinks linking to the URL (> 0).
refdomains	Integer	Number of referring domains linking to the URL (> 0).
nofollow_backlinks	Integer	Number of backlinks classified as nofollow.
dofollow_backlinks	Integer	Number of backlinks classified as dofollow.
first_seen	String	Date the earliest backlink pointing to the URL was found (YYYY-MM-DD).
last_visited	String	Date the most recent backlink pointing to the URL was last seen (YYYY-MM-DD).

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 the InLink Rank (Page Authority) and Domain InLink Rank (Domain Authority) for a target. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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.

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, subdomain, or specific URL (e.g., `seranking.com`).
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (single target)

Copy

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

POST (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 the analyzed page.
inlink_rank	Integer	InLink Rank (Page Authority) of the target URL.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the target’s root domain.

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 the InLink Rank (domain authority) of the target page’s root domain. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (multiple targets)

Copy

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

POST (multiple targets)

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 the analyzed page.
domain_inlink_rank	Integer	Domain InLink Rank (Domain Authority) of the target’s root domain.

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 domain

Returns the distribution of Domain InLink Rank (Domain Authority) values for domains that link to a target. This endpoint doesn’t support batching. Only a single target can be specified per request.

Request parameters

Parameter	Type	Required	Default	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
mode	String	No	`host`	Mode of operation: • `domain` – analyzes all URLs in the domain, including subdomains. • `host` – analyzes all URLs under this host only (subdomains excluded). • `url` – analyzes a single, specific URL.
histogramMode	String	No	`host`	Mode of aggregation: • `domain` – counts base domains per Domain InLink Rank. • `host` – counts hosts per Domain InLink Rank.
output	String	No	`json`	Response format (`json` or `xml`).

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) value for which the distribution is calculated.
refdomains	Integer	Number of referring domains with the specified Domain InLink Rank.

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 the InLink Rank (Page Authority) for a target URL. This endpoint supports GET and POST requests and allows batching of up to 100 targets per request. Pass multiple targets as GET parameters separated by & or in the POST body (JSON format).

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. Must always be sent as a GET parameter.
target	String	Yes	N/A	Target to analyze: root domain, host (subdomain), or specific URL (e.g., `seranking.com`).
output	String	No	`json`	Response format (`json` or `xml`). Must always be sent as a GET parameter.

Request examples

GET (multiple targets)

Copy

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

POST (multiple targets)

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 the analyzed page.
inlink_rank	Integer	InLink Rank (Page Authority) of the target URL.

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 historical InLink Rank values for a page. This endpoint doesn’t support batching. Only a single target can be specified per request.

Request parameters

Parameter	Type	Required	Default	Description
apikey	String	Yes	N/A	API key for authentication.
target	String	Yes	N/A	Target to analyze: only full page URL is supported (e.g., `http://seranking.com/index.html`).
date_from	Date	No	now – 1 month	Start date (`YYYY-MM-DD`), inclusive.
date_to	Date	No	now	End date (`YYYY-MM-DD`), inclusive.
granularity	String	No	`by_day`	Granularity at which data is returned (`by_month`, `by_week`, `by_day`). Aggregation uses the latest value within the aggregated range.
output	String	No	`json`	Response format (`json` or `xml`).

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	String	Date associated with the rank value. Depends on granularity: • `by_week` – first day of the week (Monday). • `by_month` – first day of the month. • `by_day` – exact day.
inlink_rank	Integer	InLink Rank value for the specified date.

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 (pagination flow)

Get total backlinks count

Request parameters

Request examples

Response parameters

Response example

Export backlinks data

Request parameters

Request example

Response parameters

Response examples (export 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 example

Get total referring IPs count

Request parameters

Request examples