📍Local SEO GBP Project Creation

Open in

View as Markdown

Open in ChatGPT Open in Claude

Camilo Aponte

Last updated on Sep 30, 2026

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 REDACTED-EXPIRED-EXAMPLE-TOKEN" }, { "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": [] } ] }