GetRefDomainInfo

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

This function is designed to return key backlink counts for a large number of root domains that were crawled such as those that were returned as part of any of the backlink functions such as GetTopBackLinks.

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

Resource Description

AnalysisResUnits

AnalysisResUnits will be reduced by GetRefDomainInfoAnalysisResUnitsCost reported by GetSubscriptionInfo. Note: this function is fixed cost per call and it supports batching of large number of query items - use it to obtain data efficiently.

RetrievalResUnits

RetrievalResUnits will be reduced by actual number of returned rows of data.

This function accepts the following parameters:

Parameter Description

cmd

Required: must be set to: GetRefDomainInfo

datasource

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

items

Required: Maximum of items (root domains) to check.

Must be a positive integer from 0 to maximum of 999 indicating how many items this query supplies in itemN parameters item0, item1 ... itemN One or more items starting from item0 that information

item0, item1 ... itemN

One or more items (root domains) starting from item0 up to maximum supplier number of items. If hostname (subdomain) is provided then root domain will be extracted from it.

Example:
https://api.majestic.com/api/xml?app_api_key=APP_KEY&cmd=GetRefDomainInfo&items=1&item0=google.com&datasource=fresh

This query in the Fresh Index produces the following XML:



Example:
https://api.majestic.com/api/json?app_api_key=APP_KEY&cmd=GetRefDomainInfo&items=1&item0=google.com&datasource=fresh

This query in the Fresh Index produces the following JSON:

Data is returned back in tabled named DomainsInfo with columns as follows:

  1. OriginalItem - originally requested item from which root domain was extracted
  2. Status - status: Found if domain was located, NotFound otherwise (note: this status does not mean we have no such domain in index, use GetIndexItemInfo for conclusive data as this function only returned data on crawled domains).
  3. RootDomain - root domains extracted from user-submitted data
  4. AlexaRank - Alexa Rank of the root domain (only valid for top 1 mln domains), see more for details: http://www.alexa.com/help/traffic-learn-more
  5. RefDomains - number of referring domains pointing to that root domain
  6. ExtBackLinks - number of external backlinks pointing to the root domain
  7. IndexedURLs - number of unique URLs in index (includes crawled and uncrawled)
  8. CrawledURLs - number of unique URLs that were crawled
  9. FirstCrawled - date when domain was first crawled
  10. LastSuccessfulCrawl - date when domain was last successfully crawled
  11. IP - IPv4 Address of the domain (note: for hosts with multiple IPs only one IP will be taken)
  12. SubNet - calculated from IP
  13. CountryCode - geo-located country of hosting based on IP address
  14. TLD - top level domain of the root domain
  15. Citation Flow - Citation Flow of domain
  16. Trust Flow - Trust Flow of domain
  17. TopicalTrustFlow_Topic_0 - Trust Flow Category of the domain. Only returned in the Fresh Index. This will be numbered to mark separate categories-TopicalTrustFlow_Topic_0, TopicalTrustFlow_Topic_1 ...
  18. TopicalTrustFlow_Value_0 - Value of the Topical Trust Flow for this category of the domain. Only returned in the Fresh Index. This will be numbered to mark separate categories-TargetTopicalTrustFlow_Value_0, TargetTopicalTrustFlow_Value_1 ...

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