Documentation

How PlaceGrid works

Regions and place types, the free preview, filters, enrichment, results, exports and prices — the whole product on one page, in plain Markdown for your AI too.

Get started Clean Markdown for AI agents

Google Maps places for any region, with the contacts their own websites publish — found, filtered, enriched and exported in one web app.

PlaceGrid finds every business of the kinds you choose inside region boundaries you pick on a map, tells you how many there are and what they will cost before anything is charged, and adds what you ask for to each place: the full Google place card, contacts from its website, reviews, photos, a check of its website. You work with the result as a table, a map and a card per place, and export it.

Concepts

Project — one task: its regions, place types, search language, filters, enrichment and every search made for it. A project keeps its results, so a later search shows what changed.
Region — an area taken from the map’s own boundaries: a country, a region, a city, a district. A region you tick covers everything inside it. Places outside your regions are never shown and never charged.
Place type — the kind of business to look for (dentist, café, hotel …), picked from a list of common types or written in your own words. You also choose the language Google Maps answers in.
Preview scan — a free sample of the search: how many places there are, what each place type adds, what the full search will cost and how long it will take, and a sample of places to try your filters on.
Search filters — decide which places a search pays for and enriches.
Enrichment — what is added to each place that passes the filters. Every type has its own price per result.
Search — the full collection run. It covers each region cell by cell, so it is not capped at the first hundred results a map search returns.
Results — the places the search found and you paid for.
Credits — what work is priced in. One credit is €0.001. A new account starts with 1,000 free credits; more are bought in packages, by card (see Prices).

The stages of a project

The app takes a project through eight stages, listed on the left beside an AI assistant. You can go back to any of them at any time.

Project — name it and say in a sentence what it is for; the assistant uses this to suggest regions and place types.
Regions — tick countries, regions, cities or districts in a tree, search them by name and see them on the map.
Place types — what to look for, and the search language.
Preview scan — free. The estimate comes with a range, the cost and the time, and how many places each place type finds that no other does. When the places found often carry other Google categories, those are offered as more place types.
Filters — keep only the places you need: business status, categories, words in the name, website, phone, online booking, a claimed profile, rating, number of reviews, amenities. Each change is counted at once on the preview’s sample: how many places remain, and how many each filter takes out on its own.
Enrichment — choose the types (and for contacts, the depth); for reviews and photos, how many per place. Each type shows its cost and its time.
Search — choose a cost limit or none, and run it. Places found, credits spent and the time left are shown live. After a change of settings, this stage says what work the change takes — a top-up of the result you have, or a new search — and what it costs.
Results — the table, the map, a card per place, filters, columns and export.

What every place comes with

Field	Meaning
Name, categories	As the listing shows them
Address, city, country, coordinates, time zone	Location
Phone, website	Contacts from the listing
Rating, review count	Current rating and number of reviews
Opening hours, business status	Weekly hours; operational, closed temporarily or for good
Amenities	As Google lists them, when it does
Place ID, CID, Google Maps link	Stable identifiers

Enrichment

Place details

The full place card, beyond what a search returns: all categories, the description, opening hours, the menu or list of services (with prices where the business gives them), the owner’s posts, popular times, ratings by star, booking and order links, and whether the profile is claimed.

Website contacts

The website on the place’s card is read for contact details: the home page, then its contact, imprint and about pages. It returns:

e-mails, each with its type where the address tells it reliably — shared (info@, office@ …), personal, a department (sales, orders, accounts …), a branch — and no type when it does not;
more phones, social profiles and booking links found on the site;
where each contact was found: the page, and whether it was a link, the page’s text, the site’s markup or the AI;
where the website really leads: a social profile, a booking system, a directory listing or a new site of the same business. A directory or another business’s site is not read for contacts.

Four depths, each with its own price:

Depth	What it reads
Standard	The pages as the site serves them
JavaScript	The same pages, rendered in a browser first: finds contacts on sites built by scripts
AI search	Rendered pages read by an AI agent, which picks the contacts and chooses the next pages to open
AI + social	The agent also reads the business’s own social profiles (Facebook, Instagram …)

E-mails are not on Google Maps: they come from the business’s own website, and are found for about 40–45 % of the places that have one, depending on the niche. A place is charged only when an e-mail or a social profile is found.

Reviews

Newest first, up to the number you set per place: the text, rating and date of each review, and the owner’s reply. Google’s review topics come too.

Photos

Up to the number you set per place, from the gallery’s tabs: the owner’s photos, menu photos, videos.

Website check

One look at each place’s website:

its state — works; works at a new address; works but closed to robots; answers with an error; does not answer; no such domain; parked or for sale; another business’s site; no site of its own (a social or booking page); not a web address;
HTTPS — valid, chain incomplete, expired, not valid yet, for another address, self-signed, not trusted or none; when the certificate expires; whether http leads to https;
what it runs — the CMS and its version, ad pixels (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), analytics and tag managers, booking systems.

Every verdict is the answer and is charged, a dead site included: that is what the check finds.

AI research

A short research note per place, written by an AI agent that reads the web. Coming soon.

Present, absent, unknown

Every optional field is in one of three states, and the app says which:

present — the value was found;
absent — it was looked for and does not exist (for example, the listing has no website);
unknown — it was not checked, or checking failed.

“No website” and “not checked” are different answers, and a lead list built on the first is not the same as one built on the second. When the place’s own source fails — a domain that does not exist, a site that does not answer, a place gone from Google — the app says so and charges nothing for it, and keeps it apart from an error on our side, which is tried again.

Working with the results

The table — choose from about 80 columns, put them in any order, set their widths and sort by any of them. The map shows the same places; a click opens the place’s card, laid out like Google Maps: overview, menu and services, reviews (search them, filter by rating), photos.
Results filters — narrow what is shown by anything collected: a personal e-mail on the site’s own domain, social profiles on chosen networks, a menu with prices, open at the weekend or late, a 1–2★ review the owner did not answer, a rating falling behind the reviews, words the reviews mention, the website’s state, certificate, CMS or pixels, the city. They are free and change nothing you paid for.
Your own columns — a text column or a list of your values (with colours and a default), filled in right in the table, in the place’s card or for many places at once. Filter and sort by them; they go into the export.
AI columns — write a task (“Do they treat children?”) and an AI agent fills the column for every place: a value from your list, a filled-in template or free text. You choose what the agent is shown and what it may use — nothing but the place’s fields, its website, the web, or a web search — and how many calls it may make. Each cell keeps the agent’s reason and the pages it read.
Presets — save the columns, their widths and order and the filters as a set for one task (a call list, a mailing list), for all your projects or for one, and apply it in one click.
Enrich the results — add enrichment to the places the table lists, without a new search.
History and comparison — every search is kept. Open an earlier one as it was, or compare two: what is new, what changed (and which fields), what is gone.

Searching again

Add place types or regions — the result is extended: only what is new is searched, and places you already paid for are not paid again.
Take some out — the result is narrowed, free.
Search a type again — its places are found anew and paid again; for each enrichment type choose only new places, new and changed places, or all places again.
A search stopped by its limit — continue it from where it stopped.
Wider filters after a search — the places it found but did not pay for are offered as a top-up, priced on the actual places.

Export

XLSX, CSV, HTML, JSON, XML or Parquet — the places, columns and order the table shows, with its filters. Spreadsheet and page formats use the column names of your interface language; data formats use stable keys and typed values (numbers, timestamps, lists, records such as menu items or reviews).

Prices

Prices are in credits; one credit is €0.001, so each price below is in euros per 1,000. Every search shows its cost before it starts.

What	You pay for	Per 1,000
Preview scan	—	free
Places	each different place found inside your regions	€1.00
Place details	each place	€1.00
Website contacts: standard	each place where an e-mail or a social profile is found	€0.75
Website contacts: JavaScript	the same	€4.25
Website contacts: AI search	the same	€17.50
Website contacts: AI + social	the same	€20.00
Reviews	each review collected	€0.50
Photos	each photo collected	€0.50
Website check	each place with a website	€2.25
AI columns	the model’s tokens and the pages it reads, at the prices the app shows	pay as you go
Assistant	—	free

Example: 1,000 dentists in a region, with standard contacts found for 430 of them, cost €1.00 + €0.32 = €1.32.

The rules:

The preview scan is free, and so is seeing how many places your filters keep.
Duplicates, places outside your regions and failed requests are not charged.
Contacts are charged only where an e-mail or a social profile is found: a site that cannot be read costs nothing.
A place you already paid for is not paid again when you add place types or regions, or continue a search.
A search pays for at least 10 % of the places it finds in your regions, however few its filters keep — and that counts when you widen the filters later.
Narrowing the results, your own columns, presets and export cost nothing.

Buying credits

Pay as you go: there is no subscription, and nothing renews.

1,000 free credits come with every new account — about €1 of work, to try a search on your own regions.
Packages — credits are bought in packages, from €10 for 10,000 credits; larger packages add up to 15 % more credits. The packages on offer and their prices are shown before you pay.
Payment — by card, on Stripe’s checkout page; we never see your card number. Prices are in euros. Each payment comes with Stripe’s receipt.
At once — credits are added as soon as the payment goes through. At checkout you ask for them to be made available at once and acknowledge that, if you buy as a consumer, your 14-day right of withdrawal ends with that.
Valid for 365 days — credits, free or bought, are valid for 365 days from the day they are added; those that expire first are spent first. Credits not used by then expire.
Refunds — payments are not refunded, except where the law requires. If a payment is refunded or charged back, the credits it added are taken back; if some were already spent, your balance goes below zero, and no new paid work can start until a purchase settles it.

The full terms are in the Terms of Service.

Limits and control

A cost limit for every search, or none. With none, the search goes on while your balance and your monthly limit allow; with one, it never spends more. Either way it stops when the money does, and keeps what it found.
A monthly limit for the whole account, on the account page.
The Usage page lists every credit spent by day, by kind of work, by project and by search, and the credits added, a month at a time.

The assistant

An AI assistant sits beside every stage. It proposes regions and place types from the project’s name and notes, and sets them for you; it changes the filters, the enrichment and the results filters, and sets up AI columns, each change shown as a card with a way to see it; it counts places on the preview and the results without spending anything, and answers questions about the project and the app. It never starts a search or spends credits. It is free.

API

A public API for your own code is in the works. Until it is ready, everything is done in the web app; if you need programmatic access, write to us.

Support

Signed in, open Support in the app’s top bar: your requests and our answers stay there, and come by e-mail too once your address is confirmed. Otherwise, write to us from the contact page.