GetDomainBackLinksHistory

Deprecated - Scheduled for removal - Replaced by GetBackLinksHistory

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

This function provides backlinks history data by month. Example of such data used on our website can be found here:
http://www.majestic.com/comparedomainbacklinkhistory.php?d0=majestic.com

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

Resource Description

AnalysisResUnits

This resource will be decreased by 5000 for each domain on which data has been returned.

Example: a call to get data for 5 domains was made and it will result in 5*5000=25000 analysis units being charged on account.

This function accepts the following parameters:

Parameter Description

cmd

Required: must be set to: GetDomainBackLinksHistory

datasource

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

Domains

A comma delimiter list of root domains for which backlinks history data is required.

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

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.

Example of query: https://api.majestic.com/api/xml?app_api_key=API_KEY&cmd=GetDomainBackLinksHistory&Domains=majestic.com

Below you can see example of successful XML returned for this function:



https://api.majestic.com/api/json?app_api_key=API_KEY&cmd=GetDomainBackLinksHistory&Domains=majestic.com

This produces the following JSON:

Global Variables

The following important global variables provided:

  1. LastLinkDate: this indicates the most recent date of a backlink included in the whole index (not just for this domain) - it is useful to compare against previously done charts to see if this data has been updated
  2. LastLinkDateExtrapMonth - this is the month in which the last link date was found - most likely it will be partial month so if you plan on showing this data it will need to be extrapolated upwards in order to be comparable with other months
  3. LastLinkMonthExtrapFactor: floating point number that you can use to multiply LastLinkDateExtrapMonth in order to get comparable results on a monthly basis. In the example above last backlink date is 25 March 2010, multiplying 25 by 1.240 will give 31 which is total number of days in March.

Datatables

Datatable named "DomainInfo" will contain information about queried domains - column named "PriceChartName" with a value "DomainPriceTable_majestic.com" is a reference to an additional table with that name: it contains counts by month of different type given in column name, with the following valid values:

  1. TotalLinks: total number of external backlinks found in a given month
  2. RefDomains: number of new referring domains found in that month
  3. ImageLink: links with images, ie: <a href="link">&ly;img src=""></a> - note the SRC value is not used this case, only HREF part of A tag.
  4. Mention: number of URLs on which root domain was mentioned (see http://www.majestic.com/glossary.php#Mentions) (it is NOT recommended to use these counts due to user confusion it may cause).
  5. NoFollow: links marked with nofollow tag either as rel="nofollow" or META NOFOLLOW tag.
  6. CrawledPages: number of crawled pages from that domain
  7. MentionDomains: number of new domains on which given root domain was mentioned (it is NOT recommended to use these counts due to user confusion it may cause.)
  8. TextLink: number of text links (not images or any other type) found in a given month - it is recommended to use TotalLinks. (it is NOT recommended to use these counts due to user confusion it may cause).
  9. DomainURLs: number of URLs found on that domain - this can be used as indicator of content growth
  10. IndexCrawledPages: number of crawled pages globally by our system - this is useful metric to normalise found backlinks (but not referring domains) against total crawl -

In the example given earlier in this chapter our website uses TotalLinks and RefDomains counts for its charting.

Datatable named "DomainQuotes" is legacy feature and should not be used as it will be removed in the near future.

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