Serper: Maps

Google Maps / local business search with addresses, phone numbers, ratings, websites, and CIDs.

Tool ID: serper_google_maps_search

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'serper_google_maps_search',
  {
    "query": "software companies hiring engineers"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute serper_google_maps_search --input '{
  "query": "software companies hiring engineers"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "searchParameters": {},
    "places": [
      {
        "position": 123,
        "title": "VP of Engineering",
        "address": "example"
      }
    ]
  }
}

Use deepline tools get serper_google_maps_search --json for the latest machine-readable contract.

Input reference

Run a Serper Google Maps search. Returns a fixed ~20 places per call and is billed per call, not per place, so narrow the result set with a more specific query or an ll location bias rather than by paging. Unlike serper_google_search, this endpoint does not support a num result cap.

Name	Type	Required	Default	Details
`payload.query`	`string`	Yes	—	Maps search query string.
`payload.ll`	`string`	No	—	GPS position and zoom in `@latitude,longitude,zoom` format. Minimum length: 1.
`payload.placeId`	`string`	No	—	Optional Google place ID filter/anchor. Minimum length: 1.
`payload.cid`	`string \| integer`	No	—	Optional Google CID filter/anchor.
`payload.hl`	`string`	No	`"en"`	Language code. Defaults to `en`. Minimum length: 2. Maximum length: 8.
`payload.gl`	`string`	No	`"us"`	Country code. Defaults to `us`. Minimum length: 2. Maximum length: 2.
`payload.page`	`integer`	No	—	1-indexed results page. One call returns a fixed ~20 places and each page is billed separately, so only request page 2+ when page 1 came back full and you genuinely need more; a query with fewer than ~20 total matches returns an EMPTY page 2 and still costs a full credit. There is no per-call result limit: /maps ignores `num`. Minimum: 1.
`payload.autocorrect`	`boolean`	No	—	Enable query autocorrection.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.searchParameters`	`record`	No	—	—
`result.data.places`	`array`	No	—	—
`result.data.places[].position`	`number`	No	—	—
`result.data.places[].title`	`string`	No	—	—
`result.data.places[].address`	`string`	No	—	—
`result.data.places[].latitude`	`number`	No	—	—
`result.data.places[].longitude`	`number`	No	—	—
`result.data.places[].rating`	`number`	No	—	—
`result.data.places[].ratingCount`	`number`	No	—	—
`result.data.places[].category`	`string`	No	—	—
`result.data.places[].phoneNumber`	`string`	No	—	—
`result.data.places[].website`	`string`	No	—	—
`result.data.places[].cid`	`string \| number`	No	—	—
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.04 per pricing unit.

Get started

Build and automate

Common workflows

Data and integrations

Reference

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation