Majestic SEO Developer | GetBackLinkData

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.

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

This produces the following XML:

<?xml version="1.0" encoding="utf-8"?>

	<Result Code="OK" ErrorMessage="" FullError="">
	<GlobalVars IndexBuildDate="2012-08-27 02:11:30" IndexType="0" ServerBuild="2012-09-20 17:40:07" ServerName="ELEKT" ServerVersion="1.0.4646.30003" UniqueIndexID="20120827021130-HISTORICAL"/>
	<DataTables Count="1">
	<DataTable Name="BackLinks" RowsCount="10" Headers="SourceURL|ACRank|AnchorText|Date|FlagRedirect|FlagFrame|FlagNoFollow|FlagImages|FlagDeleted|FlagAltText|FlagMention|TargetURL|DomainID|FirstIndexedDate|LastSeenDate|DateLost|ReasonLost|LinkType|LinkSubType|TargetCitationFlow|TargetTrustFlow|SourceCitationFlow|SourceTrustFlow" AvailableLines="50000" BackLinkItem="majesticseo.com" BackLinkType="BackLinks" Count="10" From="0" Item="majesticseo.com" ItemType="RootDomain" OrigItem="majesticseo.com" TotalBackLinks="0" TotalLines="2500964" TotalMatches="10">
	<Row>http://tools.seobook.com/link-tools|9|majestic seo|2012-07-30|0|0|0|0|0|0|0|http://www.majesticseo.com|-1|2008-12-19|2012-07-30| | |TextLink|TextLink_Normal|56|49|60|60</Row>
	<Row>http://tools.seobook.com/competitive-research-tools|9|majestic seo|2012-07-29|0|0|0|0|0|0|0|http://www.majesticseo.com|-1|2008-11-18|2012-07-29| | |TextLink|TextLink_Normal|56|49|60|60</Row>
	<Row>http://www.stuntdubl.com|8|majestic seo|2012-07-31|0|0|0|0|0|0|0|http://www.majesticseo.com|-1|2011-06-08|2012-07-31| | |TextLink|TextLink_Normal|56|49|55|58</Row>
	<Row>http://feeds.searchengineland.com/searchcap|9|linking as a search ranking factor|2012-07-28|0|0|0|0|0|0|0|http://blog.majesticseo.com/general/links-as-search-ranking-factor/?utm_source=sel&utm_medium=scap&utm_campaign=web|-1|2012-07-28|2012-07-28| | |TextLink|TextLink_Normal|25|28|59|51</Row>
	<Row>http://www.mexconnect.com|8|view ranking information about mexconnect.com in the majestic million. click here to view ranking information for mexconnect.com...|2012-07-31|0|0|1|1|0|0|0|http://www.majesticseo.com/stats/majestic-million?domain=mexconnect.com|-1|2011-10-06|2012-07-31| | |ImageLink|ImageLink_Normal|0|0|51|55</Row>
	<Row>http://www.linkbuildingwiki.com/wiki/Main_Page|7|majesticseo|2012-07-31|0|0|0|0|0|0|0|http://www.majesticseo.com|-1|2011-04-09|2012-07-31| | |TextLink|TextLink_Normal|56|49|48|55</Row>
	<Row>http://www.webometrics.info|7|majestic seo|2012-07-31|0|0|0|0|0|0|0|http://www.majesticseo.com|-1|2012-02-03|2012-07-31| | |TextLink|TextLink_Normal|56|49|45|56</Row>
	<Row>http://www.webometrics.info|7|powered by majestic seo|2012-07-31|0|0|0|1|0|0|0|http://www.majesticseo.com|-1|2012-02-03|2012-07-31| | |ImageLink|ImageLink_Normal|56|49|45|56</Row>
	<Row>http://www.e-weblink.com|10|majesticseo|2012-07-31|0|0|0|0|0|0|0|https://www.majesticseo.com/?pk_campaign=e-weblink|-1|2012-05-31|2012-07-31| | |TextLink|TextLink_Normal|48|25|66|35</Row>
	<Row>http://www.toprankblog.com/2009/11/1-seo-tools-for-tracking-inbound-links|8|majestic|2012-07-31|0|0|1|0|0|0|0|http://www.majesticseo.com|-1|2010-05-14|2012-07-31| | |TextLink|TextLink_Normal|56|49|52|47</Row>
	</DataTable>
	</DataTables>
	</Result>

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

This produces the following JSON:

{
	"Code" : "OK",
	"ErrorMessage" : "",
	"FullError" : "",
	"IndexBuildDate" : "2013-01-28 16:23:35",
	"IndexType" : 0,
	"ServerBuild" : "2013-02-12 14:26:20",
	"ServerName" : "SILVERTHORNE",
	"ServerVersion" : "1.0.4791.25990",
	"UniqueIndexID" : "20130128162335-HISTORICAL",
	"DataTables" : {
		"BackLinks" : {
			"Headers" : {
				"AvailableLines" : 50000,
				"BackLinkItem" : "majesticseo.com",
				"BackLinkType" : "BackLinks",
				"Count" : 10,
				"From" : 0,
				"Item" : "majesticseo.com",
				"ItemType" : "RootDomain",
				"OrigItem" : "majesticseo.com",
				"TotalBackLinks" : 0,
				"TotalLines" : 2813061,
				"TotalMatches" : 10
			},
			"Data" : [
				{ "SourceURL" : "http://tools.seobook.com/competitive-research-tools", "ACRank" : 9, "AnchorText" : "majestic seo", "Date" : "2013-01-07", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2008-11-30", "LastSeenDate" : "2013-01-07", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 60, "SourceTrustFlow" : 60 },
				{ "SourceURL" : "http://tools.seobook.com/link-tools", "ACRank" : 9, "AnchorText" : "majestic seo", "Date" : "2013-01-07", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2008-11-30", "LastSeenDate" : "2013-01-07", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 60, "SourceTrustFlow" : 60 },
				{ "SourceURL" : "http://feeds.searchengineland.com/searchcap", "ACRank" : 9, "AnchorText" : "historic index update: january 2013", "Date" : "2013-01-06", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://blog.majesticseo.com/index-updates/historic-index-update-january-2013/?utm_source=sel&utm_medium=scap&utm_campaign=web", "DomainID" : -1, "FirstIndexedDate" : "2013-01-06", "LastSeenDate" : "2013-01-06", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 24, "TargetTrustFlow" : 27, "SourceCitationFlow" : 58, "SourceTrustFlow" : 49 },
				{ "SourceURL" : "http://www.mexconnect.com", "ACRank" : 8, "AnchorText" : "view ranking information about mexconnect.com in the majestic million. click here to view ranking information for mexconnect.com...", "Date" : "2013-01-07", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 1, "FlagImages" : 1, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com/stats/majestic-million?domain=mexconnect.com", "DomainID" : -1, "FirstIndexedDate" : "2011-10-16", "LastSeenDate" : "2013-01-07", "DateLost" : "", "ReasonLost" : "", "LinkType" : "ImageLink", "LinkSubType" : "ImageLink_Normal", "TargetCitationFlow" : 0, "TargetTrustFlow" : 0, "SourceCitationFlow" : 51, "SourceTrustFlow" : 54 },
				{ "SourceURL" : "http://www.linkbuildingwiki.com/wiki/Main_Page", "ACRank" : 7, "AnchorText" : "majesticseo", "Date" : "2013-01-07", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2011-03-20", "LastSeenDate" : "2013-01-07", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 48, "SourceTrustFlow" : 55 },
				{ "SourceURL" : "http://feeds.feedburner.com/seoptimise", "ACRank" : 8, "AnchorText" : "majestic seo", "Date" : "2013-01-06", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2012-04-12", "LastSeenDate" : "2013-01-06", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 50, "SourceTrustFlow" : 49 },
				{ "SourceURL" : "http://www.webometrics.info", "ACRank" : 7, "AnchorText" : "", "Date" : "2013-01-07", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 1, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2012-02-13", "LastSeenDate" : "2013-01-07", "DateLost" : "", "ReasonLost" : "", "LinkType" : "ImageLink", "LinkSubType" : "ImageLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 44, "SourceTrustFlow" : 55 },
				{ "SourceURL" : "http://www.toprankblog.com/2012/12/online-marketing-dec2112", "ACRank" : 8, "AnchorText" : "majestic seo", "Date" : "2013-01-03", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://blog.majesticseo.com/development/chrome", "DomainID" : -1, "FirstIndexedDate" : "2013-01-02", "LastSeenDate" : "2013-01-03", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 45, "TargetTrustFlow" : 32, "SourceCitationFlow" : 51, "SourceTrustFlow" : 46 },
				{ "SourceURL" : "http://www.textlinkbrokers.com/blog/2012/06/what-is-the-best-post-penguin-anchor-text-optimization-strategy", "ACRank" : 7, "AnchorText" : "majesticseo", "Date" : "2013-01-02", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2012-07-07", "LastSeenDate" : "2013-01-02", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 46, "SourceTrustFlow" : 51 },
				{ "SourceURL" : "http://www.wordtracker.com/blog/google-penguin-what-it-was-and-what-it-wasnt", "ACRank" : 7, "AnchorText" : "majestic seo", "Date" : "2012-12-22", "FlagRedirect" : 0, "FlagFrame" : 0, "FlagNoFollow" : 0, "FlagImages" : 0, "FlagDeleted" : 0, "FlagAltText" : 0, "FlagMention" : 0, "TargetURL" : "http://www.majesticseo.com", "DomainID" : -1, "FirstIndexedDate" : "2012-06-26", "LastSeenDate" : "2012-12-22", "DateLost" : "", "ReasonLost" : "", "LinkType" : "TextLink", "LinkSubType" : "TextLink_Normal", "TargetCitationFlow" : 56, "TargetTrustFlow" : 43, "SourceCitationFlow" : 44, "SourceTrustFlow" : 50 }
			]
			}
		}
}

Data table Backlinks will contain data with the following headers:

SourceURL - backlink
ACRank - legacy metric of the SourceURL, scaled down from CitationFlow
AnchorText - anchor text used (for images text used in ALT attribute of the A tag)
Date - last crawl date
FlagRedirect - if set to true then it is redirect
FlagFrame - if set to true then it is a frame
FlagNoFollow - if set to true then this link was marked as NOFOLLOW
FlagImages - if set to true then it is an image
FlagDeleted - if set to true then it was deleted (lost)
FlagAltText - if set to true then it is AltText type
FlagMention - if set to true then it is Mention type
TargetURL - target URL to which source URL linked to
FirstIndexedDate - date when this link was first indexed
LastSeenDate - date when this link was last seen
DateLost - date when this link was lost (if FlagDeleted is true)
ReasonLost - reason for loss of link, effectively last crawl code of the source link (if FlagDeleted is true)
LinkType - compact version of link type (Possible values: TextLink | ImageLink | Redirect | Frame | Mention)
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^*)
TargetCitationFlow - CitationFlow of the target URL
TargetTrustFlow - TrustFlow of the target URL
SourceCitationFlow - CitationFlow of the source URL
SourceTrustFlow - TrustFlow of the source URL