Skip to main content

Local SEO GBP Project Creation

The GMB-V2 API allows users to manage Google My Business (GMB) data, including adding businesses, searching for locations, retrieving place details, and setting up grid tracking for local SEO analysis.

Updated over 3 months ago

Authentication

All API requests require an API key passed as a query parameter:

searchatlas_api_key=<your_api_key>

Endpoints

1. Add a Business

Endpoint:

POST https://keyword.searchatlas.com/api/v3/google-business/

Payload:

{   "business_name": "string",   "data_cid": "string",   "google_url": "string",   "address": "string",   "location": {     "type": "Point",     "coordinates": [latitude, longitude]   },   "center": {     "type": "Point",     "coordinates": [latitude, longitude]   } }

2. Add a Business with URL

Endpoint:

POST https://keyword.searchatlas.com/api/v3/google-business/

Payload:

{   "business_url": "string" }

3. Search for Businesses by Text

Endpoint:

GET https://keyword.searchatlas.com/api/v3/google-business/text-search/

Query Parameters:

  • query: Business name (e.g., "KFC")

  • lat: Latitude

  • long: Longitude

  • searchatlas_api_key: API key

4. Retrieve Place Details

Endpoint:

GET https://keyword.searchatlas.com/api/v3/google-business/place-detail/

Query Parameters:

  • place_id: Unique place identifier

  • searchatlas_api_key: API key

5. Set Up Grid Tracking

Endpoint:

POST https://keyword.searchatlas.com/api/v3/google-business/{{business_id}}/setup-grids/

Payload:

{   "keyword": "string",   "update_frequency_days": int,   "grid_size": int,   "grid_shape": "string",   "spacing": int,   "grid_coordinates": [     {"lat": latitude, "lon": longitude}   ],   "recrawl_time": "HH:MM:SS" }

Notes

  • API requests should be properly authenticated using the provided API key.

  • Ensure valid coordinates are passed when adding businesses or setting up grids.

For more details, refer to the official API documentation at SearchAtlas.

Postman Collection

{ "info": { "_postman_id": "13acd65c-9ebc-4305-9e62-4d408c0889b6", "name": "GMB-V2", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "18279724" }, "item": [ { "name": "add-business", "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"business_name\": \"KFC\",\n \"data_cid\": \"7998182588890038297\",\n \"google_url\": null,\n \"address\": \"208 McGuinness Blvd, Brooklyn, NY 11222, USA\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 40.7298715,\n -73.95059549999999\n ]\n },\n \"center\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 40.7298715,\n -73.95059549999999\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://keyword.searchatlas.com/api/v3/google-business/?searchatlas_api_key=<your_api_key>", "protocol": "https", "host": [ "keyword", "searchatlas", "com" ], "path": [ "api", "v3", "google-business", "" ], "query": [ { "key": "searchatlas_api_key", "value": "<your_api_key>" } ] } }, "response": [] }, { "name": "add-business-with-url", "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [ { "key": "authority", "value": "keyword.searchatlas.com" }, { "key": "accept", "value": "application/json, text/plain, */*" }, { "key": "accept-language", "value": "en-US,en;q=0.9,ur;q=0.8" }, { "key": "authorization", "value": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoic2xpZGluZyIsImV4cCI6MTcyMTY1OTkwNCwianRpIjoiNDVlNDgxZDNiZTQ1NGFiMDkzN2M2NTkwOWI0OGZhNjQiLCJyZWZyZXNoX2V4cCI6MTcyMTY1OTkwNCwidXNlcl9pZCI6MTY3MzAsImN1c3RvbWVyIjp7ImlkIjo0MzksImVtYWlsIjoic2FhZEBsaW5rZ3JhcGguaW8iLCJ0ZWFtX2lkcyI6WzE5MTc3MSwxOTExODIsMTkwNjExLDE5MDM2MCwxODk1NzMsMTg4NTg4LDE4ODU4NiwxODY2MTgsMTg2MzMyLDE4NjMyOSwxODYzMTgsMTg2MzE1LDE4NTg4NCwxODU4NzMsMTg1ODYyLDE4NTE5NSwxODM3MzUsMTc5NTMwLDE3MzM2MSwxNTcwNjQsMTUzMTQwLDE0MjM5NiwzMzM0OSwzMTE4MywyODQ2OCwyNzczMiwyMDc1NiwyMDQxOSwxOTc0OSwxNzAxNSwxNjczMCwxNjYxMSwxMjUyNiwxXSwiaXNfc3Vic2NyaWJlciI6dHJ1ZSwicXVvdGEiOnsiY2EiOnsiYWxsb3dlZF9wYWdlcyI6MjAwLCJhbGxvd2VkX29ucGFnZV9hdWRpdHMiOjIwMCwiYWxsb3dlZF9mb2N1c190ZXJtcyI6MTAwMCwiYWxsb3dlZF9zaXRlX2F1ZGl0b3JfcHJvamVjdHMiOjEwMCwiYWxsb3dlZF9zaXRlX2F1ZGl0b3JfcGFnZXMiOjEwMDAwMDAsImNyYXdsZWRfcGFnZXNfYWxsb3dlZF9wZXJfbW9udGgiOjEwMDAwMDAsImFsbG93ZWRfYWlfY29udGVudF9nZW5lcmF0aW9uIjo5OTk5OSwiYWxsb3dlZF9vdHRvX3Byb2plY3RzIjoxMDAsImFsbG93ZWRfYWlfcHJlbWl1bV9jb250ZW50X2dlbmVyYXRpb24iOjMwfSwiZ3NjIjp7ImFsbG93ZWRfYWN0aXZlX3Byb2plY3RzIjoxMDAsImFsbG93ZWRfc2l0ZV9rZXl3b3JkcyI6MTExLCJhbGxvd2VkX3BhZ2VzIjoxMDAwMDAwLCJoaXN0b3JpY2FsX2xpbWl0IjoiMyB5ZWFycyIsInByb2plY3RfZGVhY3RpdmF0aW9uc19hbGxvd2VkX3Blcl9tb250aCI6MzB9LCJibCI6eyJ1c2VfZGVtbyI6dHJ1ZSwiYnVkZ2V0IjoyMywibWF4X2NvbXBldGl0b3JzX3Blcl9wcm9qZWN0Ijo0LCJtYXhfbnVtYmVyX29mX3Byb2plY3RzIjo1LCJhbGxvd2VkX2JhY2tsaW5rX3Jlc2VhcmNoZXMiOjUwMDAwMH0sImtlIjp7Im1heF9rZXl3b3JkX2xvb2t1cHMiOjUwMDAsIm1heF9rZXl3b3JkX2xvb2t1cHNfcGVyX3dlZWsiOjEwMDAsImFsbG93ZWRfY29tcGV0aXRvcl9yZXNlYXJjaGVzIjo1MDAwMDAsImFsbG93ZWRfdHJhY2tlZF9rZXl3b3JkcyI6NTAwMCwiYWxsb3dlZF90cmFja2VkX3Byb2plY3RzIjoyNSwiYWxsb3dlZF9jb250ZW50X3BsYW5zIjoyMDAsImFsbG93ZWRfY29tcGV0aXRvcl9yZXNlYXJjaF9wcm9qZWN0cyI6NTAwLCJhbGxvd2VkX2xvY2FsX3NlcnBzX2hlYXRtYXBfc2VhcmNoZXMiOjEzNTAwLCJhbGxvd2VkX2J1bGtfYW5hbHlzaXNfdXJscyI6NTAwMCwiYWxsb3dlZF9zaXRlX2V4cGxvcmVyX3NhdmVkX3Byb2plY3RzIjoxNSwiYWxsb3dlZF9vdXRyZWFjaF9zZW50X2VtYWlscyI6MTAwMDAsImFsbG93ZWRfb3V0cmVhY2hfY2FtcGFpZ25zIjozfSwicHNpIjp7ImFsbG93ZWRfcHNpX3BhZ2VzIjoyMDAwfSwiYnVsayI6eyJkYV9jaGVja2VyX21heF9sb29rdXBzX3Blcl9kYXkiOjExfSwicXAiOnsiYWxsb3dlZF9oYXJvX3JlcGxpZXMiOjIwMH0sImV4cGlyZXNfYXQiOiIyMDI0LTAxLTI3IDEzOjEyOjQyIn0sInBsYW4iOiJQUk8iLCJzZWF0cyI6MTUsInRyaWFsX2V4cGlyZXNfYXQiOm51bGwsInRpbWV6b25lIjoiQXNpYS9LYXJhY2hpIiwiaXNfd2hpdGVsYWJlbCI6ZmFsc2UsIndoaXRlbGFiZWxfZG9tYWluIjoiIiwiaXNfdmVuZGFzdGFfY2xpZW50IjpmYWxzZSwicGhvbmVfbnVtYmVyIjoiKzkxNjM4NDM4MzQyMyIsImNvbXBhbnlfbmFtZSI6IkxpbmtHcmFwaCBFbmdpbmVlcmluZyBBY2NvdW50IiwibG9nbyI6Imh0dHBzOi8vc3RvcmFnZS5nb29nbGVhcGlzLmNvbS9saW5rZ3JhcGgtY3VzdG9tZXItbG9nby9pY29uczgtaW50ZXJuZXQtMTYucG5nP1gtR29vZy1BbGdvcml0aG09R09PRzQtUlNBLVNIQTI1NiZYLUdvb2ctQ3JlZGVudGlhbD1nY3MtZnVsbC1hY2Nlc3MlNDBvcmdhbmljLXJ1bGVyLTIwNzEyMy5pYW0uZ3NlcnZpY2VhY2NvdW50LmNvbSUyRjIwMjQwMTI0JTJGYXV0byUyRnN0b3JhZ2UlMkZnb29nNF9yZXF1ZXN0JlgtR29vZy1EYXRlPTIwMjQwMTI0VDE0NTE0NFomWC1Hb29nLUV4cGlyZXM9ODY0MDAmWC1Hb29nLVNpZ25lZEhlYWRlcnM9aG9zdCZYLUdvb2ctU2lnbmF0dXJlPTY0NmFkODY5OWEyYzA1MjYzMzAzYTViMmQwZmVjNmQ3MGExYmUzZDNiN2EyMTZlNjdjZmFjNjlkNjg0ODNhZDcyMDVlY2FlZGZjNzFiNDIxOGYzY2IyNzQ0MjMwMDc1YmEyYjRhOWMyYzE5YzM2ZTYyYTBjNTVkYzFiZWI5MDViNmFmMzcyY2FhNTc2ODI1ZDlkOWM3NjQ4OGU5NmY3ZWNhMzNhZmYzODMyNGM1YjNmN2MzN2JjNjg5YWJjYTg0MzRhMDMwZTY5MWRkYmMwOGIxNGY5NmNjOWY4MTA0NjYxYjVhZjk4MWZiMzMzMDQyYjk0ZjJjMTk5NzJlYjlkN2I0NWI1YWIzYzRmOGU1MWJlNmY5Mjg1YzEzNGFlYzIzYjhhOGYzMTM5ZjY3N2FiMmI2MTY3NWMyYjc4NTZmNzczODNhNzM5MGU5MmYwNTNiZGRlZjAyNTE3NGM2MTMzYzFjN2U1NzA1MWU4ODFjYzEzYjcwOWFmMmI1NGYwMzliMjQwM2M5ZGIxNjZlZmU5NTZmZWYzZTJkZTlhNzdlM2JiNmYyZDk3YjljNTBlZjIyMGQ3NzM2YzIzZWVmMTczN2Y2ODIzNjFhMTg2MTRhMGZiY2IxN2U4MjlkZmEwM2IzNDA1MWZlNjQ2NGRlNTc5YzZkNzhmMWVjMTNmNjYwZGNkIiwic2hvdWxkX2NoaWxkcmVuX3JlY2VpdmVfZW1haWxzIjpmYWxzZSwicmVnaXN0cmF0aW9uX3NvdXJjZSI6bnVsbH19.0alM8eXxAXBZzqp6ybk21ubSZjQMsJIobrWN0pY5blM" }, { "key": "cache-control", "value": "no-cache" }, { "key": "content-type", "value": "application/json" }, { "key": "origin", "value": "http://localhost:3000" }, { "key": "pragma", "value": "no-cache" }, { "key": "referer", "value": "http://localhost:3000/" }, { "key": "sec-ch-ua", "value": "\"Not_A Brand\";v=\"8\", \"Chromium\";v=\"120\", \"Google Chrome\";v=\"120\"" }, { "key": "sec-ch-ua-mobile", "value": "?0" }, { "key": "sec-ch-ua-platform", "value": "\"Linux\"" }, { "key": "sec-fetch-dest", "value": "empty" }, { "key": "sec-fetch-mode", "value": "cors" }, { "key": "sec-fetch-site", "value": "cross-site" }, { "key": "user-agent", "value": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" } ], "body": { "mode": "raw", "raw": "{\"business_url\":\"https://www.google.com/maps/place/Quetta+Darbar+Cafe/@31.5529046,74.3151824,17z/data=!3m1!4b1!4m6!3m5!1s0x3919055fdb2a8675:0x46a0a86e06d88fb9!8m2!3d31.5529046!4d74.3151824!16s%2Fg%2F11rn79bcmd?authuser=0&hl=en&entry=ttu\"}" }, "url": { "raw": "https://keyword.searchatlas.com/api/v3/google-business/?searchatlas_api_key=<your_api_key>", "protocol": "https", "host": [ "keyword", "searchatlas", "com" ], "path": [ "api", "v3", "google-business", "" ], "query": [ { "key": "searchatlas_api_key", "value": "<your_api_key>" } ] } }, "response": [] }, { "name": "text-search", "request": { "auth": { "type": "noauth" }, "method": "GET", "header": [], "url": { "raw": "https://keyword.searchatlas.com/api/v3/google-business/text-search/?query=kfc&lat=40.73061&long=-73.935242&searchatlas_api_key=<your_api_key>", "protocol": "https", "host": [ "keyword", "searchatlas", "com" ], "path": [ "api", "v3", "google-business", "text-search", "" ], "query": [ { "key": "query", "value": "kfc" }, { "key": "lat", "value": "40.73061" }, { "key": "long", "value": "-73.935242" }, { "key": "searchatlas_api_key", "value": "<your_api_key>" } ] } }, "response": [] }, { "name": "place-detail", "request": { "auth": { "type": "noauth" }, "method": "GET", "header": [], "url": { "raw": "https://keyword.searchatlas.com/api/v3/google-business/place-detail/?place_id=ChIJ8-TBCkdZwokRGUCBO7BA_24&searchatlas_api_key=<your_api_key>", "protocol": "https", "host": [ "keyword", "searchatlas", "com" ], "path": [ "api", "v3", "google-business", "place-detail", "" ], "query": [ { "key": "place_id", "value": "ChIJ8-TBCkdZwokRGUCBO7BA_24" }, { "key": "searchatlas_api_key", "value": "<your_api_key>" } ] } }, "response": [] }, { "name": "setup-grids", "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"keyword\": \"kfc burger\",\n \"update_frequency_days\": 7,\n \"grid_size\": 3,\n \"grid_shape\": \"square\",\n \"spacing\": 1,\n \"grid_coordinates\": [\n {\n \"lat\": 40.715414489067456,\n \"lon\": -73.96967325202148\n },\n {\n \"lat\": 40.715414489067456,\n \"lon\": -73.9505955\n },\n {\n \"lat\": 40.715414489067456,\n \"lon\": -73.93151774797853\n },\n {\n \"lat\": 40.7298715,\n \"lon\": -73.96967325202148\n },\n {\n \"lat\": 40.7298715,\n \"lon\": -73.9505955\n },\n {\n \"lat\": 40.7298715,\n \"lon\": -73.93151774797853\n },\n {\n \"lat\": 40.74432851093255,\n \"lon\": -73.96967325202148\n },\n {\n \"lat\": 40.74432851093255,\n \"lon\": -73.9505955\n },\n {\n \"lat\": 40.74432851093255,\n \"lon\": -73.93151774797853\n },\n {\n \"lat\": 40.7298715,\n \"lon\": -73.9505955\n }\n ],\n \"recrawl_time\": \"00:00:00\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://keyword.searchatlas.com/api/v3/google-business/{{business_id}}/setup-grids/?searchatlas_api_key=<your_api_key>", "protocol": "https", "host": [ "keyword", "searchatlas", "com" ], "path": [ "api", "v3", "google-business", "{{business_id}}", "setup-grids", "" ], "query": [ { "key": "searchatlas_api_key", "value": "<your_api_key>" } ] } }, "response": [] } ] }
Related Articles
GBP Galactic/Local SEO Knowledge Base
OTTO SEO Project Creation
Keyword Rank Tracker Project Creation
Press Releases
Cloud Stacks
Did this answer your question?