Command status: | Active |
Supported by OpenApps API: | Yes |
Supported by Internal/Reseller API: | Yes |
Possibly queued processing: | No |
This command returns the amount of Analysis Resource units that will be used by the DownloadBacklinks command.
Resource | Description |
---|---|
IndexItemInfoResUnits |
This resource will be decreased by the number of items that were queried by this command. |
Parameter | Description |
---|---|
cmd |
Required: must be set to: GetIndexItemInfo |
datasource |
Optional - defaults to historic |
items |
Required: must be a positive integer from 1 to maximum of 100 indicating how many items this query supplies in itemN parameters |
item0, item1 ... itemN |
One or more items starting from item0 that information Note: do not forget to URL encode each item even if item may already contain URL encoding. |
DesiredTopics |
Optional: The number of trust flow topics which will be displayed, this is limited to 30 for Domains, 20 for Subdomains and 10 for URL. Default: 3 |
AddAllTopics |
Optional: When AddAllTopics=1, This call will return a column called TrustCategories with data similar to below: Society/Government=19.99%=33,Reference/Education=9.10%=28 |
EnableResourceUnitFailover |
Optional: When all IndexItemInfo resource units have been used, setting this parameter to 1 will use Analysis and Retreival Resource units at the rate of 500 Analysis Resource Units per call, plus 50 Analysis Resource Units per item, and 1 Retrieval Resource Unit per item. Default: 0 |
This command returns key information about "index items":
<?xml version="1.0" encoding="UTF-8"?> <Result Code="OK" ErrorMessage="" FullError=""> <GlobalVars FirstBackLinkDate="2017-07-13" IndexBuildDate="2017-10-15 16:23:38" IndexType="1" MostRecentBackLinkDate="2017-10-14" QueriedRootDomains="0" QueriedSubDomains="0" QueriedURLs="1" QueriedURLsMayExist="0" ServerBuild="2017-10-13 13:57:22" ServerName="QUACKYO" ServerVersion="1.0.6495.23321" UniqueIndexID="20171015162338-FRESH" /> <DataTables Count="1"> <DataTable Name="Results" RowsCount="1" Headers="ItemNum|Item|ResultCode|Status|ExtBackLinks|RefDomains|AnalysisResUnitsCost|ACRank|ItemType|IndexedURLs|GetTopBackLinksAnalysisResUnitsCost|DownloadBacklinksAnalysisResUnitsCost|DownloadRefDomainBacklinksAnalysisResUnitsCost|RefIPs|RefSubNets|RefDomainsEDU|ExtBackLinksEDU|RefDomainsGOV|ExtBackLinksGOV|RefDomainsEDU_Exact|ExtBackLinksEDU_Exact|RefDomainsGOV_Exact|ExtBackLinksGOV_Exact|CrawledFlag|LastCrawlDate|LastCrawlResult|RedirectFlag|FinalRedirectResult|OutDomainsExternal|OutLinksExternal|OutLinksInternal|OutLinksPages|LastSeen|Title|RedirectTo|Language|LanguageDesc|LanguageConfidence|LanguagePageRatios|LanguageTotalPages|RefLanguage|RefLanguageDesc|RefLanguageConfidence|RefLanguagePageRatios|RefLanguageTotalPages|CrawledURLs|RootDomainIPAddress|TotalNonUniqueLinks|NonUniqueLinkTypeHomepages|NonUniqueLinkTypeIndirect|NonUniqueLinkTypeDeleted|NonUniqueLinkTypeNoFollow|NonUniqueLinkTypeProtocolHTTPS|NonUniqueLinkTypeFrame|NonUniqueLinkTypeImageLink|NonUniqueLinkTypeRedirect|NonUniqueLinkTypeTextLink|RefDomainTypeLive|RefDomainTypeFollow|RefDomainTypeHomepageLink|RefDomainTypeDirect|RefDomainTypeProtocolHTTPS|CitationFlow|TrustFlow|TrustMetric|TopicalTrustFlow_Topic_0|TopicalTrustFlow_Value_0|TopicalTrustFlow_Topic_1|TopicalTrustFlow_Value_1|TopicalTrustFlow_Topic_2|TopicalTrustFlow_Value_2" MaxTopicsRootDomain="30" MaxTopicsSubDomain="20" MaxTopicsURL="10" TopicsCount="3"> <Row>0|http://www.majestic.com/|OK|Found|390371|681|390371|6|3|1|5000|390372|63620|358|323|3|11|0|0|1|1|0|0|True|2017-10-14|HTTP_301_PermanentRedirect|True|DownloadedSuccessfully|0|0|1|1| |Majestic®: Marketing Search Engine and SEO Backlink Checker|https://majestic.com/| | | | |0| | | | |0|1| |390448|24|0|2421|388515|68837|0|388424|7|2017|662|595|19|681|0|43|32|32|Computers/Internet/Web Design and Development|29|Computers/Internet|28|Business/E-Commerce|25</Row> </DataTable> </DataTables> </Result>
{ "Code": "OK", "ErrorMessage": "", "FullError": "", "FirstBackLinkDate": "2017-07-13", "IndexBuildDate": "2017-10-15 16:23:38", "IndexType": 1, "MostRecentBackLinkDate": "2017-10-14", "QueriedRootDomains": 0, "QueriedSubDomains": 0, "QueriedURLs": 1, "QueriedURLsMayExist": 0, "ServerBuild": "2017-10-13 13:57:22", "ServerName": "QUACKYO", "ServerVersion": "1.0.6495.23321", "UniqueIndexID": "20171015162338-FRESH", "DataTables": { "Results": { "Headers": { "MaxTopicsRootDomain": 30, "MaxTopicsSubDomain": 20, "MaxTopicsURL": 10, "TopicsCount": 3 }, "Data": [ { "ItemNum": 0, "Item": "http://www.majestic.com/", "ResultCode": "OK", "Status": "Found", "ExtBackLinks": 390371, "RefDomains": 681, "AnalysisResUnitsCost": 390371, "ACRank": 6, "ItemType": 3, "IndexedURLs": 1, "GetTopBackLinksAnalysisResUnitsCost": 5000, "DownloadBacklinksAnalysisResUnitsCost": 390372, "DownloadRefDomainBacklinksAnalysisResUnitsCost": 63620, "RefIPs": 358, "RefSubNets": 323, "RefDomainsEDU": 3, "ExtBackLinksEDU": 11, "RefDomainsGOV": 0, "ExtBackLinksGOV": 0, "RefDomainsEDU_Exact": 1, "ExtBackLinksEDU_Exact": 1, "RefDomainsGOV_Exact": 0, "ExtBackLinksGOV_Exact": 0, "CrawledFlag": "True", "LastCrawlDate": "2017-10-14", "LastCrawlResult": "HTTP_301_PermanentRedirect", "RedirectFlag": "True", "FinalRedirectResult": "DownloadedSuccessfully", "OutDomainsExternal": "0", "OutLinksExternal": "0", "OutLinksInternal": "1", "OutLinksPages": "1", "LastSeen": "", "Title": "Majestic®: Marketing Search Engine and SEO Backlink Checker", "RedirectTo": "https://majestic.com/", "Language": "", "LanguageDesc": "", "LanguageConfidence": "", "LanguagePageRatios": "", "LanguageTotalPages": 0, "RefLanguage": "", "RefLanguageDesc": "", "RefLanguageConfidence": "", "RefLanguagePageRatios": "", "RefLanguageTotalPages": 0, "CrawledURLs": 1, "RootDomainIPAddress": "", "TotalNonUniqueLinks": "390448", "NonUniqueLinkTypeHomepages": "24", "NonUniqueLinkTypeIndirect": "0", "NonUniqueLinkTypeDeleted": "2421", "NonUniqueLinkTypeNoFollow": "388515", "NonUniqueLinkTypeProtocolHTTPS": "68837", "NonUniqueLinkTypeFrame": "0", "NonUniqueLinkTypeImageLink": "388424", "NonUniqueLinkTypeRedirect": "7", "NonUniqueLinkTypeTextLink": "2017", "RefDomainTypeLive": "662", "RefDomainTypeFollow": "595", "RefDomainTypeHomepageLink": "19", "RefDomainTypeDirect": "681", "RefDomainTypeProtocolHTTPS": "0", "CitationFlow": 43, "TrustFlow": 32, "TrustMetric": 32, "TopicalTrustFlow_Topic_0": "Computers/Internet/Web Design and Development", "TopicalTrustFlow_Value_0": 29, "TopicalTrustFlow_Topic_1": "Computers/Internet", "TopicalTrustFlow_Value_1": 28, "TopicalTrustFlow_Topic_2": "Business/E-Commerce", "TopicalTrustFlow_Value_2": 25 } ] } } }
Returned value | Description | Global variables |
---|---|
Code | Code indicating whether this command succeeded. |
ErrorMessage | A message explaining the error. This will be blank if the code is "OK". |
FullError | Verbose explanation of error. |
FirstBackLinkDate | Date where the first backlink to this page was found. |
IndexType | Boolean indicating if the index queried was Historical (0) or Fresh (1). |
MostRecentBackLinkDate | Date of the most recent backlink to this page in the current index. |
QueriedRootDomains | Number of root domains queried. |
QueriedSubDomains | Number of subdomains queried. |
QueriedURLs | Number of URLs queried. |
QueriedURLsMayExist | Boolean indicating if the URL(s) queried may have been lost. |
ServerBuild | Date/time of the server build when this command was executed. |
ServerName | Name of the server queried when this command was executed. |
ServerVersion | Version of the server queried. |
UniqueIndexID | Unique identifier for the index queried when this command was executed. | Results Headers |
MaxTopicsRootDomain | Number of maximum topics in the root domain. |
MaxTopicsSubDomain | Number of maximum topics in the sub domain. |
MaxTopicsURL | Number of maximum topics for this given URL. |
TopicsCount | Number of topics returned. | Data |
ItemNum | Position of this item in the parameter list. |
Item | URL to be checked. |
ResultCode | Code indicating the status of the query for this item. |
Status | Status of the command for this item. |
ExtBackLinks | Number of external backlinks for this item. |
RefDomains | Number of domains that reference this item. |
AnalysisResUnitsCost | Cost to analyse this object in AnalysisResUnits. |
ACRank | ACRank of this item's URL. |
ItemType | Type of the item:
|
IndexedURLs | Number of URLs found in the index. |
GetTopBackLinksAnalysisResUnitsCost | Amount of analysis resource units that will be required to analyse this item using GetBackLinkData command. The information above is provided a guidance only - please call this command to get exact values for any specific index items or call GetSubscriptionInfo to get current minimum and maximums. |
DownloadBacklinksAnalysisResUnitsCost | Amount of analysis resource units that will be required to analyse this item using DownloadBackLinks command. |
DownloadRefDomainBacklinksAnalysisResUnitsCost | Cost in Analysis Resource Units to download the reference domain backlinks for this item. |
RefIPs | Number of IPs that refer to this item. |
RefSubNets | Number of subnets that refer to this item. |
RefDomainsEDU | Number of educational (.edu , .ac.uk , etc.) domains that refer to this item. |
ExtBackLinksEDU | Number of educational (.edu , .ac.uk , etc.) external backlinks that link to this item |
RefDomainsGOV | Number of governmental (.gov , .gov.uk , etc.) domains that refer to this item. |
ExtBackLinksGOV | Number of governmental (.gov , .gov.uk , etc.) external backlinks that link to this item. |
RefDomainsEDU_Exact | The number of .edu domains that refer to this item. This number will not include other educational domains like ac.uk , etc. |
ExtBackLinksEDU_Exact | The number of .edu external backlinks that link to this item. This number will not include other educational domains like ac.uk , etc. |
RefDomainsGOV_Exact | The number of .gov domains that refer to this item. This number will not include other governmental domains like gov.uk , etc. |
ExtBackLinksGOV_Exact | The number of .gov external backlinks links that link to this item. This number will not include other governmental domains like gov.uk , etc. |
CrawledFlag | Boolean indicating whether this page has been crawled. |
LastCrawlDate | Date indicating the last time the page was crawled. |
LastCrawlResult | String indicating the HTTP response last time this page was crawled. |
RedirectFlag | Boolean indicating if this domain redirects elsewhere. |
FinalRedirectResult | Textual explanation of the result of the last redirect. |
OutDomainsExternal | For URLs, this is the number of outgoing links to unique domains for that page. For subdomains and root domains, average numbers are shown. |
OutLinksExternal | The number of outgoing links for this domain. |
OutLinksInternal | For URLs, this is the number of internal links for that page. For subdomains and root domains, average numbers are shown. |
OutLinksPages | For URLs, this is the number of pages that had non-zero outgoing link information for this URL. For subdomains and root domains, average numbers are shown. |
LastSeen | If this item has been lost from the index, the date at which it was last seen. |
AffectedByAntiSpamAlgo | If a non-0 value, indicates that reduced information is being returned for this domain. |
Title | Title of the item. |
RedirectTo | URL that this item redirects to. |
Language | For URLs, this is the language code for the source page. For subdomains and root domains, this is the detected languages for each page on that domain. This may be a comma delimited string to support multiple languages (i.e. en,de). |
LanguageDesc | This is the English name of the language codes. This may be a comma delimited string to support multiple languages (i.e. English,German). |
LanguageConfidence | Percentages indicating the confidence of the language. This may be a comma delimited string to support multiple languages (i.e. 90,80). |
LanguagePageRatios | Percentages indicating how much of the page is in a certain language. This may be a comma delimited string to support multiple languages (i.e. 77.9,10.3). |
LanguageTotalPages | This is the total number of language detected pages that were taken into account. The language page ratios are calculated against this number. |
RefLanguage | This is the detected languages of incoming anchor text. This may be a comma delimited string to support multiple languages (i.e. en,de). |
RefLanguageDesc | This is the English name of the referring language codes. This may be a comma delimited string to support multiple languages (i.e. English,German). |
RefLanguageConfidence | Percentages indicating the confidence of the referring languages. This may be a comma delimited string to support multiple languages (i.e. 90,80). |
RefLanguagePageRatios | Percentages indicating how much of the referring anchor text is in a certain language. This may be a comma delimited string to support multiple languages (i.e. 77.9,10.3). |
RefLanguageTotalPages | This is the total number of referring anchor text that were taken into account to determine referring languages. The referring language page ratios are calculated against this number. |
CrawledURLs | Number of URLs crawled in this query. |
RootDomainIPAddress | The IP address of the root domain where available. |
TotalNonUniqueLinks | The total number of non-unique links. This number is calculated by summing up the following columns: NonUniqueLinkTypeFrame NonUniqueLinkTypeImageLink NonUniqueLinkTypeRedirect NonUniqueLinkTypeTextLink This number can be used for percentage comparisons for the following columns: NonUniqueLinkTypeHomepages NonUniqueLinkTypeIndirect NonUniqueLinkTypeDeleted NonUniqueLinkTypeNoFollow NonUniqueLinkTypeProtocolHTTPS |
NonUniqueLinkTypeHomepages | Number of non-unique link types that are found on the homepage of a domain. |
NonUniqueLinkTypeIndirect | Number of non-unique indirect links to this item. |
NonUniqueLinkTypeDeleted | Number of non-unique deleted links to this item. |
NonUniqueLinkTypeNoFollow | Number of non-unique links with NoFollow set to true. |
NonUniqueLinkTypeProtocolHTTPS | Number of non-unique links which use HTTPS as a protocol. |
NonUniqueLinkTypeFrame | Number of non-unique links which are in an i-frame. |
NonUniqueLinkTypeImageLink | Number of non-unique links which are in an image. |
NonUniqueLinkTypeRedirect | Number of non-unique links which are redirects. |
NonUniqueLinkTypeTextLink | Number of non-unique text links. |
RefDomainTypeLive | The number of referring domains with at least 1 live link (as in not marked as deleted). |
RefDomainTypeFollow | The number of referring domains with at least 1 follow link. |
RefDomainTypeHomepageLink | The number of referring domains with at least one link from a homepage (includes any hostname on them). |
RefDomainTypeDirect | The number of referring domains with at least 1 direct link. |
RefDomainTypeProtocolHTTPS | The number of referring domains with at least 1 HTTPS protocol URL pointing to the target. |
CitationFlow | CitationFlow value for this item. |
TrustFlow | TrustFlow value for this item. |
TrustMetric | TrustMetric value for this item. |
TopicalTrustFlow_Topic_x | TopicalTrustFlow topic for this item. |
TopicalTrustFlow_Value_x | Value for the given TopicalTrustFlow topic. |
DL_DuplicationCode_CannotBeClassified_NonUnique New |
The number of links which cannot be classified by our duplicate link analysis. Equivalent to the duplication classification "Cannot Be Classified" on Site Explorer. To provide a low error rate in noise detection, there are gaps between what is considered, 'distinct, notable, or duplicate'. These links could not be confidently classified into these categories. |
DL_DuplicationCode_NonNotableDuplicate_NonUnique New |
The number of links which are classified as non-notable duplicates by our duplicate link analysis. Equivalent to the duplication classification "Non-Notable Duplicate" on Site Explorer. Non-Notable Duplicates are copies of links found on the same site that point to the same URL. These links pass little or no Trust Flow and Citation Flow and are considered non-notable copies of links found elsewhere in our link data. |
DL_DuplicationCode_NotableDuplicate_NonUnique New |
The number of links which are classified as notable duplicates by our duplicate link analysis. Equivalent to the duplication classification "Notable Duplicate" on Site Explorer. Notable Duplicates are links that have clear duplicates from the same domain but ALSO have a positive Trust Flow or Citation Flow score. To preserve a wide range of link analysis techniques, notable duplicate links will be preserved but will be marked as such for you to filter as appropriate. |
DL_DuplicationCode_Redirect_NonUnique New |
The number of links which are classified as redirects by our duplicate link analysis. Equivalent to the duplication classification "Redirect" on Site Explorer. As Redirects do not come from traditional links, it is more difficult to say with confidence that they are from duplicate sources. |
DL_DuplicationCode_Distinct_NonUnique New |
The number of links which are classified as distinct by our duplicate link analysis. Equivalent to the duplication classification "Distinct" on Site Explorer. These links are either...
Duplicate links are not checked across domains, so other links from different domains may look identical. The "AFTER NOISE REDUCTION" count from Majestic Site Explorer summary uses the sum of this count, combined with all other DL_DuplicationCode_*_NonUnique counts, excluding DL_DuplicationCode_NonNotableDuplicate_NonUnique. |
DL_DuplicationCode_PendingClassification_NonUnique New |
The number of links which are yet to be classified by our duplicate link analysis. Equivalent to the duplication classification "Pending Classification" on Site Explorer. Duplicate link analysis is a complex operation, and there are sometimes delays between link discovery and classification. To quickly bring you data, we do not wait for full classification before including links in the index. |
Problem | Solution |
---|---|
Calling this command in a loop to look up backlink counts for each of the many URLs separately is slow. | Batch multiple URLs or domains into a single request to limit overhead and provide a very substantial increase in performance. |
Certain URLs return backlink counts that are inconsistent with the results obtained on the webpage. | Check that Status is not set to "MayExist" as this means that backlink counts are less than specified backlink values. |
Attempts to obtain backlink counts for a specific domain return the counts for the homepage. | Avoid adding protocols (http://) or any other characters that are not part of valid domain name as this will result in the system returning data for that URL. |
Counts returned by this command are inconsistent with AnalyseIndexItem/DownloadBackLinks. | Please check that your filtering options aren't too narrow. |