Create a Maps Census report
create_reportCreate a Maps Census report: counts of Google Maps places for business types in a zone, with optional filters, rows split by one dimension and a measure in columns. Returns the report URL at once; call get_report for the figures. Each row costs one count, plus one per column (two for a share).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country_code": "<country_code>"
},
"name": "create_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name. | |
| title | No | Report title, 120 characters at most. Default: built from the types and the zone. | |
| types | No | Business types: slugs ("dentist") or names in the report language ("Dentiste"). Omit for all businesses. | |
| admin1 | No | Region or state, by name ("Île-de-France", "California") or code ("11", "CA"). | |
| admin2 | No | Department or county, by name or code. In the United States, give admin1 too. | |
| charts | No | Charts on the report page, above its table. Default: bars. | |
| locale | No | Language of the report, its labels and its URL. Default: en. | |
| columns | No | What the columns show: indicator (the share of each row with each indicator), type, rating, reviews or phone (a cross table; phone not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart), none (the count only). Default: indicator, or none when breakdown is indicator. | |
| measure | No | For a cross table: count (places per cell) or share (the share of each cell with share_indicator). Default: count. | |
| breakdown | No | How the rows split the set: none (one row), type (one row per type, two types at least), location (one row per zone, see location_level), rating, reviews or phone (one row per band; phone not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart), indicator (one row per indicator). Default: none. | |
| indicators | No | Indicators of indicator rows or columns, 12 at most. Default: website, email, phone, Facebook, Instagram, LinkedIn, less the filters given. | |
| full_report | No | true only when the user asks for a written report, a PDF or a page to share: the report then gets a written analysis and a PDF, a minute or two after the counts. Leave it false when the user only wants figures. Default: false. | |
| country_code | Yes | ISO 3166-1 alpha-2 country code, e.g. "FR" or "US". | |
| gmap_has_phone | No | true: only places with a phone number; false: only places without one. | |
| gmap_is_closed | No | true: only places marked permanently closed; false: only places not marked closed. | |
| location_level | No | Zone level of the rows when breakdown is location. Default: the level just under the zone. | |
| gmap_phone_type | No | Only places with this phone type; not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart. | |
| share_indicator | No | The indicator a share measure counts. | |
| gmap_has_website | No | true: only places with a website; false: only places without one. | |
| gmap_is_main_type | No | true: only places whose main type is one of the types; false: only places where it is a secondary type. | |
| website_has_emails | No | true: only places whose website shows an email; false: only places whose website shows none. | |
| website_has_tiktok | No | Same, for a TikTok link. | |
| website_has_twitter | No | Same, for an X (Twitter) link. | |
| website_has_youtube | No | Same, for a YouTube link. | |
| website_has_facebook | No | Same, for a Facebook link. | |
| website_has_linkedin | No | Same, for a LinkedIn link. | |
| website_has_ad_pixels | No | Same, for ad pixels. | |
| website_has_instagram | No | Same, for an Instagram link. | |
| gmap_first_seen_at_gte | No | Only places first indexed on or after this date, YYYY-MM-DD. | |
| gmap_first_seen_at_lte | No | Only places first indexed on or before this date, YYYY-MM-DD. | |
| gmap_reviews_count_gte | No | Minimum review count: 0, 50, 200, 500 or 501 (more than 500). | |
| gmap_reviews_count_lte | No | Maximum review count: 0, 50, 200, 500 or 501 (more than 500). | |
| gmap_reviews_rating_gte | No | Minimum rating, 0 to 5. | |
| gmap_reviews_rating_lte | No | Maximum rating, 0 to 5. | |
| website_has_contact_pages | No | Same, for a contact page. |