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 ... |