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:
- Ads (PPC – Top & Bottom)
- AMP (Accelerated Mobile Pages)
- Answer Boxes
- Carousels
- Flight Finder
- Featured video
- Images
- HTML capturing
- Hotel Finder
- Job Finder
- Knowledge Graph
- Location
- Organic results
- People Also Ask
- People Also Search For
- Places (Local Pack)
- Positioning (X and Y co-ordinates of elements)
- Refine By
- People Also Search For
- Related Searches
- Research Guides
- Shopping
- Sitelinks
- Social
- Super Universal
- Top Stories (News)
- Travel Finder
- Tweets (Social Media)
- Videos
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.
Authoritas SERPs API
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:
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:
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:
Travel Finder
This is a relatively recent addition to the SERPS by Google and is a good example of how Google is trying to provide its users with quick and detailed answers. Obviously, this data originates from and links to Google Maps.
