flashdata-dev's picture
Track FlashData signup and pricing referrals
6aeeac3 verified
|
Raw History Blame Contribute Delete
3.41 kB
metadata
title: Google Places Search
short_description: Local businesses, addresses, ratings and contact details.
emoji: 🔎
colorFrom: blue
colorTo: indigo
sdk: static
app_file: index.html
pinned: false
license: mit
tags:
  - smolagents
  - tool
  - flashdata
  - google-places

Google Places Search

Find local businesses and places by query and location. Get names, addresses, ratings and available website or contact details.

API documentation · Get an API key · Pricing

Requires your own FlashData API key and paid Credits. The Python tool is free to install.

Try the inputs

Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key.

Run with Python

Use Python 3.10 or newer:

python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"

Review tool.py before enabling trust_remote_code. Run locally with your key:

import getpass
import os
from smolagents import load_tool

os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
tool = load_tool("flashdata-dev/google-places-shortlist-flashdata", trust_remote_code=True)
result = tool(**{'gl': 'sg', 'num': 10, 'query': 'coworking spaces Singapore'})
print(result)

The same loaded tool can be used with smolagents. A direct Python call does not require a model.

Inputs

Parameter Required / default Details
query Required Search query, between 1 and 2,000 characters.
num None Requested result count. minimum=1, maximum=100
page None Search result page. minimum=1, maximum=100
autocorrect None Enable spelling autocorrection.
gl None Two-letter country code, for example us.
hl None Interface language code, for example en.
location None Optional geographic search location.
tbs None Optional Google time filter, for example qdr:w.

See input-schema.json for full validation rules. Optional None values are omitted; adapter defaults apply.

Output

Read results.0.places. Fields: title, address, rating, website, phoneNumber. Optional fields may be absent.

example.json contains a recorded response and its original request, not a new result for the input shown in the Space.

Limits and cost

Available fields vary by place; results are not an exhaustive business directory.

Each data request uses FlashData Credits. Check current pricing before running. Any model or hosting charges are separate.

For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions.