| Command status: | Active |
| Supported by OpenApps API: | Yes |
| Supported by Internal/Reseller API: | Yes |
| Possibly queued processing: | No |
This command 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 commands such as GetTopBackLinks.
| Resource | Description |
|---|---|
AnalysisResUnits |
AnalysisResUnits will be reduced by GetRefDomainInfoAnalysisResUnitsCost reported by GetSubscriptionInfo. Note: this command 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. |
| Parameter | Description |
|---|---|
cmd |
Required: must be set to: GetRefDomainInfo |
datasource |
Optional - defaults to historic |
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. |
<?xml version="1.0" encoding="UTF-8"?>
<Result Code="OK" ErrorMessage="" FullError="">
<GlobalVars ChargedAnalysisResUnits="1000" ChargedRetrievalResUnits="1" Cmd="GetRefDomainInfo" IndexBuildDate="2017-10-16 18:40:48" IndexType="1" RemainingAnalysisResUnits="97097051" RemainingRetrievalResUnits="19462893" ServerBuild="2017-10-13 13:57:22" ServerName="KNUTSCHR" ServerVersion="1.0.6495.23321" UniqueIndexID="20171016184048-FRESH" />
<DataTables Count="1">
<DataTable Name="DomainsInfo" RowsCount="1" Headers="RowID|OriginalItem|Status|RootDomain|AlexaRank|RefDomains|ExtBackLinks|IndexedURLs|CrawledURLs|FirstCrawled|LastSuccessfulCrawl|IP|SubNet|CountryCode|TLD|Latitude|Longitude|City|CitationFlow|TrustFlow|TopicalTrustFlow_Topic_0|TopicalTrustFlow_Value_0|TopicalTrustFlow_Topic_1|TopicalTrustFlow_Value_1|TopicalTrustFlow_Topic_2|TopicalTrustFlow_Value_2" MaxRefDomainTopics="10" RefDomainTopicsCount="3">
<Row>0|google.com|Found|google.com|1|18909418|40652517497|4457142350|621115107|2017-07-14|2017-10-15|216.58.206.14|216.58.206.0|US|com|37.4192|-122.0574|Mountain View (CA)|100|100|Computers/Internet/Searching|84|Computers/Software|82|Computers/Internet/Web Design and Development|81</Row>
</DataTable>
</DataTables>
</Result>
{
"Code": "OK",
"ErrorMessage": "",
"FullError": "",
"ChargedAnalysisResUnits": 1000,
"ChargedRetrievalResUnits": 1,
"Cmd": "GetRefDomainInfo",
"IndexBuildDate": "2017-10-16 18:40:48",
"IndexType": 1,
"RemainingAnalysisResUnits": 97096051,
"RemainingRetrievalResUnits": 19462892,
"ServerBuild": "2017-10-13 13:57:22",
"ServerName": "KNUTSCHR",
"ServerVersion": "1.0.6495.23321",
"UniqueIndexID": "20171016184048-FRESH",
"DataTables": {
"DomainsInfo": {
"Headers": {
"MaxRefDomainTopics": 10,
"RefDomainTopicsCount": 3
},
"Data": [
{
"RowID": 0,
"OriginalItem": "google.com",
"Status": "Found",
"RootDomain": "google.com",
"AlexaRank": 1,
"RefDomains": 18909418,
"ExtBackLinks": 40652517497,
"IndexedURLs": 4457142350,
"CrawledURLs": 621115107,
"FirstCrawled": "2017-07-14",
"LastSuccessfulCrawl": "2017-10-15",
"IP": "216.58.206.14",
"SubNet": "216.58.206.0",
"CountryCode": "US",
"TLD": "com",
"Latitude": "37.4192",
"Longitude": "-122.0574",
"City": "Mountain View (CA)",
"CitationFlow": 100,
"TrustFlow": 100,
"TopicalTrustFlow_Topic_0": "Computers/Internet/Searching",
"TopicalTrustFlow_Value_0": 84,
"TopicalTrustFlow_Topic_1": "Computers/Software",
"TopicalTrustFlow_Value_1": 82,
"TopicalTrustFlow_Topic_2": "Computers/Internet/Web Design and Development",
"TopicalTrustFlow_Value_2": 81
}
]
}
}
}
| Return value | Description | Global variables |
|---|---|
| Code | Code indicating if deleting a download succeeded. |
| ErrorMessage | A message explaining the error. This will be blank if the code is "OK". |
| FullError | A verbose explanation of the error. |
| IndexBuildDate | Date/time on which the index was updated. |
| IndexType | Indicates whether the index was historic or fresh. |
| ServerBuild | Date/time on which the server was built. |
| ServerName | Name of the server where the file was stored. |
| ServerVersion | The version of the server when the file was deleted. |
| UniqueIndexID | Unique identifier for the index storing the deleted item. | DomainsInfo Header |
| MaxRefDomainTopics | Maximum number of topics to return for each referring domain. |
| RefDomainTopicsCount | Number of topics returned for each referring domain. | DomainsInfo Data |
| RowID | ID for this item |
| OriginalItem | Originally requested item from which root domain was extracted |
| 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 command only returned data on crawled domains). |
| RootDomain | Root domains extracted from user submitted data |
| 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 |
| RefDomains | Number of referring domains pointing to that root domain |
| ExtBackLinks | Number of external backlinks pointing to the root domain |
| IndexedURLs | Number of unique URLs in index (includes crawled and uncrawled) |
| CrawledURLs | Number of unique URLs that were crawled |
| FirstCrawled | Date when domain was first crawled |
| LastSuccessfulCrawl | Date when domain was last successfully crawled |
| IP | IPv4 Address of the domain (note: for hosts with multiple IPs only one IP will be taken) |
| SubNet | calculated from IP |
| CountryCode | Geolocated country of hosting based on IP address |
| TLD | top level domain of the root domain |
| Latitude | Latitude of the server's location |
| Longitude | Longitude of the server's location |
| City | City locating the server hosting the item |
| Citation Flow | Citation Flow of domain |
| Trust Flow | Trust Flow of domain |
| 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 ... |
| 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 ... |