apifare Get a key

Blog

How to pull Google Maps places and reviews into your AI agent

By Alan Lui · Published · Last updated

Connect your agent to apifare and ask it to run the Google Maps Scraper from the catalog: give it a search term and one location, and it returns the places it finds. The Google Maps Reviews Scraper pulls a place's reviews. Both are ready to run on your apifare key, with no Google Maps account or API key of your own.

Copy this line to your agent once apifare is connected:

Use apifare to run the "Google Maps Scraper" tool with {"searchStringsArray": ["coffee shop"], "locationQuery": "Austin, Texas", "maxCrawledPlacesPerSearch": 20} and list the places with their ratings.

What can my agent do with Google Maps data?

Build a list of local businesses to follow up on, compare ratings across a neighbourhood, watch what customers say about a place, or find every business of a kind near an address.

What does the Google Maps Scraper take?

From its published input schema: searchStringsArray (search terms), locationQuery (one location per run), maxCrawledPlacesPerSearch (places per search term), language, categoryFilterWords (place categories), placeMinimumStars (a minimum star rating) and website (places with or without one). The full list is on the tool's page.

How do I get a place’s reviews?

The Google Maps Reviews Scraper takes place URLs (startUrls) or placeIds, plus maxReviews, reviewsSort (for example "newest"), reviewsStartDate and reviewsFilterString to keep only reviews that mention a keyword.

How do I build a local lead list with contact details?

The Google Maps Email Extractor takes the same search inputs and adds contact details. For more from each business's own website, run the Contact Details Scraper on it. The lead generation use case puts the whole setup together.

How is a run priced?

A catalog run reserves a small amount up front, then settles to the run's true cost, never above a fixed ceiling; failed runs are refunded. Each tool's page shows the numbers, and the listed number is what your balance is debited.

For agents: the exact calls

  1. Find it: search_apis in apifare-mcp, or GET https://apifare.com/v1/search?q=Google%20Maps%20Scraper with Authorization: Bearer $APIFARE_TOKEN. Take the result named "Google Maps Scraper": it carries a proxy_route and the tool's input_schema.
  2. Run it: proxy_call with that proxy_route and {"searchStringsArray": ["coffee shop"], "locationQuery": "Austin, Texas", "maxCrawledPlacesPerSearch": 20} (apifare-mcp over stdio), or POST the proxy_route over HTTP with that JSON as the body and the same header.
  3. Several locations: one run per location, since the tool takes one location per run.
  4. On HTTP 402 the balance is empty: relay the body's human_readable line to your human, wait for the top-up, then retry the same call. Every other error and its fix: the error catalog.

For humans: set it up

  1. Connect your agent. Paste set up https://apifare.com/SKILL.md into it: it gets a key ($5 of calls free), writes its own config and makes a first call. Or get a key at /start and follow your client's setup guide.
  2. Ask. List coffee shops near <place> with their ratings, or Pull the latest Google Maps reviews for <business>.

Which tool for which job

JobToolRuns on
Places for a search term in one locationGoogle Maps Scraperready to run
The reviews of a placeGoogle Maps Reviews Scraperready to run
Places with emails and contact detailsGoogle Maps Email Extractorready to run
Contacts from each business’s websiteContact Details Scraperready to run

"Ready to run" means your apifare key is all it needs; "your key" means you vault your own provider key once. Catalog tools come from the apifare tool index. More: every lead generation tool in the catalog.

When this is the wrong tool

FAQ

Do I need a Google Maps API key?

No. Ready-to-run catalog tools run on apifare’s own supply credential; your apifare key is all you need.

Can it search more than one city at once?

One location per run. Run it once per location; per-agent caps keep the total within the budget you set.

Can it return only highly rated places?

Yes: set placeMinimumStars to the minimum star rating you want.

How do I get only the newest reviews?

Set reviewsSort to "newest", or set reviewsStartDate to keep only reviews after a date.

How is a run priced?

A run reserves a small amount, then settles to the run’s true cost, never above a fixed ceiling. Each tool’s page shows the numbers, and failed runs are refunded.

Give this to your agent

set up https://apifare.com/SKILL.md — and it takes it from there: key, config, first call. $5 of calls free.

No agent open right now? ① Get a key — $5 of calls free, then ② give it to your agent (setup guides).

Related posts

How to give your AI agent live web search without a search API keyGive Claude Code, Cursor or any MCP agent live Google results with one prepaid apifare key: no search provider account, no search key.How to let your agent read any web page as clean markdownGive your AI agent a fetch-a-URL tool that returns clean markdown instead of raw HTML, with one prepaid key and no scraping account.How to pull SEC filings and UK company records into your AI agentGive your agent US SEC EDGAR filings and the UK Companies House register with one prepaid key: no provider account and no provider key.How to get YouTube transcripts into your AI agentLet Claude Code, Cursor or any MCP agent pull YouTube transcripts, videos and channel data on one prepaid, capped apifare key.

For agents: this post as Markdown.