GetBackLinksHistory

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

This function provides backlinks history data by month

Is a replacement for GetDomainBackLinksHistory and returns data in the same way.

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

Resource Description

AnalysisResUnits

500

RetrievalResUnits

10 per queried item

This function accepts the following parameters:

Parameter Description

cmd

Required: must be set to: GetBackLinksHistory

datasource

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

item0, item1, item2, item3, item4

All items can belong to URL, subdomain or root domain levels.

UsePrefixScan

Optional: Setting to 1 will activate prefix mode.

This operates like the "Path ( URL* )" functionality in Majestic Site Explorer on the majestic.com website.

This commands will check if real time querying of given item is possible, if that's not the case then RealTimePrefixQueryNotPossible error code will be returned.

See also Get Prefix Query Estimate

Example of query: https://api.majestic.com/api/xml?app_api_key=API_KEY&cmd=GetBackLinksHistory&item0=majestic.com&item1=majestic12.co.uk

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



https://api.majestic.com/api/json?app_api_key=API_KEY&cmd=GetBackLinksHistory&item0=majestic.com&item1=majestic12.co.uk

This produces the following JSON:


Results table will contain queried items with the type that they were treated as (Root domain, subdomain, URL) and DataTableName value that will contain name of the data table in XML that contains actual data. In the example above data was returned from historic index and thus broken down by month, data from fresh index will be returned broken down by day.

Rows of history data belongs to the following elements:
  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.

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.

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