GetLinkedDomains

Deprecated - Scheduled for removal - Replaced by GetRefDomains

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

This function operates on domain level, and returns information about the relationships between domains ( root domains pointing to a root domain - it does not resolve the URLs or subdomains of the backlinks ). It can be used to achieve the following:

  1. Get list of root domains with backlink counts pointing to a given root domain
  2. Find root domains which point to all, or a subset of specified root domains.

It is recommended that any result data to calls to this call is cached, and that calls to this function are minimised. A single call should made to this function to retrieve all data necessary and it should then be cached locally to serve subsequent user queries (if any) from that local cache.

Resource Description

AnalysisResUnits

Reduced by number of linked domains that will actually be considered for return controlled by AnalysisDepth parameter.

Subject to minimum cost per call as returned by GetSubscriptionInfo function (see returned value named MinGetLinkedDomainsAnalysisResUnitsCost).

Use GetIndexItemInfo to query number of referring domains pointing to a root domain to know how referring domains are present.

RetrievalResUnits

Reduced by number of referring domains actually returned.

This function accepts the following parameters:

Parameter Description

cmd

Required: must be set to: GetLinkedDomains

datasource

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

Domains

One or more comma delimited root domains for which linking in root domains with backlink counts will be returned. If more than one root domain is provided then cross match matrix will be returned showing domains as they were matched for each of the supplied root domains. Sorting of data is done by number of matches first, then by the lowest Alexa Rank (highest traffic position), and finally by backlink counts.

Maximum number of domains queries at any time should not exceed 10.

If provided value is not a root domain (ie: www.majestic.com rather than majestic.com) then root domain will be extracted from that string and data will be returned for that root domain only.

Count

Number of results to be returned back.

Default: 100

AnalysisDepth

Maximum number of referring domains to be used for each of the root domains queried in case they have more. If number of referring domains exceeds this value then top domains will be used. Sorting criteria in this case is subject to change but current is AlexaRank in ascending order thus giving preference to domains with more traffic.

Default: 1000 Maximum: 100000

MinMatchesRequired

Minimum number of matches required - useful to limit the list of cross matched domains to only those that have at least 2 or more matches.

Default: 1

OrderBy1

Integer value that controls how results will be ordered (sorted):

0: sorted by number of matches
1: AlexaRank (lowest number means higher traffic)
2: number of referring root domains linking to a root domain.
3: number of external backlinks linking to a root domain.
4: number of URLs from root domain added to our index, includes both crawled and uncrawled URLs.
5: number of URLs from root domain that were crawled by our crawlers.
6: The date when this root domain was first crawled: this can be treated as "domain age" with earliest date being Jun 2006 - any domain close to this date may have existed before
7: The date when we last successfully crawled any URL on this root domain
8: IP address of the domain.
9: C-class subnet of the IP address of the domain
10: Country code of the domain where it is hosted based on geo-location of its IP address
11: Number of matched links (useful when querying data for multiple domains)

This parameter can be combined with secondary sorting.

OrderDir1

Direction of sorting: 1 for descending, 0 - ascending.

OrderBy2

Secondary sorting parameter - input values are the same OrderBy1.

OrderDir2

Direction of sorting for secondary sorting parameter.

Example:
https://api.majestic.com/api/xml?app_api_key=API_KEY&cmd=GetLinkedDomains&Domains=google.com&count=10

This produces the following XML:



Example:
https://api.majestic.com/api/json?app_api_key=API_KEY&cmd=GetLinkedDomains&Domains=google.com&count=10

This produces the following JSON:

Global Variables

The first table shows requested domains in their original form (even if it was URL) and with actual root domain for which query was run. This table is useful to ensure application displays actual root domain that was used rather than what user may have provided (URL or subdomain). It also provides number of linked domains each queried root domain had in column TotalRefDomains - it gives useful indication on whether supplied AnalysisDepth was appropriate for analysis of given domain.

Results datatable provides actual results that in case of more than one supplied root domain will be a cross match matrix. The header for this table consists of first few elements that are always the same and additional elements repeated for each of the requested root domains.

Common elements (number will increase in the future, use "ColumnsForGlobalInfo" provided in the same DataTable header)

  1. Position: position in results
  2. Domain: referring domain name
  3. RefDomains: number of referring domains pointing to found referring domain (effectively link authority of that domain)
  4. AlexaRank - traffic rank of the root domain from Alexa (only used for the first 1,000,000 domains, value of -1 indicates we do not have Alexa's traffic rank for that domain)
  5. Matches: number of matches of this referring domain in requested root domains, ie: if 2 were requested, then 2 matches means that root domain was present in backlinks of both root domains.
  6. MatchedLinks: total number of backlinks this root domain has got in all matched requested root domains
  7. ExtBackLinks: number of external links pointing to found referring domain
  8. IndexedURLs: number of indexed (known) URLs on found referring domain - this can be viewed as content size of the domain
  9. CrawledURLs: number of crawled URLs on found referring domain - this can be viewed as content size of the domain
  10. FirstCrawled: the date when referring domain was first crawled, this can be treated as domain age (not the same as WHOIS data)
  11. LastSuccessfulCrawl: the date when referring domain was last successfully crawled
  12. IP: IP address of the domain (empty if no data available)
  13. SubNet: Class C subnet of the domain (empty if no IP data available)
  14. CountryCode: GEO located country code of where domain is hosted (empty if no IP data available)
  15. TLD: Top Level Domain extracted from root domain
  16. Citation Flow: Citation Flow of domain ( currently available in Fresh Index only )
  17. Trust Flow: Trust Flow of domain ( currently available in Fresh Index only )

Domain specific elements (number can vary and provided in ColumnsPerRequestedDomain variable), for uniqueness of the field each variable has got requested root domain

  1. BackLinks_xxxx: number of backlinks from referring root domain pointing to domain xxxx
  2. FirstLinkDate_xxxx: date when the first link from that referring root domain was found to point to requested root domain xxxx
  3. LastLinkDate_xxxx: date when the last link from that referring root domain was found to point to requested root domain xxxx

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