Command Overview

Note: If the messages described in this section are converted from the raw format, the API section must be studied by the implementor as it contains message formatting guidelines.

Below is an list of commands available via the Majestic API along with a brief overview of what they are all about. For more detailed information on command specifics, click on the 'command name'.

Please note that the commands are documented at protocol level. Should connectors be used to access the Majestic API, please refer to the example code to assist with understanding how the protocol level instructions map to connector methods.

Popular Commands

Command Name Overview
GetIndexItemInfo Returns very quickly key statistics for index items (domain/subdomain/URL) such as: number of external backlinks and referring domains pointing to index item.

This command supports batching of multiple index items into single request: ideal to get stats on a number of URLs or domains.
GetBackLinkData
This function returns information of the backlinks at domain, subdomain or URL level.
This is the perfect function to get data on large domains as the resource cost of this function is fixed and does not depend on how large domain is.

This function can be used as a feed into existing applications that accepts backlinks taken from search engines such as Yahoo Site Explorer.

Used to power Backlinks Tab in Site Explorer.
GetAnchorText This function returns Anchor text for a given domain, subdomain or URL, as well as allowing you to filter the results by a keyword

All Commands

Most commands have either fixed or variable cost of calling charged in AnalysisResUnits. All commands that return data will also reduce RetrievalResUnits by the actual number of rows of data returned (ie: referring domains, backlinks, anchor text etc) returned.


Command Name Overview Minimum Cost
(AnalysisResUnits)
Maximum Cost
(AnalysisResUnits)
GetAnchorText This function returns Anchor text for a given domain, subdomain or URL, as well as allowing you to filter the results by specified text (see usage in Majestic Site Explorer: Anchor Text tab). 10001000
GetBackLinkData This function returns information of the backlinks at domain, subdomain or URL level (see usage in Majestic Site Explorer: Backlinks tab). 5000Depends on number of backlinks
GetBackLinksHistory This function provides backlinks history data by month for historic index and by day for fresh index (see usage in Majestic backlinks history tool). 500500
GetHostedDomains This function is designed to return domains co-hosted on known IP address or domain (IP address in this case will be looked up).

Example of data returned by this function can be found in the Majestic Neighbourhood checker tool.
50005000
GetIndexItemInfo Returns very quickly key statistics for index items (domain/subdomain/URL) such as: number of external backlinks and referring domains pointing to index item.

This command supports large scale batching of index items into single request: ideal to get stats on a number of URLs or domains (see usage in Majestic Bulk Link Checker).


Uses GetIndexItemInfo resource of subscription
GetKeywordInfo Returns phrase/broad count of matches for INANCHOR/INTITLE/INURL query for a list of supplied keywords, batch operation of up to 1000 keywords per call supported (see usage in Majestic Keyword checker tool). 500Depends on number of keywords- exact number reported by GetKeywordInfo command
GetLinkProfile This function returns the data used to generate link profile graphs (see usage in Majestic Site Explorer: Backlinks tab). 500500
GetNewLostBackLinks This function returns new and lost backlinks in a date range (see usage in Majestic Site Explorer: New backlinks tab). 500500 x number of days checked
GetNewLostBackLinkCalendar This function shows new or lost backlinks counts per day for calendar purposes in a selected data range (see usage in Majestic Site Explorer: New backlinks tab). 500500
GetRefDomains This function operates on domain , subdomain or URL level, and returns information about the relationships between domains (see usage in Majestic Site Explorer: Ref Domains tab). 10001000 per item
GetRefDomainInfo This function 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 functions such as GetBackLinkData. 10001000
GetTopics This function is designed to return Topical Trust Flow data and the number of links and referring domains passing each topic. 10001000
GetTopPages This function is designed to return one or more URLs from root domain or subdomain. This function is also the only guaranteed way to check if a URL is present in index because GetIndexItemInfo only works with a limited number of URLs with high enough number of backlinks or referring domains. (see usage in Majestic Site Explorer: Pages tab). 50005000
GetSubscriptionInfo This function returns information on existing subscriptions with current resource usage values provided. 00
GetDownloadsList This command returns information on specified download - it is useful to check status of the download backlinks request that was send through previously. 00
DeleteDownloads Call this function to Delete downloads when they fully finished and retrieved by you.

Note: deletion of the download will not delete files that may have been uploaded to your own FTP (if it was specified). This deletion merely removes download from server database as if it was never requested. If the deletion is called during uploading phase then the server will automatically abort it, if its in processing stage then it will also be aborted.
00
DownloadBackLinks This function is designed to allow large scale backlinks retrieval beyond maximum of 50000 links supported by GetBackLinkData. Due to typically high volume of data this command is expected to process it will always work asyncrounously with results being made available as a downloadable .GZ compressed CSV file. This command will generate equivalent data as obtained by Download interface for Advanced Reports in Majestic web front end. 25000Depends on number of backlinks- exact number reported by GetIndexItemInfo command
SearchByKeyword This function returns Search data for a given keyword. 5050000
SubmitURLsToCrawl This function allows URLs to be submitted for crawling and inclusion in the index 5050000

Deprecated Commands

Deprecated commands, maintained for Legacy Customers only. Scheduled for removal for all new customers, please migrate to new commands.


Command Name Overview Minimum Cost
(AnalysisResUnits)
Maximum Cost
(AnalysisResUnits)
GetTopBackLinks

(deprecated, replaced by GetBackLinkData)
Returns a list of top ranked (by ACRank) backlinks (with anchor text and other related data) for any URL, domain or subdomain.

This is the perfect function to get data on large domains as the resource cost of this function is fixed and does not depend on how large domain is.

This function can be used as a feed into existing applications that accepts backlinks taken from search engines such as Yahoo Site Explorer.

On our website it is used to generate Standards Reports.
500015000
(if multiple items queried)
GetDomainBackLinksHistory

(deprecated, replaced by GetBackLinksHistory)
This function provides backlinks history data by month. Example of such data used on our website can be found here: Backlinks History tools. 5000Depends on number of backlinks
AnalyseIndexItem

(deprecated, replaced by DownloadBackLinks)
This function is ideal for indepth analysis of index items that returns the following data:

  1. Top backlinks
  2. Aggregated anchor text
  3. Referring (linking in) domains
  4. Backlink discovery rates by month (as used by our charts)
  5. Other data

This function accepts filtering rules that help focus only on backlinks of interest. It is also possible with this function to retrieve very large number of backlinks. The function has variable cost of analysis of index items that depends on how many external backlinks they have.

On our website it is used to generate Advanced Reports.
5000Depends on number of backlinks- exact number reported by GetIndexItemInfro command
GetLinkedDomains

(deprecated, replaced by GetRefDomains)

This function operates on domain level, and returns information about the relationships between domains ( root domains pointing to a root domain - it does not resolve the URLs or subdomains of the backlinks ). It can be used to achieve the following:

  • Get list of root domains with backlink counts pointing to a given root domain
  • Find root domains which point to all, or a subset of specified root domains.

On our website GetLinkedDomains is used to get list of matching domains in Clique Hunter tool: http://www.majestic.com/reports/cliquehunter

It is recommended that any result data to calls to this call is cached, and that calls to this function are minimised. A single call should made to this function to retrieve all data necessary and it should then be cached locally to serve subsequent user queries (if any) from that local cache.

See the GetLinkedDomains command for detailsSee the GetLinkedDomains command for details

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