JustSERPDocs
Google

Google Rank Tracking

Where sites stand for a query: up to a hundred organic results in one answer, counted through the pages.

GET
/v1/google/rank-tracking

Where sites stand for a query: up to a hundred organic results in one answer, counted through the pages. Answers the document: search_metadata, search_parameters, search_information (with pages_read, and results_found when fewer than num were found: the pages stopped, Google showed its verification page, or time ran out) and organic_results, whose position counts across the pages and whose link is the site's own address. No pagination. Desktop only.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What to search for.

Length1 <= length
location?string

A canonical place name, e.g. "Austin,Texas,United States" (becomes Google's uule). Not with uule.

uule?string

Google's own location value (w+CAIQ...). Not with location.

latitude?number

With longitude.

Range-90 <= value <= 90
longitude?number

With latitude.

Range-180 <= value <= 180
gl?string

Country of the search, two letters.

Default"us"
hl?string

Interface language, e.g. en, pt-br.

Default"en"
device?"desktop"

Only desktop: mobile and tablet are a 400.

Default"desktop"
Value in"desktop"
lr?string

Language of the documents, lang_fr or several lang_it|lang_de.

safe?string

Adult-content filtering.

Default"blur"
Value in"active""blur""off"
page?integer

The Google page to start at; positions continue from the pages before it.

Range1 <= value <= 10
Default1
num?integer

How many results.

Range1 <= value <= 100
Default100

Response Body

The results, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Rank Tracking document.

search_metadata?
search_parameters?

The request as sent, with the defaults that were used.

search_information?
organic_results?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/rank-tracking?q=rank+tracker&num=30'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string",    "total_results": 0,    "time_taken_displayed": 0,    "pages_read": 0,    "results_found": 0  },  "organic_results": [    {      "position": 0,      "title": "string",      "link": "string",      "source": "string",      "domain": "string",      "displayed_link": "string",      "snippet": "string",      "snippet_highlighted_words": [        "string"      ],      "date": "string",      "favicon": "string"    }  ]}