MarkdownCopies this page as Markdown, ready to paste into an AI assistant.
Google Maps API
2 Google Maps endpoints behind one key, priced in credits per call and routed to the cheapest healthy source.
On this page
Search & SEO · 2 endpoints · from 2 credits per call
Endpoints
- POSTGoogle Maps Nearby Search
/v1/run/maps.search_nearbySearch Google Maps around exact coordinates and zoom and get one viewport of up to 20 places with the address split into street, city, state, postal code and country.2 creditsper call - POSTGoogle Maps Search
/v1/run/maps.searchSearch Google Maps for places matching a query in a free-text location and get up to 20 normalised places with rating, address, phone, website and coordinates.2 creditsper call
Calling them
Every endpoint on this page is one POST to https://api.primaryapi.com/v1/run/{sku} with your API key and a JSON body. Responses share one envelope, so code written for one endpoint handles the others. For example, maps.search_nearby:
curl -sS -X POST "https://api.primaryapi.com/v1/run/maps.search_nearby" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"pizza","coordinates":{"latitude":40.7455096,"longitude":-74.0083012},"zoom":14}'const res = await fetch('https://api.primaryapi.com/v1/run/maps.search_nearby', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PRIMARYAPI_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
query: 'pizza',
coordinates: {
latitude: 40.7455096,
longitude: -74.0083012,
},
zoom: 14,
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.error}`);
// found:false is a successful answer ("does not exist"), not an error
console.log(body.output.found ? body.output.data : body.output.reason, body.credits);import os
import requests
res = requests.post(
"https://api.primaryapi.com/v1/run/maps.search_nearby",
headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"},
json={
"query": "pizza",
"coordinates": {
"latitude": 40.7455096,
"longitude": -74.0083012,
},
"zoom": 14,
},
timeout=60,
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['code']}: {body['error']}")
# found=False is a successful answer ("does not exist"), not an error
print(body["output"]["data"] if body["output"]["found"] else body["output"]["reason"], body["credits"])New to PrimaryAPI? Start with the Quickstart, then read Making requests.