Google SERP Features API
Google SERP Features
is a premium add-on to the Rank Top 50 API
and Rank Top 100 API
methods that return the top 50 or top 100 landing pages ranking for a campaign keyword and Google search engine on a specific date. Results include rank, landing page URL, notation of special Search Result Indicators
(e.g., site links, video, search box, HTTPS, rating, event, etc.), and SERP Meta Title. This google_serp_features
add-on provides special Search Page Indicators
- Carousel type and up to 50 results
- Knowledge Panel title and subtitle
- Answer Box existence and type
- Local Pack top 3 titles
- Image Pack results URLs
- Top Stories titles and URLs
- Paid Results
with the number of keywords and search engines (e.g., Google.com Global, Google country-specific, Google Mobile, Google Maps) you'd like this data for, along with your choice of Top 50 or Top 100 results and the data frequency (e.g., daily, weekly or monthly), and we'll provide you with information regarding a custom SERP API package and pricing.
Refer to Rank Ranger API Overview
page for information on how to obtain API access, obtain an API Key, error codes and a full list of API methods.
Search Page Indicator Examples
If a Carousel exists in the search results for your keyword, the API indicates the type: Image or List, and provides up to 50 Image Titles.
API Response if Image Carousel exists
In this example, the results indicate an Image type of Carousel and provides the movie title results.
If a Carousel exists in the search results for your keyword, we will indicate the type: Image or List, and provide up to 50 list item Titles.
API Response if List Carousel exists
In this example, the results indicate a List type of Carousel and provides the detailed list results.
Knowledge Graph: Knowledge Panels
API provides an indication of the existence of a Knowledge Graph in the search results for your keyword, and includes the Title and Subtitle. Google serves a variety of knowledge graph types, below are a few examples.
Business Knowledge Panel
above search results page also contains Site Links (a search result
indicator found in Top 50 & Top 100 APIs in the Extra tag) and News
(a search page indicator, refer to News result format further down this
Food Knowledge Panel
Food knowledge panels come in several styles including nutrition facts or recipes.
General Info Knowledge Panel
The quick reference style knowledge graph answer box often utilizes data from Wikipedia.
API Response if Knowledge Graph exists
Knowledge Graph Title and Subtitle are provided in the API results. Based on the above example, the Title: Saturn
and Subtitle: Planet
display in the API results.
Knowledge Graph: Featured Snippet
SERP Featured Snippet
Knowledge Graph: Answer Box Types
Google has been adding new types of featured snippets and so we've expanded the information we provide in API results when a featured snippet, such as an Answer Box, is present.
Answer Box: Calculator
API Response if Calculator in SERPs
If we find an answer box in the search results for your keyword and it
is a calculator, the API results indicate that.
Answer Box: Currency Conversion
API Response if Currency Answer Box exists
If an answer box of a currency type exists on the search engine results page for your keyword, the API indicates the existence and labels type as "currency conversion".
Answer Box: Dictionary
API Results for Dictionary Answer Box
If a dictionary definition answer box displays in search result for a keyword you're tracking in Rank Ranger, the API will return a box type dictionary.
Answer Box: Disambiguation Type
Disambiguation Box in API Results
If a See Results About (aka disambiguation) box displays in the search results for your keyword, the API results will include a section labeled "box" and the titles of the items in that box. In this example, the SERP also included a Sports answer box.
Answer Box: Flight Search with Type, Airline, Duration and Prices
Google is serving several different versions of Flight Answer Boxes, this one is interactive.
Answer Box: Suggested Flights and Search Option
Answer Box: Flight Duration & Options
API Results for Reservation Information Flight Answer Boxes
If the keyword you're tracking scores one of these 3 Flight Answer Box types, the API returns a box type "flights" and the title of the box.
Answer Box: Current Flight
This clever answer box enables quick view of current flight status by searching for the airline and flight number.
API Results for Current Flight Answer Box
If an answer box with current flight information displays in the SERPs for your keyword, the API returns the "current flight" type.
Answer Box Graphs
Helpful for anyone doing homework or studying for a test, Google's Answer Box Graphs provide an extra dimension of data.
API Results for Graph Answer Box
If a graph displays in an answer box for your keyword in the search engine results, the API will return an answer box type "graph".
Answer Box: Info with Map and Image
Google presents many type of info boxes, these are only a few examples.
Answer Box: Info with Images
API Results for Info Answer Box
If Google provides an info answer box for your keyword in the SERPs, the API will report the type and title.
API Results for Info Answer Box with Links
If Google provides a link in addition to the answer box information, the API reports the type, title and URL.
Answer Box: Map of location
API Results for SERP Answer Box of Map Location
When the search engine results include a map of a location, if you're tracking a keyword that produced that type of result, the API will report map type, the title of the answer box and map type "map of".
Answer Box: Map Directions
API Results for Map Directions Answer Box
If a map directions type of answer box displays for your tracked keyword, the API reports the answer box title and map type: directions.
Answer Box: Nutrition Calculator
API Results for Nutrition Calculator Answer Box
If your keyword scores a nutrition calculator answer box, the API will report it's presence in the SERP and the answer box title.
Answer Box: Population Information
API Results for Population Info Answer Box
When a population answer box displays in the SERPs for your keyword, the API reports the box type "population info".
Answer Box: Sports
API Results for Sports Answer Boxes
Google presents Sports Answer boxes in a few styles, if your keyword results in the type, the API will report
the type and title of the answer box.
Answer Box: Stock Market Prices and Trends
API Results for Stock Prices SERP Answer Box
If your keyword ranks a Stock Market answer box, the API
reports the type, symbol and price displayed in the stock answer box.
Answer Box: Translation
API Results for Translation SERP Answer Box
When a translation answer box displays in the SERPs for your keyword, the API reports the type: translation.
Answer Box: Weather
API Response if Weather Answer Box exists
If a weather answer box exists on the search engine results page for your keyword, the API indicates the existence and with type of "weather" and provides the answer box title.
If a local pack displays for your keyword, the API returns the Title of the first 3 results. In the example below Claridge's, The Savoy Hotel and The Landmark London would be included in the API response.
API Response for Local Pack
The API returns the Title of the first 3 places displaying in the Local Pack.
If an image box exists in the search results for your keyword, the google_serp_features API provides a list of Google's URLs for those images (example of URL
for the beach image on the left below).
API Response if Images exist
The API returns the URLs of images if they exist in an Image bar in the search results.
In the News Blocks
If News results display for your keyword, the API results will include the Title and URL of the first 3. For the first result In the example below you would receive Title: National Australia Bank to host its own international tech conference" and the Google News URL
API Response if News exists in Search Results
The API returns the Title and URL of the In the news
section of Google search results.
SERP Ad Results
If Paid Results (e.g., AdWords ads) display for your keyword, then the API results will include the Title of the Ad, URL and the description.
API Response if Paid Ads Exist in Search Results
The API returns the Ad Title, URL and Description
||The unique API key assigned to your account
||Requested data date
Optional: Date Range can be called using
(for up to a span of 10 days)
If date is used, then do not include the results parameter
||Search Engine ID
||Campaign ID number
||Number of days' data (up to 10)
Do not use with date parameter
||Option to include SERP Link Title in the top 50 results
||Option to include SERP Description in the top 50 results
|Construct & test API requests in the API Console or follow one of these examples:
Top 50 for specific date
Top 50 for a date range with SERP Title and Description included
Top 50 for a date range
Top 50 for a specific number of results and including SERP Link Title
The default output is in XML format, if you would like the output to be json then you will need to add "&output=json
” at the end of the string
|The following response has been fabricated to demonstrate many of the Search Page Indicator options described in this document, therefore, it contains response for a variety of unrelated keywords. In the Top 50 results section, Search Result Indicators are contained between "extra" tags.
Question: With your Rank Top 50, Rank Top 100 or Search Query API, how can I distinguish between a keyword that organically ranked in position 1 vs. one that ranked in position 1 because it was in a featured snippet?
- In the search_results for each rank position, our Rank Top 50, Rank Top 100 and Search Query APIs provide rank, url, extra and title. SERP indicators are recorded as extra data, extra: Featured Snippet is the indicator you will see when a keyword ranks in position 1 inside of a Featured Snippet.
- For APIs that have Google SERP Features included, Featured Snippets are identified in the google_serp_features > answer boxes > answer_box > ab_type: Featured Snippet. Included in that result is the title, url and image_url when they exist in the Featured Snippet.
This illustration provides an example of our Rank Top 50 API results, demonstrating how results from the SERP are presented (Rank Top 100 and Search Query APIs deliver that data in the same way).
If you'd like to help determining which of our API plans is most appropriate for your needs, contact our service team
and an account manager will be happy to assist you.
If you already have a Rank Ranger plan and see an error message when accessing the Account > Connections > API & Connected Apps screen, then to obtain API access you will need to upgrade to a package that includes API access by completing a custom package request
form or contacting Rank Ranger support
with your requirements.
If your company has API services included in a plan and you aren't able to access the screen, contact your company's Rank Ranger acccount administrator to request that your user permissions
be set to include access to the Account > API and Connected Apps screen.
You can obtain API Keys per user if your Rank Ranger account has API access by navigating to
2. Connections > API & Connected Apps
3. Click the Generate Key
4. Select a User and add a note (optional)
5. Click the Add
To make construction of API requests easy, we offer this API testing tool. Most parameters are included in the options of the console, however, you may need to add custom option parameters to your API requests based on the specific API you're using. Referencing the parameters information that is listed in the specific API method documentation, you can construct and test API requests in Rank Ranger's API Console
by navigating to:
3. API Console
4. Select the Method and complete the applicable fields
5. Click the Generate button
6. Test your API method by clicking the launch URL icon and view your results. Once your results are as you want them, copy that URL into your own application and modify as needed for each request.
Getting Started: Samples of APIs used for Creating Campaigns
We recommend reviewing our Best Practices Guide
prior to structuring campaigns.
Get Packages Info
: Required when there is more than 1 package in an account
Add a Profile
: An option for adding an identifier to your campaigns for categorization (e.g., by language, country, etc)
Get Profile ID list
: Optional Data needed for Add a Campaign
Obtain the Search Engine List
: Data needed for Add a Campaign
Add a Campaign
: Create a new campaign, response will include the Campaign ID number that is needed for adding a search engine and keywords
*Note that Profile ID is an optional field that you may use, if you choose not to use it, then please remove "&profile_id=ProfileIDnumber” from the end of this call
Add a Search Engine
: Add search engine to a campaign
Add a Keyword
: An optional field is available for keyword_identifier field, allowing you to add your own unique identifier to each keyword
Bulk Add Keywords
: You may download and use the spreadsheet found on the Campaign Settings > Keywords screen to organize and import your keywords, or use this API
You'll find additional API methods in the Account Management and Data documentation
Rank Ranger APIs can pull up to 100 queries per minute. If more than 10,000 API GET requests per hour is required, then there is an option available at an additional throughput fee, contact customer service for assistance.
Rank Reporting Method Limits
Research API Methods
- Rank Data & Research Reporting API methods can only provide data from campaigns tracking in your Rank Ranger account.
- You can run an unlimited number of queries through the API.
Search API Method Limits
- The variety of Research Method APIs have limits on the number of queries per day based on the capacity of your package. If you require additional units, please contact customer service and an account manager will provide you with package upgrade pricing.
- SEO Intelligence API method query limits are based on the number of units purchased for your custom plan (e.g., 1 unit = 1 keyword tracked on 1 search engine, 1 time).
- Search API plans do not include access to the reporting platform.