Your first 5 minutes with the Majestic API

Audience: We anticipate that you are a programmer in possession of a developer api key. If you want to buy a plan with access to the API, please visit the plans page, or contact our sales team for more details.
It is assumed that the audience is aware of security issues associatted with remote API access over the internet. Please note that "GET" style URL's are used in this documentation for the purpose of providing clear, concise examples to developers only.

This page is designed for the standard API authorisation available on platinum plans and upwards. If you wish to write an open apps application, we suggest you start with this guide, and then progress to the Open Apps specific documentation.

For in depth technical detail about the API, please visit the API reference page.

  1. The API

    The majestic API is available on two endpoints – a developer api with a tiny, older version of our index which is useful for familiarisation, and an enterprise api which uses the resources on your subscription to query our live data sets.

    Our website at accesses our Fresh and Historic index in a very similar manner to the public API, and familiarisation with the website can assist development, and also help support personnel when dealing with any query you may have.

  2. How are requests made?

    Our API is based on HTTP. An HTTP GET or POST request is sent from your application to one of the two endpoints discussed above. This endpoint returns a response synchronously. For some commands, you may be required to make further http requests to download the data requested.

  3. What does a response looks like?

    Following your HTTP GET or POST request, our server will return a response in a compact form of XML, or in JSON. Our JSON format is more humanly readable, but comes at the cost of bandwidth. We therefore advise users to maximise performance by using XML. Example connector code is available via our GitHub repository.

    Example xml and json responses to the GetIndexItemInfo call, which is the fastest way to get statistics on one or more domains, are shown below.

  4. Enabling your API

    Visit your account to enable your API, and get access to your API key.

    Enabling the API in your account
  5. Making your first request in the web browser

    Add your API key to the form below and click on the URLs to test the developer endpoint for GetIndexItemInfo. We would encourage you to add other domains to the http request (such as &, and look at the GetIndexItemInfo documentation to see what other parameters are available.

  6. Where next?

    Want to get to know the API a little better? Check out the API reference page.

    For a list of all available commands, with examples, descriptions and parameters, look at the commands section.

    We also provide API connectors in a number of different languages, which can be downloaded through our GitHub account to help you get started.

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