Skip to content
Eden Engine

Google Maps Business Search (Keyword and Place Name, English)

omnial/google-maps-business-search

Searches Google Maps for a keyword in a named place and returns the matching business listings in map order: each listing's position, name, categories, price band, star rating and rating count, street address and city details, published phone number, website domain, weekday opening hours with the current open or closed status, whether the listing is claimed, and its place ID and CID.

activeper callv1

Price

Up to $0.00273 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google Maps

Data from Google Maps.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-maps-business-search" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-maps-business-search" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-maps-business-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-maps-business-search", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00273
Updated
Oct 15, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "keyword",
    "location_name",
    "language_code"
  ],
  "properties": {
    "depth": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1,
      "description": "How many listings to collect, from 1 to 100 (one page); the supplier's default is 100."
    },
    "keyword": {
      "type": "string",
      "maxLength": 700,
      "minLength": 1,
      "description": "What to search for: a kind of business, a service or a business name, up to 700 characters."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The language of the results; only en (English) is offered."
    },
    "location_name": {
      "type": "string",
      "minLength": 1,
      "description": "The place to search, written as city, region and country joined by commas, in the supplier's location list format."
    },
    "search_places": {
      "enum": [
        true
      ],
      "type": "boolean",
      "default": true,
      "description": "Search places mode (default true)."
    },
    "search_this_area": {
      "enum": [
        true
      ],
      "type": "boolean",
      "default": true,
      "description": "Show results from the displayed area (default true)."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cid": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The listing's customer ID (CID)."
                },
                "phone": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The phone number the business publishes, where it lists one."
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The business name."
                },
                "domain": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The domain of the business's website, where it lists one."
                },
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The average star rating out of 5."
                    },
                    "votes_count": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "How many ratings it is based on."
                    }
                  }
                },
                "address": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The street address as shown on the listing."
                },
                "category": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The main business category."
                },
                "place_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The Google place ID."
                },
                "is_claimed": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "Whether the business has claimed its listing."
                },
                "work_hours": {
                  "type": "object",
                  "properties": {
                    "timetable": {
                      "type": "object",
                      "properties": {
                        "friday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "monday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "sunday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "tuesday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "saturday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "thursday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        },
                        "wednesday": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "open": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              },
                              "close": {
                                "type": "object",
                                "properties": {
                                  "hour": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "minute": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "description": "Opening and closing times by weekday; a closed day is null."
                    },
                    "current_status": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Whether the business is open or closed at retrieval."
                    }
                  },
                  "description": "Opening hours."
                },
                "price_level": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The price band, where shown."
                },
                "address_info": {
                  "type": "object",
                  "properties": {
                    "zip": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The postal code."
                    },
                    "city": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The city."
                    },
                    "region": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The state or region."
                    },
                    "country_code": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The country code."
                    }
                  }
                },
                "rank_absolute": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "The listing's position in the results."
                },
                "additional_categories": {
                  "type": "array",
                  "items": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "description": "Other business categories."
                }
              }
            },
            "description": "The business listings, in map order."
          },
          "keyword": {
            "type": [
              "string",
              "null"
            ],
            "description": "The search keyword, as sent."
          },
          "datetime": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the search ran (UTC)."
          },
          "items_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "How many listings came back."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}