← Back to Serper
POST/maps

Google Maps Search

Google Maps search - returns map listings with titles, addresses, latitude/longitude coordinates, ratings, review counts, phone numbers, websites, and categories. More detailed than Places for location-based queries. Use ll parameter for precise geographic targeting. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

Serper·$0.006 per call

Example code

// Using @orth/sdk - The simplest way to call APIs // Install: npm install @orth/sdk import Orthogonal from "@orth/sdk"; const orthogonal = new Orthogonal({ apiKey: process.env.ORTHOGONAL_API_KEY, }); const output = await orthogonal.run({ api: "serper", path: "/maps", body: { "q": "example" } }); console.log(output);

Body parameters

qrequired
string

Search query

gl
string

Country code (e.g. us, uk, de)

hl
string

Language code (e.g. en, es, fr)

num
number

Number of results (default 10)

page
number

Page number for pagination For later pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

autocorrect
boolean

Enable autocorrect (default true)

location
string

Location name for localized results (e.g. "New York, NY")

ll
string

Latitude/longitude with zoom (e.g. "@40.7128,-74.0060,15z"). More precise than location.

Response

ll
string
places.0.cid
string
places.0.fid
string
places.0.type
string
places.0.title
string
places.0.types.0
string
places.0.rating
number
places.0.address
string
places.0.placeId
string
places.0.website
string
places.0.latitude
number
places.0.position
number
places.0.longitude
number
places.0.phoneNumber
string
places.0.ratingCount
number
places.0.bookingLinks.0
string
places.0.openingHours.sobota
string
places.0.openingHours.wtorek
string
places.0.openingHours.środa
string
places.0.openingHours.piątek
string
places.0.openingHours.czwartek
string
places.0.openingHours.niedziela
string
places.0.openingHours.poniedziałek
string
places.0.thumbnailUrl
string
credits
number
searchParameters.q
string
searchParameters.gl
string
searchParameters.hl
string
searchParameters.num
number
searchParameters.page
number
searchParameters.type
string
searchParameters.engine
string
priceCents
number

Actual Orthogonal credits charged for this /v1/run call. Accepted continuation pages are charged 0.

quotedPriceCents
number

Price this call would normally cost before continuation billing is applied.

billing.requestId
string

Unique Orthogonal request ID for this page or poll call. Save the first call requestId and pass it as parentRequestId on later pages.

billing.parentRequestId
string|null

Parent Orthogonal request ID when this call is a continuation of an earlier search.

billing.rootRequestId
string

Root Orthogonal request ID for the full logical search.

billing.continuation
boolean

True when this call was accepted as a continuation page or poll.

billing.billable
boolean

False for accepted continuation pages because they are not charged again.

billing.quotedPriceCents
number

Quoted price for this page or poll before continuation billing.

billing.chargedPriceCents
number

Actual credits charged for this page or poll. Accepted continuations return 0.

billing.aggregateChargedPriceCents
number

Total charged so far for the full logical search, including the first page and accepted continuations.

    Orthogonal - Giving AI agents the tools they need.