# Mapgrid

> Mapgrid is a management platform for Google Business Profile (Google My Business) at scale — bulk edit locations across chains, audit NAP consistency against Google Maps, manage reviews, posts, media and analytics for multi-brand operators, franchises and agencies.

Mapgrid reads and writes location data (name, address, phone, website, categories, hours, attributes, service areas) directly against the Google Business Profile APIs. Long-running work (bulk edits, NAP audits, enrichment, reviews/analytics/BigQuery sync, scheduled posts) runs as server-side background jobs — safe to close the tab.

Authentication runs through Google OAuth. Users can toggle between Playground-token mode (broad `business.manage` scope) and Direct Google Login mode. A token expiration countdown lives under the header logo and auto-prompts re-connection.

## App

- [Overview](https://mapgrid.app/overview): dashboard with account KPIs, verification status and recent activity across all locations.
- [Locations](https://mapgrid.app/locations): every Google Business Profile location with dynamic columns, multi-filter (chain, health, verification, custom fields), CSV export/import compatible with the GBP bulk-upload schema (App-only or App+GMB modes), per-row delete with tombstone (deleted locations don't reimport on the next token refresh), and DB-vs-GMB sync counters.
- [Location detail](https://mapgrid.app/locations/:slug): full profile, per-field edits pushed to GMB, star markers on fields that sync and lock markers on internal-only metadata, verification launcher (EMAIL / PHONE / ADDRESS / VIDEO) following Google's `VerifyLocationRequest` spec, on-demand enrichment, dynamic Category Picker, 30-second post auto-poll, and per-location analytics with 7d / 14d / this month / last month / oldest-to-Jul-1 ranges backed by BigQuery.
- [Bulk operations](https://mapgrid.app/bulk): background jobs with chunked processing and live progress — store code normalization, prefix stripping, mass enrichment, co-manager invitations.
- [Brands](https://mapgrid.app/brands): brand/chain patterns used to auto-detect brand and branch from raw GMB location names.
- [NAP Audit](https://mapgrid.app/nap-audit): compares Name, Address and Phone in Mapgrid vs Google Maps; each finding offers "Cambiar en local", "Cambiar en Google" (pushes via the v1 Business Information API) or "Omitir".
- [Reviews](https://mapgrid.app/reviews): unified Google reviews inbox across every connected location, searchable per-location combobox, sentiment badges, replies pushed to Google, batch endpoints for high-volume accounts. Background sync via `pg_cron`.
- [Posts](https://mapgrid.app/posts): STANDARD, EVENT and ALERT posts (OFFER retired by Google), multi-location publishing, scheduled posts driven by `pg_cron`, and Post Insights.
- [Media](https://mapgrid.app/media): manage photos and media via the Business Profile media (v4) endpoints, with location-based pagination, thumbnails, and Customer Media (photos submitted by end users).
- [Analytics](https://mapgrid.app/analytics): enhanced KPI bundle with timelines and per-location breakdown. Default 7-day rolling window, selectable 7/14/this month/last month, oldest data pinned to 2024-07-01. Served from BigQuery (`gmb-konvertti`) with a `pg_cron` mirror and a `SECURITY DEFINER` `analytics_bundle_agg` RPC for fast page loads.
- [Team](https://mapgrid.app/team): invite teammates and manage roles; invited users must have Google Business Profile access to see or edit any data.
- [Billing](https://mapgrid.app/billing): Stripe-backed subscription, invoices and plan. Iron / Silver / Gold / Platinum tiers, 4% platform fee, 5% lifetime migration discount, non-refundable policy.
- [Credentials](https://mapgrid.app/credentials): per-workspace secrets used by server functions, and the Google Login Mode toggle (Playground vs Direct Google Login).
- [Customizer](https://mapgrid.app/customizer): super-admin surface for menus, homepage media and site copy.
- [Blog editor](https://mapgrid.app/blog-editor): Sanity-backed post editor for the marketing blog.

## Admin (super-admin only)

- [Users](https://mapgrid.app/admin/users): list all users, change plans, impersonate.
- [Inbox](https://mapgrid.app/admin/inbox): MIME-parsed inbox for `hello@mapgrid.app`.
- [Provider errors](https://mapgrid.app/admin/provider-errors): Google Business Profile API error log with debugging dashboard.

## Integrations for agents

- [MCP server](https://mapgrid.app/mcp): Model Context Protocol endpoint exposing read-only tools (`list_locations`, `get_location`, `list_reviews`, `list_posts`, `list_nap_findings`) secured with OAuth.
- [MCP Agent setup](https://mapgrid.app/mcp-agent): connection guides and endpoint URL for Claude, ChatGPT and Cursor.

## Public

- [Home](https://mapgrid.app/) — also available at `/es`
- [About](https://mapgrid.app/about)
- [Pricing](https://mapgrid.app/pricing)
- [Blog](https://mapgrid.app/blog) — Sanity-backed, EN and ES
- [Alternative to Partoo](https://mapgrid.app/alternative-to-partoo)
- [Alternative to Yext](https://mapgrid.app/alternative-to-yext)
- [Google Business Profile API](https://mapgrid.app/google-business-profile-api)
- [Google review management](https://mapgrid.app/google-review-management)
- [Privacy](https://mapgrid.app/privacy)
- [Terms](https://mapgrid.app/conditions)
- [Sitemap](https://mapgrid.app/sitemap.xml) — also plain text at /sitemap.txt

## Pricing (USD, per location)

Billed per location, monthly or annually; annual is cheaper per location. No long-term contract; 4% platform fee; 5% lifetime migration discount; non-refundable.

| Plan | Locations | Monthly / location | Annual / location |
| --- | --- | --- | --- |
| Freemium | 1 | $0 | $0 |
| Iron | 2-50 | $4.00 | $41.80 |
| Plata | 51-200 | $3.80 | $39.60 |
| Oro | 201-500 | $3.38 | $35.20 |
| Platinum / Diamante / Corpo | 501+ | volume pricing, see /pricing | volume pricing |

Full, always-current table: https://mapgrid.app/pricing (also /es/pricing).

## Company

- Contact: hello@mapgrid.app
- Offices: Miami, FL (US) · Guadalajara, JAL (MX)
- Instagram: https://instagram.com/mapgrid.app
- Facebook: https://facebook.com/mapgrid.app
- LinkedIn: https://www.linkedin.com/company/mapgridapp