1. What is a SERPs API?

It is a way of retrieving ranking data in an easy to consume JSON format. It breaks down the search results, (the SERPs) and covers every blended search feature Google has introduced over the past few years. It tracks the position of keywords from position 1 until 100.

The benefits of the SERPs API are fast keyword research and rankings with 99.9% query success rate. We support horizontal and vertical positioning. Our customers can also use the API with other SEO software or on its own.

The SERPs API will automatically tell you whether a particular type of result is not only visible but also above or below the fold. This is crucially important for assessing why a top organic result may not be getting the CTR (click through rates) you expect it to achieve, because you may have some organic rankings that have been pushed ‘beyond the fold’ (i.e. they require the user to scroll down to see them) by other types of results above them.

2. Why use the Authoritas Keyword Rankings API?

The Authoritas API allows you to gather a complete list of SERPs features from our API for Google (and other search engines such as Bing, Yahoo, Baidu and Naver) on desktop and mobile devices. It is reliable, can pull from 10,000 queries to up to more than a 1,000,000 pieces of data and at a competitive price. We also have 18 hour support available Monday to Friday.

These are a list of the features we can pull with the Authoritas API:

We take away the problem of proxy management. There is high volume extraction of keyword ranking and research data from major search engines. The API at Authoritas supports all devices, search engines, markets and data used in the platform. It also includes Universal Search Results plus Rich Snippets, Paid Search, Google Shopping and Direct Answers.

3. How much does an SEO API cost?

At Authoritas, we offer two APIs – our Platform API (Site Auditing & Crawling API – XML/RPC) and our Keyword Ranking API (SERPs). Please contact our sales team for a quote to speak with Marcus or Raphaël.

4. How do I check my SERPs?

You can check your SERPs with the Authoritas API. Simply purchase the key and read through the documentation to check the SERPs.

5. Can I check the PPC Ads of the SERPs?

The SERPs API will show you the details of the PPC ads that Google displays. The API will let you know when and where we see ads, e.g. whether they appear at the top of page 1 or on the side. You’ll notice that we simply differentiate between the two through the use of an “on_top” property.

To ensure the PPC ads are included, specify this in your API request by simply using ‘include_all_in_universal’ => true’ in your request object. They still get returned in individual sections of the response, otherwise, but we only calculate Universal Ranking positions based on non-paid result types.

6. Can I see universal searches with the API?

Yes, the universal rank in the platform takes into account all SERP features including organic, video, image and news results (and so on) in calculating an overall universal ranking position.

7. Can you see AMP with the API?

Simply tell us you want us to check the SERPs for results on mobile devices by specifying ‘mobile’ as the user agent when you send over the request. The response you’ll get back will automatically indicate which of the ranking URLs are tagged as AMP results by Google.

Here is the SERPs API documentation which explains it in more detail. Please don’t hesitate to get in touch, should you need any other information or a test key.

Above & Below the Fold

As we support horizontal and vertical positioning, the API will also automatically tell you whether a particular type of result is not only visible but also above or below the fold. This is crucially important for assessing why a top organic result may not be getting the CTR (click through rates) you expect it to achieve, because you may have some organic rankings that have been pushed ‘beyond the fold’ (i.e. they require the user to scroll down to see them) by other types of results above them. In order to work this out, we work from a standard browser size, as follows:

User Agent	Browser Dimensions
pc	1920×1080
mac	1920×1080
tablet	768×1024
ipad	768×1024
iphone	375×667
mobile	375×667

The above the fold value is then calculated by checking if the element’s top left coordinates’ vertical position is less than the size of the browser window. Simple! 🙂

Ads (Top & Bottom)

It will surprise anyone to see PPC ads cropping up in the SERPs when the phrase has any sort of commercial intent, as PPC is still Google’s main source of revenue. For those of you who want to track all PPC ads appearing in the SERPS, then you’ll be pleased to hear that we also show you the details for the ads that Google puts towards the bottom of the page, the API will let you know when and where we see ads, e.g. whether they appear at the top of page 1 or the bottom of page 3. You’ll notice that we simply differentiate between the two through the use of an “on_top” property:

If you’re developing a PPC campaign management platform or just building an SEM dashboard and need both PPC and SEO data, then hopefully you should find this update useful.

AMP detection

AMP (Accelerated Mobile Pages) have become a slightly controversial topic within the SEO community over the past year, but regardless of what you think about the benefits or drawbacks of implementing support for AMP, they are a reflection of Google catering for the fact that most searches online are now carried out using mobile devices (phones, tablets, etc). Usually, you will only see these types of results for mobile searches. Therefore you would need to specify a mobile user agent in your API request. To read more about AMP pages, read this article on searchengineland.com.

Answer Boxes (list)

Google has been providing ‘direct answers’ to queries in various forms for some time now and often in such an informative way that the answer presented initially at the top of the SERPs is sufficient to answer the initial question, so a user doesn’t always have to then navigate to a particular website. These types of result come in several forms, but amongst the most common is the ‘list’ type, which will either show as an ordered (numbered) or unordered (bulleted) list. Here’s an example of the former:

And here’s an example of the bulleted type:

Answer Boxes (paragraph)

For some queries, however, Google will return a direct answer that looks awfully like a paragraph and this is sometimes the case even if the linked content is actually displayed as a list. This will show as “type” => “paragraph” in the JSON response.

Answer Boxes (table)

For some direct answer results, you’ll see what is obviously a table at the top of the SERPS. These can vary slightly from query to query, as you can see from the following examples:

Dictionary Definition

At Authoritas we are constantly working on new features to add to the SERPs API. We can also track dictionary definition results.

This is what dictionary looks like in the SERPs:

Events

As of January 2020, our API can also track events within the Google SERPs.

 

The SERPs look like:

Featured Video

The API has been picking up on normal video results for a while now, but Google will occasionally highlight the most relevant video result as a featured video at the top of the results page. You typically only see this type of result on page 1 of the SERPS. Here’s an example:

And here are the JSON response you’ll get from our API (not the “featured” property set to “true”):

Flight Finder

Hotel Finder

Knowledge Graph

For some queries, Google will return a ‘knowledge panel’ or a ‘knowledge graph’ based result. This typically appears on the right hand side of the SERPS. Here’s a good example of that when just searching for ‘barack obama’:

People also ask

For some queries, Google will also display “related questions” other users made for similar queries:

This section of the SERPs is often shown above the fold (on a desktop search anyway) and, just like “related searches” (below), gathering this information can be useful as part of your keyword research tasks when conducting an digital marketing campaign. You’ll see this broken in the JSON response under “people_also_ask: {}”.

Places (Local Pack)

People Also Search For

Refine By

Research Guides

Related Searches

Similar to the above “related questions” or “people also ask” results you see in Google, you will normally always see a “related searches” section towards the bottom of the SERPs, just above the pagination section. You can also use this data as a useful addition to any Keyword Research you are carrying out during a campaign. The relevant part of the JSON response will look like this:

Sitelinks

Sitelinks can be an indication that Google considers a website to be owned by a recognised brand. They help to expand the size of a website’s organic listing, so can be useful to have, but you will need to implement Schema.org markup in order to make use of these.

Social (Tweets)

Google will sometimes return tweets as part of the SERPS results, although this is more likely when a user is searching for something quite topical. A good way to see this in action is to use a Twitter hashtag when googling. Here is a recent example:

Stock Prices

As of January 2020, we can now track stock prices in our SERPs API.

Super Universal

One of the effects of universal search results appearing in the SERPS was the effect it would have on a site’s overall ranking position. We reflected this concern in the platform by introducing a Universal Rank for each keyword, to go alongside an Organic Rank. The universal rank in the platform would take into account organic, video, image and news results in calculating an overall universal ranking position. However, now if you consider that paids ads (PPC) should also be included in this overall calculation, then you can specify this in your API request by simply using ‘include_all_in_universal’ => true’ in your request object:

You should then notice that in the Universal section of the response you get back from the API, ads are considered part of the universal ranking calculations. You should be able to see this from the following example where the top ad in the SERPS has a universal rank of #1 and the first “places” result has a universal rank of #3:

Translations

January was a busy month and we have also released translations within the API:

Translations gives immediate results without the user having to click through to a site:

Travel Finder

 

Visibility

By “Visibility”, we simply mean whether the SERP feature is visible to a user when they first reach that page, i.e. It doesn’t require any interaction to see it (other than scrolling up or down). So usually this will apply to news, tweets, images, shopping or any other type of result for which Google generates a left-right carousel. Here are some examples:

In the above example, we know (and report) X news results, but only some of them are initially visible to a user unless that user clicks on the chevron on the right-hand side of the screen to get the carousel to scroll right and show more results. It is useful to use this in conjunction with the Above the Fold analysis mentioned above to determine whether a Universal SERP feature that you may be ranking for is above the fold of the page and visible to users.

WANT TO TRY IT OUT?

Excited by all the possible ways in which you could use all this data? Well, if you work for a digital marketing agency, a corporation, enterprise or a single e-commerce site and want to try this out, simply get in touch with us and we’ll send you a free API key for a limited period.