GetBackLinkData

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

AnalysisResUnits

5000

RetrievalResUnits

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

cmd

Required: must be set to: GetBackLinkData

datasource

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

item

Usual URL, domain or subdomain

Count

Number of results to be returned back.

Default: 100
Maximum: 50000

Mode

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

ShowDomainInfo

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

MaxSourceURLsPerRefDomain

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)

MaxSameSourceURLs

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:

http://www.example.com (source URL) links to http://www.example.org with anchor text "example" http://www.example.com (source URL) links to http://www.example.org 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.

FilterTopic

Optional: Filters the backlinks by the specified topic. Please note the topic matched may not be primary.

Values: Any topic returned by a command, e.g. Computers/Programming/Languages.

FilterTopicsRefDomainsMode

Optional: Links from the referring domain of the supplied FilterTopic will be returned.

This should be used in conjunction with ShowDomainInfo=1 as the link itself may not be of the supplied FilterTopic but it’s domain will (it may not be the primary topic)

Values: 0 (default) or 1

Example:
http://enterprise.majesticseo.com/api_command?app_api_key=API_KEY&cmd=GetBackLinkData&item=majesticseo.com&Count=5&datasource=fresh

This query in the Fresh Index produces the following XML:



http://enterprise.majesticseo.com/api/json?app_api_key=API_KEY&cmd=GetBackLinkData&item=majesticseo.com&Count=5&datasource=fresh

This query in the Fresh Index 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. TargetTopicalTrustFlow_Topic_0 - Trust Flow Categories of the target URL. Only returned in the Fresh Index. This will be numbered to mark separate categories-TargetTopicalTrustFlow_Topic_0, TargetTopicalTrustFlow_Topic_1 ...
  22. TargetTopicalTrustFlow_Value_0 - Value of the Topical Trust Flow for this category of the target URL. Only returned in the Fresh Index.This will be numbered to mark separate categories-TargetTopicalTrustFlow_Value_0, TargetTopicalTrustFlow_Value_1 ...
  23. SourceCitationFlow - CitationFlow of the source URL
  24. SourceTrustFlow - TrustFlow of the source URL
  25. SourceTopicalTrustFlow_Topic_0 - Trust Flow Categories of the source URL. Only returned in the Fresh Index. This will be numbered to mark separate categories-SourceTopicalTrustFlow_Topic_0, SourceTopicalTrustFlow_Topic_1 ...
  26. SourceTopicalTrustFlow_Value_0 - Value of the Topical Trust Flow for this category of the source URL. Only returned in the Fresh Index. This will be numbered to mark separate categories-SourceTopicalTrustFlow_Value_0, SourceTopicalTrustFlow_Value_1 ...

* Experimental values for links in high content areas

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