Deprecated - Scheduled for removal - Replaced by GetBackLinkData

Command status: DEPRECATED
Supported by OpenApps API: Yes
Supported by Internal/Reseller API: Yes
Possibly queued processing: Yes

This function is designed to return top backlinks (up to a limit of the subscription level that is equivalent to StandardReportBacklinksShown value shown by GetSubscriptionInfo function or on our website's page: ) for any URL, domain or subdomain regardless how large they are with a fixed cost per call to this function. This function is best way to query large domains/URLs.

N.B. This function does NOT return links flagged as Deleted, Alt Text or Mentions (FlagDeleted|FlagAltText|FlagMention)

Calls to this function will result in usage of the following subscription resources:

Resource Description


AnalysisResUnits will be reduced by GetTopBackLinksAnalysisResUnitsCost reported by GetIndexItemInfo.


RetrievalResUnits will be reduced by actual number of returned rows of data with backlinks back, up to a maximum specified by providing MaxSourceURLs parameter to this function or it's default value.

Parameter Description


Required: must be set to: GetTopBackLinks


Optional - defaults to historic
Either: "fresh" - to query against fresh index, or "historic" - to query against historic index.


Required: URL that is queried (will be converted to root domain or subdomain if optional parameters require it)


Maximum number of Source URLs (backlinks) to be returned. This number can not exceed StandardReportBacklinksShown (see GetSubscriptionInfo function).

Default: 100
Maximum: 50000

Note: actual number of backlinks can be lower than requested if there are less backlinks in index.


Optional: if enabled (set to 1) then additional data table with information on referring domains present in backlinks will be returned.

Default: 0 (Disabled)


Optional: if enabled (set to 1) then top backlinks will be returned for specified URL

Default: 1 (enabled)


Optional: if enabled (set to 1) then top backlinks will be returned to subdomain extracted from supplied URL..

Default: 0 (disabled)


Optional: if enabled (set to 1) then top backlinks will be returned to root domain extracted from supplied URL..

Default: 0 (disabled)


If set to greater than 0, then this value will limit number of backlinks (source urls) taken from any given referring domain.

If set to 1, then it will effectively produce list of referring domains with just 1 best backlink from each of them.

Default: -1 (not set)

Note: usage of this parameter does not guarantee to return requested number of MaxSourceURLs when this filtering parameter is in use because filtering will be applied after maximum top backlinks enabled for subscription were selected. This number is provided by global variable StandardReportBacklinksShown reported by GetSubscriptionInfo function.

If in doubt about this parameter please feel free to contact us at


Optional: if set to 1 then analysis request will be forced to queue request thus simulating request made to analyse a large index item. Useful when debugging software to test its handling of queued processing.


Same as in AnalyseIndexItem function



Once called this function will return (unless it was queued) list of top (by ACRank) backlinks pointing to a URL and/or subdomain/rootdomain that were extracted from URL.


This call will return free (as a special test case) top backlink pointing to homepage of as well as additional information on referring domain that can be used in re-ranking on client side. In this example the following XML was returned:

This produces the following JSON:

RemainingStandardReports variable shows how many calls to this function remain. DataTables with backlinks will have named URL, SubDomain and/or RootDomain depending on what data was requested.

  1. SourceURL - URL on which the link was found
  2. ACRank - AC rank of source URL
  3. AnchorText - Anchor text of link
  4. Date - Last Crawled Date
  5. FlagRedirect - Set if the link was a redirect
  6. FlagFrame - Set if the link was contained within a Frame or IFrame
  7. FlagNoFollow - Set if the link contained rel="nofollow"
  8. FlagImages - Set if the link contained an image
  9. TargetURL - URL on which the link pointed to
  10. DomainID - links to DomainInfo Table
  11. TargetCitationFlow - Citation Flow of Target URL
  12. TargetTrustFlow - Trust Flow of Target URL
  13. SourceCitationFlow - Citation Flow of Source URL
  14. SourceTrustFlow - Trust Flow of Source URL

Optional Datatable named DomainsInfo will only be returned if parameter ShowDomainInfo was set to 1, in this case each of the source URLs will contain non-negative DomainID reference which refers to appropriate domain in that table. Data columns for the table are as follows:

  1. DomainID - As listed in table above
  2. Domain - root domain of the backlink
  3. AlexaRank - Alexa Rank of the root domain (only valid for top 1 mln domains), see more for details:
  4. RefDomains - number of referring domains pointing to that root domain
  5. ExtBackLinks - number of external backlinks pointing to the root domain
  6. IndexedURLs - number of unique URLs in index (includes crawled and uncrawled)
  7. CrawledURLs - number of unique URLs that were crawled
  8. FirstCrawled - date when domain was first crawled
  9. LastSuccessfulCrawl - date when domain was last successfully crawled
  10. IP - IPv4 Address of the domain (note: for hosts with multiple IPs only one IP will be taken)
  11. SubNet - calculated from IP
  12. CountryCode - geo-located country of hosting based on IP address
  13. TLD - top level domain of the root domain
  14. CitationFlow - Citation Flow of domain ( currently available in Fresh Index only )
  15. TrustFlow - Trust Flow of domain ( currently available in Fresh Index only )

The following charging and resource data will also be returned :

  1. ChargedAnalysisResUnits - amount of analysis res units that were charged for the call
  2. ChargedRetrievalResUnits - amount of retrieval units that were charged for the call
  3. RemainingAnalysisResUnits - amount of remaining analysis res units
  4. RemainingRetrievalResUnits - amount of remaining retrieval units

Note: this command can be queued in order to return response asynchronously (use DebugForceQueue=1 to force such behaviour for testing purposes).

For more information about access to the Majestic API suite, visit our Plans & Pricing page.