API Reference
Places Search
Search local business listings and venues with reviews, addresses, and maps data.
The places search endpoint retrieves local business listings, venue maps data, reviews, and contact information.
It returns geographic latitude/longitude coordinates, full addresses, customer review counts, star ratings, and phone numbers.
Returned Local Place Properties
Each object in the places response array contains structured venue data:
title: Name of the business or place listingaddress: Street address, city, postal code, and countrylatitude: Decimal geographic latitude coordinatelongitude: Decimal geographic longitude coordinaterating: Average customer review score (e.g.4.1out of 5.0)reviews: Total number of user reviewsphone: Contact telephone number in international formatcategory: Primary business category (e.g."Coffee shop","Restaurant")position: Search position rank (1-based)
{
"q": "starbucks New York",
"location": "New York, NY, United States",
"num": 10
}
Authorizations
X-API-KEYstringheaderrequired
Passed via request headers. Your secret API key for SerperMatrix (e.g.
sm_live_...).Body
application/json
qstringrequired
Query string specifying venue types or keywords (e.g.
"starbucks New York").glstring
Country code for local search context.
hlstring
Language filter for text reviews and metadata.
locationstring
Specific city, region, or state boundary mapping coordinates.
numintegerdefault: 10
Number of local businesses to return.
use_cachebooleandefault: true
Retrieve cached local response if available.
Request
curl -X POST https://serpermatrix.com/api/v1/places \
-H "X-API-KEY: sm_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"q":"starbucks New York","num":1}'{
"searchParameters": {
"q": "starbucks New York",
"num": 1,
"type": "places"
},
"places": [
{
"title": "Starbucks - Times Square",
"address": "1500 Broadway, New York, NY 10036, United States",
"latitude": 40.7562,
"longitude": -73.9858,
"rating": 4.1,
"position": 1
}
]
}