RankSharkDocs
Lookups

Find a business on Google Maps

RankShark TrackScopetrack:write

POST
/v1/track/find

A Google Maps place link is read directly; anything else is searched on Google Maps (up to ~110 s; 60 searches an hour, one at a time). Use a result as a campaign's business.

Scope: track:write.

Authorization

headerAuthorizationBearer <rstk_… API key or OAuth access token>

A Track API key (rstk_…, Settings → API & MCP) or an OAuth access token issued for this API

Request Body

application/json
  1. body
query*string

Business name and city, or a Google Maps place link

Length2 <= length <= 500
country?string

Country code (default us)

Lengthlength <= 2
language?string

Language code (default en)

Lengthlength <= 12
lat?number

Search near this position (with lng)

Range-85 <= value <= 85
lng?number
Range-180 <= value <= 180

Response Body

OK

application/json
  1. response
businesses*array<>

Best match first (third-party data)

source*string

link: read from the link; maps: a Google Maps search

Value in"link""maps"
Example Request
curl -X POST 'https://panel.rankshark.io/v1/track/find' \  -H 'Content-Type: application/json' \  -d '{  "query": "Harbor Dental Austin TX",  "country": "us"}'
Example Response
{  "businesses": [    {      "name": "Harbor Dental",      "address": "1200 S Congress Ave, Austin, TX 78704",      "category": "Dentist",      "lat": 30.2509,      "lng": -97.7493,      "fid": "0x8644b50a3e3c0b1d:0x6a8d1e2f3c4b5a69",      "pid": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",      "cid": "7677826127960431209",      "website": "https://harbordental.example",      "phone": "+1 512-555-0142",      "mapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJd8BlQ2BZwokRAFUEcm_qrcA",      "rating": 4.8,      "reviews": 312    }  ],  "source": "maps"}

Update a campaign PATCH

Only the fields sent change. Removing a keyword (or an engine, or changing the mode) drops its latest-result summary; its scans stay. A quick scan cannot be edited (409 prospect). Scope: `track:write`.

Read a business website POST

For campaigns of a business without a Maps listing: the name, category, address and position its page declares. Public http(s) websites only; a page that is very slow or very large may not be read. Scope: `track:write`.