AuthoritasSERPs API Documentation

Get keyword rankings, PPC data, and search engine rankings.

Learn more about this API

POSTcreateSERPsJob

POSTgetSERPsJob

Creates a new job to be processed. Upon successfully accepting the request you will receive a job id (UUID) that can later be used to retrieve the SERPs data

Header Parameters

X-RapidAPI-HostSTRING

REQUIRED

X-RapidAPI-KeySTRING

REQUIRED

Required Parameters

phraseSTRING

REQUIREDThe search term / keyword

apiKeyCREDENTIALS

REQUIREDApi key

languageSTRING

REQUIREDThe language code to use.

apiSecretCREDENTIALS

REQUIREDApi secret

apiSaltCREDENTIALS

REQUIREDApi salt

regionSTRING

REQUIREDThe region code to use

searchEngineSTRING

REQUIREDThe search engine to query. Examples: bing, google, yahoo, yandex, baidu

Optional Parameters

userAgentSTRING

OPTIONALThe user agent to use. See below

includeAllInUniversalBOOLEAN

OPTIONALWether to incude ads in universal section. Default false

strategySELECT

OPTIONALThe serps fetch strategy. standard - this is the default strategy, we will try to fetch SERPs with 10 results per page, so max_results: 100 will yield 10 pages. economic - we will try to fetch the first X pages with 10 results each then a last page with the remainder, so max_results: 100 will yield X+1 pages

searchTypeSELECT

OPTIONALThe type of search to perform: web site or country. Default: web

maxResultsNUMBER

OPTIONALThe number of results to return. Any number up to 500. Default: 100

townSTRING

OPTIONALThe town to use

useCacheBOOLEAN

OPTIONALWether to use cached data, if available

fullPagesCountNUMBER

OPTIONALWork only with strategy = Economic. Fetch the first full_pages_count pages with 10 results each then a last page with the remainder, so max_results: 100 will yield full_pages_count + 1 pages. Default: 3