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

This function returns information of the backlinks at domain, subdomain or URL level.

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

Resource Description




This resource will be decreased by actual number of rows of data retrieved (returned) by this function.

This function accepts the following parameters:

Parameter Description


Required: must be set to: GetBackLinkData


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


Usual URL, domain or subdomain


Number of results to be returned back.

Default: 100
Maximum: 50000


Optional, 0 by default which means top links included deleted ones will be returned(GetTopBackLinks removes deleted links),

If set to 1 it will also remove deleted links - should be switch for customers


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


If set to greater than 0, then this value will limit number of 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)


Some index items (usually domains) may have more than one link out from any given source url, sometimes with different anchor text, sometimes with different flags. This parameter is designed to control maximum number of such backlinks returned.

If set to greater than 0, then it will set a limit to number of same source urls returned.

Note: Usage of this option will result in some anchor text/flags combinations not returned back.

If set to 1 it will guarantee that only unique source urls returned.

Default: -1 (not set)

Example: (source URL) links to with anchor text "example" (source URL) links to with anchor text "another example"

If this parameter is set to 1, then only the first source URL/anchor text combination will be returned. It is undefined which precise anchor text/flags combination will get priority in such case. It is recommended to use filtering flags to ensure undesired backlinks are eliminated before this parameter takes effect.


This produces the following XML:

This produces the following JSON:

Data table Backlinks will contain data with the following headers:

  1. SourceURL - backlink
  2. ACRank - legacy metric of the SourceURL, scaled down from CitationFlow
  3. AnchorText - anchor text used (for images text used in ALT attribute of the A tag)
  4. Date - last crawl date
  5. FlagRedirect - if set to true then it is redirect
  6. FlagFrame - if set to true then it is a frame
  7. FlagNoFollow - if set to true then this link was marked as NOFOLLOW
  8. FlagImages - if set to true then it is an image
  9. FlagDeleted - if set to true then it was deleted (lost)
  10. FlagAltText - if set to true then it is AltText type
  11. FlagMention - if set to true then it is Mention type
  12. TargetURL - target URL to which source URL linked to
  13. FirstIndexedDate - date when this link was first indexed
  14. LastSeenDate - date when this link was last seen
  15. DateLost - date when this link was lost (if FlagDeleted is true)
  16. ReasonLost - reason for loss of link, effectively last crawl code of the source link (if FlagDeleted is true)
  17. LinkType - compact version of link type (Possible values: TextLink | ImageLink | Redirect | Frame | Mention)
  18. LinkSubType - compact version of link subtype

    (Possible values: TextLink_Normal | TextLink_AltText | TextLink_Normal_HighContent* | TextLink_AltText_HighContent* | ImageLink_Normal | ImageLink_HiddenImage | ImageLink_HighContent* | Redirect_Mixed | Redirect_Permanent | Redirect_Temporary | Redirect_META | Redirect_Permanent_Chain | Redirect_Temporary_Chain | Redirect_Other | Redirect_Canonical | Frame_Mixed | Frame_FRAME | Frame_IFRAME | Mention_Mixed | Mention_HighContent*)

  19. TargetCitationFlow - CitationFlow of the target URL
  20. TargetTrustFlow - TrustFlow of the target URL
  21. SourceCitationFlow - CitationFlow of the source URL
  22. SourceTrustFlow - TrustFlow of the source URL

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