Local Dominator API - OpenAPI 3.0 (1.0.0)

Download OpenAPI specification:

E-mail: team@localdominator.co Terms of Service

Local Dominator

List scans

Authorizations:

BearerAuth

query Parameters

text	string Filter scans by text(name, keywords, labels)
per_page	integer Default: 10 Example: per_page=10
page	integer Default: 0 Example: page=0
start_date	string <date> Example: start_date=2024-01-01 Retrieve scans that occurred on or after the specified start date (in YYYY-MM-DD format).
end_date	string <date> Example: end_date=2024-08-31 Retrieve scans that occurred on or before the specified end date (in YYYY-MM-DD format).
labels	Array of strings An array of labels associated with the scan

Responses

Response samples

Content type

application/json

{"totalcount": 10,
"scans": [{"keyword": "Something near me",
"name": "Something INC.",
"vicinity": "Something street 69 Somethingland",
"place_id": "ChIJszZ0aEdOqTcR-wk88Z99zx8",
"data_id": "0x872b09a937691f09:0x430887a672cf2151",
"grid_size": 6,
"locations_distance": 1609.344,
"shape": "circle",
"creation_timestamp": "2024-07-12 14:08:50.736785+00",
"center_lat": 10.69696,
"center_lng": 10.42,
"average_rank": 5.5,
"view_only_link": "https://app.localdominator.co/static-images/heat-map-image?heatmapRecordId=00000&link=fec59b7a-707f-4c14-434d5-b680432aa0186",
"content": [[5,
5,
5,
4,
4,
8,
5
],
[5,
5,
5,
3,
1,
3,
2
],
[5,
5,
2,
2,
2,
2,
2
],
[4,
3,
2,
1,
1,
2,
4
],
[3,
3,
2,
2,
2,
3,
2
],
[null,
3,
3,
2,
2,
6,
5
],
[null,
null,
null,
null,
2,
2,
2
]
],
"pins_status": [[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[0,
1,
1,
1,
1,
1,
1
],
[0,
0,
0,
0,
1,
1,
1
]
],
"labels": ["string"
]
}
]
}

Perform a scan

Initiates a scan based on the specified parameters.

Authorizations:

BearerAuth

Request Body schema: application/json
required

latitude required	number <float> Latitude of the center point from where the scan will be performed.
longitude required	number <float> Longitude of the center point from where the scan will be performed.
shape required	string Enum: "circle" "square" Shape of the scan area, either circle or square.
distance required	integer <int32> Distance in meters defining the square side or circle diameter.
google_place_id required	string The PlaceID in Google. For example, `ChIJgUbEo8cfqokR5lP9_Wh_DaM`.
grid_size required	integer <int32> Defines the number of points on each square side or diameter to perform the search from.
search_terms required	Array of strings Array of strings representing the search terms to use during the scan.
webhook_url	string A url where we will POST the results back once the scan is completed.

Responses

Request samples

Payload

Content type

application/json

{"latitude": 40.712776,
"longitude": -74.005974,
"shape": "circle",
"distance": 1000,
"google_place_id": "ChIJgUbEo8cfqokR5lP9_Wh_DaM",
"grid_size": 13,
"search_terms": ["coffee shop",
"restaurant"
],
"webhook_url": "https://mybusiness.com/webhooks/scans"
}

Response samples

Content type

application/json

{"message": "Scan creation started.",
"scan_uuid": "xPH5x_SZcmcf8E7FROCNQ"
}

Retrieve scan details

Returns the details of the scan specified by scan_id.

Authorizations:

BearerAuth

path Parameters

scan_id

required

string

The ID of the scan

Responses

Response samples

Content type

application/json

[{"keyword": "Something near me",
"name": "Something INC.",
"vicinity": "Something street 69 Somethingland",
"place_id": "ChIJszZ0aEdOqTcR-wk88Z99zx8",
"data_id": "0x872b09a937691f09:0x430887a672cf2151",
"grid_size": 6,
"locations_distance": 1609.344,
"shape": "circle",
"creation_timestamp": "2024-07-12 14:08:50.736785+00",
"center_lat": 10.69696,
"center_lng": 10.42,
"average_rank": 5.5,
"view_only_link": "https://app.localdominator.co/static-images/heat-map-image?heatmapRecordId=00000&link=fec59b7a-707f-4c14-434d5-b680432aa0186",
"content": [[5,
5,
5,
4,
4,
8,
5
],
[5,
5,
5,
3,
1,
3,
2
],
[5,
5,
2,
2,
2,
2,
2
],
[4,
3,
2,
1,
1,
2,
4
],
[3,
3,
2,
2,
2,
3,
2
],
[null,
3,
3,
2,
2,
6,
5
],
[null,
null,
null,
null,
2,
2,
2
]
],
"pins_status": [[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[1,
1,
1,
1,
1,
1,
1
],
[0,
1,
1,
1,
1,
1,
1
],
[0,
0,
0,
0,
1,
1,
1
]
],
"labels": ["string"
]
}
]

Delete a scan

Authorizations:

BearerAuth

path Parameters

scan_id

required

string

The ID of the scan

Responses

Scan results

The details of each business in every point in the scan.

Authorizations:

BearerAuth

path Parameters

scan_id

required

string

The ID of the scan

Responses

Response samples

Content type

application/json

[{"scan_id": 1,
"compressed_grid": [[0
]
],
"details_array": [{"place_id": "ChIJCR9pl6kJK4cRUCHPcqaHCPr",
"data_id": "0x872b09a997691f09:0xa30887a672cf2150",
"name": "Something INC.",
"vicinity": "Something street 4",
"location": {"latitude": 1.222,
"longitude": 100.222
},
"rating": 2.5,
"rating_count": 620,
"primary_category": "Somethining",
"secondary_categories": ["string"
],
"website_url": "https://blabla.bla",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipOhmkR0OvHtSW3CY1aynhYfz6wAqQAX9NzImB0=w408-h544-k-no"
}
]
}
]

Local Dominator API - OpenAPI 3.0 (1.0.0)

List scans

Authorizations:

query Parameters

Responses

Response samples

Perform a scan

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieve scan details

Authorizations:

path Parameters

Responses

Response samples

Delete a scan

Authorizations:

path Parameters

Responses

Scan results

Authorizations:

path Parameters

Responses

Response samples

Request Body schema: application/json
required