The Authoritas Keyword Ranking API allows you to make multiple simultaneous keyword requests to any major search engine worldwide. We have also built a classification model that analyses Google’s search intent as a proxy for user intent. We look at the prominence and order of the organic and paid SERP results, the Universal SERP results featured, the navigational elements and the types of ranking sites.
Keyword Ranking API
SERPs API (REST API)

The API supports high-volume users such as large SEO agencies tracking hundreds of thousands of client keywords or SEO tools tracking millions of keywords per day.
- Perfect for high volume extraction of keyword ranking and research data from major search engines
- Supports all devices, search engines, markets, languages and locations used in the Authoritas SEO platform (or any other SEO tool)
- Over 40 Universal SERP Features
- Unique geo-localisation capabilities to town or postcode/zip code
- Hyperlocal capabilities to geolocate to decimal latitude and longitude
- Unique ‘Above-the-fold’ and ‘Visible’ indicators
- Returns JSON and/or compressed HTML
- Dedicated queues and proxies for the largest clients
Search Engine Support
The SERPs API Documentation sets out all the supported search engines, countries, languages and towns.
Suffice to say we support all the major search engines you would expect in the major markets and languages they serve.
- Google (Web Search and Google Local)
- Bing
- Yahoo
- Yandex
- Baidu
- Naver
- Seznam
- Sogou
User Intent for Your Keywords
- Navigational – Search terms that are centered on a brand, company or person.
- Informational – Keywords that have low commercial intent.
- Research – Search phrases with strong commercial intent earlier in the buyer journey.
- Transactional – Search phrases with high purchase intent and value close to the end of the buyer journey
Additional Intent Metrics
- Dominant Intent – Some keyword phrases will sit between one or more categories. For every keyword we tell you the over-riding dominant intent.
- Local Intent – Google is great at understanding that a user is looking for something locally, even if this is implicit intent (e.g. A search for a “dry cleaners” where a user has not specified a location). We highlight these keywords for you as they are great for small businesses looking to compete with bigger brands in Local SEO.
Hyperlocal Rankings

We are a registered Local Internet Registry with the major Internet numbering organisations like ARIN and RIPE.
Over the past decade, we have established our own private network infrastructure, servers and proxies in major international markets. It also means we can geolocate our search engine queries much better than most alternative SEO data API providers.
We do not use any SEO tricks like convoluted URL parameters in the query string to Google and other search engines. E.g. UULE parameters and the “&near= command used by many other tools).
This gives us an unrivalled ability to geolocate using decimal latitude and longitude to the building level (not just the postcode/zip code or town).
Can we help?
If you are interested in trying the Keyword Ranking SERPs API, then please book a brief call with one of our platform experts and we can get you setup with an API key and some free credits to test it out.
Universal Rankings
Given the importance of Universal SERP features for SEOs today, we’ve gone to town to analyse all the key Google SERP features you’ll ever need.
We use a real browser and paginate like a real user to get the top 10 pages (~100 ranking results) for each keyword you send us.
Here’s a complete list of SERP Features we extract, with an explanation, example screenshot from Google and an example of our parsed JSON.

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.
It will not 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 adverts that Google puts towards the bottom of the page, the API will let you know when and where we see adverts, 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 useful.
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.
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. At Authoritas we track all the different SERPs Answer Box results including lists, paragraphs and tables.
These Answer Boxes 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:
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.
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:
Since February 2020, we can pull in all the information you need when it comes to books in the Knowledge Panel. You can retrieve the title, description and URL.
Since January 2020, we are now able to parse currency converter results in our API.
Since December 2019, we have been able to retrieve destination titles, descriptions and images.
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:
As of January 2020, our API can also track events within the Google SERPs.
The SERPs look like:
The frequently asked question results allows users to easily access important questions from your site. With our SERPs API you can find out if your site is ranking for FAQs.
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”):
Gather all the details from the flight finder SERPs with the Authoritas API.
Pull the hotel name, type and URL from the SERPs with the Authoritas API.
At Authoritas we also pull in the image details including the image URL.
At Authoritas have updated our API to pull in Interesting Finds data.
The API can pull in all information including description of the job, where it is, salary amount and location of the job results in the SERPs.
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’:
Scrape the news results with the Authoritas API.
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 a digital marketing campaign. You’ll see this broken out in the JSON response under “people_also_ask: {}”.
Discover which local business listings appear in the SERPs.
Pull in the description, title, image and URL of any recipe in the SERPs.
Google allows users to refine their results. This feature is at the bottom of the search results page and above the related searches section.
Depending on the query, Google also pulls in “how to guides” and other “guides” to help users with their search. For example in this example Google shows users blog posts and guides about how to choose the perfect wardrobe when they search for “buy wardrobe”.
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:
Pull in the reviews for different products or services.
Pull in the title, merchant and URL, info, price and the location of the product within the SERPs.
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 mark-up in order to make use of these.
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:
The Authoritas API pulls in sports results including sport type, phrase, date and region.
As of January 2020, we can now track stock prices in our SERPs API.
This is how it looks like in the SERPs:
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:
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.
Google thinks the user intent is of paramount importance to us as SEOs if we want to rank for a bunch of relevant terms around that intent. For this reason, we have built a classification model that analyses Google’s search intent as a proxy for user intent. Earlier this year, we launched the beta launch of our user intent features. This means for every single keyword ranking check, we analyse the make-up of the first full page of the SERP (and ignore the rest of the top 100 results). We look at the prominence and order of the organic and paid SERP results, the Universal SERP results featured, the navigational elements and the types of ranking sites. This allows us to develop a user intent model that works in the markets Google serves irrespective of language.
At Authoritas we can also parse video serps.
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.
In the above examples on this page, 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.
Pull in all the weather details including description, location and URL.
FAQs about Keyword Ranking (SERPs) APIs
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.
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 and can extract large numbers of queries, 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.
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.
We offer two APIs, our Platform API (Site Auditing & Crawling API – XML/RPC) and our Keyword Ranking API (SERPs).
Please email us or click on the contact button to speak to one of our client success team.
You can check your SERPs with the Authoritas API. Simply purchase the key and read through the documentation to check 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.
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.
These are a list of the features we can pull with the Authoritas API when querying Google. For all other engines we just get organic results:
- Above the Fold analysis
- Ads (PPC – Top & Bottom)
- AMP (Accelerated Mobile Pages)
- Answer Boxes
- Books
- Carousels
- Currency Converter (since Feb)
- Destinations (these results link to Google’s Travel Guides)
- Dictionary definitions
- Discover More Places
- Event Finder
- Featured video
- Find Results By
- Flight Finder
- HTML capturing
- Hotel Finder
- Images
- Job Finder
- Knowledge Graph
- Knowledge Panel/LBLs
- Knowledge Panel/Reviews:
- Location
- Maps (single maps at the top of the SERPs – see above)
- Number of results
- Organic results
- Organic FAQs
- People Also Ask
- People Also Search For
- Places (Local Pack)
- Podcasts
- Positioning (X and Y coordinates of elements)
- Recipes
- Refine By
- Related Searches
- Research Guides
- Reviews
- Rich Snippets
- See Results About
- Shopping
- Sitelinks
- Spelling Corrections
- Sports
- Stock Prices
- Super Universal
- Top Stories (News)
- Translations
- Travel Finder
- Tweets (Social Media)
- Videos
- Visibility (whether the result is actually visible to a user or hidden in a carousel off the side of the page)
- Weather
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 everything in more detail. Please don’t hesitate to get in touch, should you need any other information or a test key.
Can we help?
If you are interested in trying the Keyword Ranking SERPs API, then please book a brief call with one of our platform experts and we can get you setup with an API key and some free credits to test it out.