For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Business Profile

Google Business Profile (GBP) is Google's platform for managing your business information across Google Search and Maps. With Coupler.io, you can automatically export your GBP data—including customer interactions, search keywords, and reviews—to Google Sheets, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT on a schedule that works for you.

Why connect Google Business Profile to Coupler.io?

  • Multi-location management — Pull data from all your verified locations in one place, no matter how many you manage

  • Multiple report types — Export daily metrics, search keywords, or reviews with a single connection

  • Flexible destinations — Send data to Google Sheets, BigQuery, Looker Studio, or AI platforms for analysis and reporting

  • Scheduled automation — Set up recurring refreshes so your business data stays current without manual work

Prerequisites

  • A Google Business Profile account with at least one verified location

  • Admin or Manager access to the locations you want to connect

  • A destination ready (Google Sheets, BigQuery, Looker Studio, or an AI destination)

Quick start

How to connect

1

Sign in to Coupler.io and click New data flow.

2

Select Google Business Profile as your source and click Continue.

3

Authorize Coupler.io to access your Google account. A Google sign-in window will appear. Log in with the account that manages your GBP locations and approve the permissions.

4

Select your locations. Choose the verified GBP locations you want to include in this data flow. You can select one or multiple locations.

5

Choose your report type:

  • Daily metrics — Performance data like views, actions, and direction requests

  • Search keywords — The search terms customers used to find your business

  • Reviews list — All customer reviews and ratings

6

If you selected "Daily metrics" or "Search keywords", set your date range using the date pickers for start and end dates.

7

Select your destination — Google Sheets, BigQuery, Looker Studio, or an AI destination (Claude, ChatGPT, Cursor, Gemini, Perplexity, OpenClaw).

8

Run the data flow manually to confirm it works. This is required before you can schedule automated refreshes.

Google Business Profile data overview

Google Business Profile provides three distinct report types, each capturing different aspects of how customers interact with your business listing.

Report types

Report Type
Data Updated
Use When

Daily metrics

Daily (after ~2 AM PT)

You need historical performance trends, comparing location performance, or tracking monthly/quarterly KPIs

Search keywords

Daily (after ~2 AM PT)

You want to understand customer search behavior and optimize your listing for discoverable keywords

Reviews list

Real-time to near real-time

You monitor customer sentiment, manage reputation, or track review volume and ratings

Daily metrics — Available metrics

Performance Metrics

Metric
Definition

Business impressions (profile)

Number of times your profile appeared in Search or Maps results

Business impressions (map)

Number of times your business appeared specifically on Google Maps

Business impressions (search)

Number of times your business appeared in Google Search results

Business actions (phone)

Clicks on your phone number to initiate a call

Business actions (website)

Clicks on your website link from your profile

Business actions (directions)

Clicks on your address to get directions

Business actions (message)

Messages sent to your business through your profile

Business actions (booking)

Bookings made through your profile (if enabled)

Business actions (total)

Sum of all customer actions on your profile

Location & Dimension Metrics

Metric
Definition

Location name

The name of your verified business location

Date

The date for which data is reported

Search keywords — Available metrics

Search Data

Metric
Definition

Search keyword

The search term a customer used to find your business

Search impressions

Number of times customers saw your profile when searching this keyword

Search actions

Customer interactions (calls, website clicks, directions) triggered by this keyword

Location & Dimension Metrics

Metric
Definition

Location name

The name of your verified business location

Date

The date for which keyword data is reported

Reviews list — Available metrics

Review Data

Metric
Definition

Review text

The customer's review comment

Rating

Star rating (1–5) given by the reviewer

Reviewer name

Name of the customer who left the review

Review date

Date the review was published

Review status

Whether a response has been posted by the business

Response text

Business's response to the review (if any)

Response date

Date the business responded (if applicable)

Location & Dimension Metrics

Metric
Definition

Location name

The name of your verified business location

Common metric combinations

Track location performance over time: Pull Daily metrics with date range and location filters. Aggregate by location to compare which branches drive the most views and actions.

Monitor customer search intent: Combine Search keywords with Daily metrics for the same date range. Use a Join transformation to match search terms with their corresponding impressions and actions.

Build a reputation dashboard: Pull Reviews list from all locations and send to Data Studio. Filter by rating or date range to identify trends in customer satisfaction.

Multi-location comparison: Pull Daily metrics for multiple locations in a single data flow. Use Append to stack data from all locations, then Aggregate to rank them by views or actions.

Use cases by role

Search Keywords help you identify which terms bring customers to your profile. Use this to optimize your business description and categories for local SEO.

Daily Metrics show which types of actions (calls vs. website clicks vs. directions) are most common, helping you prioritize what's on your profile. For example, if direction requests are high, make sure your address and parking info are clear.

Reviews provide direct customer language—use exact phrases from reviews to improve how you describe your services.

Daily Metrics let you monitor location performance in real time and spot issues (a sudden drop in impressions or actions). Track which locations need attention.

Reviews are your frontline feedback. Monitor response status to ensure no customer review goes unanswered, and use sentiment to identify service gaps.

Search Keywords help you understand what customers are looking for—if many are searching for "appointment booking" but you don't offer it, that's actionable intel.

Daily Metrics provide quantifiable KPIs: impressions, actions, and conversion proxies (direction requests often lead to foot traffic). Use these to measure marketing ROI.

Reviews & Ratings feed sentiment analysis and customer satisfaction scorecards. Track rating trends over time to assess brand health.

Multi-location data aggregated in BigQuery or Data Studio lets you benchmark locations, forecast growth, and allocate budget based on performance.

Reviews are your primary tool. Monitor all reviews and responses to ensure timely replies and identify common complaints.

Daily Metrics show contact intent—a spike in phone calls or messages means you need adequate staffing. Use this to plan support hours.

Search Keywords reveal what customers are looking for, so you can proactively update your profile FAQs and hours to reduce support inquiries.

Platform-specific notes

  • Verified locations only — Only verified GBP locations will be available. Unverified or suspended locations are filtered out automatically.

  • Data freshness — Daily metrics and search keywords are updated after ~2 AM PT each day. Reviews are near real-time.

  • Date range limits — Daily metrics and search keywords support custom date ranges; reviews list pulls all reviews (no date filter available).

  • Organic actions only — Metrics count organic (non-paid) customer actions on your profile.

  • Multi-location scale — Coupler.io supports connecting 50+ locations in a single data flow. For 100+ locations, consider splitting into multiple data flows to avoid timeout errors.

  • API rate limits — Google's API has rate limits; if you run many data flows simultaneously, you may experience temporary delays. Stagger your scheduled refreshes.

Google Business Profile common issues

Connection issues

I see unverified locations in my location list, but I only want verified ones

Coupler.io filters and displays only verified locations. If you're seeing unverified locations in your selection, verify those locations in Google Business Profile first, then reconnect in Coupler.io. Unverified locations will be rejected during the data pull and the run will fail.

The authorization window says Coupler.io is requesting "owner control" of my account

This is a standard OAuth permission request from Google. Coupler.io only uses these permissions to read your GBP data (metrics, keywords, reviews) and write to your chosen destination. Coupler.io does not modify or delete anything in your GBP account. If you're uncomfortable granting access, contact Coupler support to discuss alternative integration options.

I connected my Google account but my locations aren't showing up

Make sure you have Admin or Manager access to the locations in Google Business Profile. Viewer-only access won't allow Coupler.io to retrieve data. Also, confirm the locations are verified; unverified listings are not included. Sign out and reconnect your Google account to refresh the location list.

Missing data

Daily metrics or search keywords show no data before a certain date

GBP only provides historical data for approximately the last 90 days. If your start date is older than 90 days, adjust it to a more recent date. Data availability also depends on when your location was verified and active.

Reviews list is pulling fewer reviews than expected or is timing out

Reviews can take a long time to fetch if you have many reviews across many locations. Google's API has a 9-minute execution window. If the data flow times out, try splitting your locations across multiple data flows—for example, create one flow for 10 locations, another for the next 10. This reduces the data volume per request.

One location is returning data but another location in the same flow is missing data

Confirm that the missing location is verified in GBP and that you have Admin/Manager access to it. If other users manage that location, ask them to verify it or grant you access. Also check if that location had activity (impressions or actions) during your selected date range; if a location has zero activity, it may appear as missing.

Permission errors

I get an error saying my permissions are insufficient

You need Admin or Manager access to any location in GBP. Viewer-only access will cause permission errors. Log into Google Business Profile and check your role under "Users & access." If you're not an Admin, ask the account owner to grant you Manager or Admin permissions, then reconnect in Coupler.io.

I recently changed my Google password and now the connection is failing

After changing your Google password, Coupler.io's stored authorization may become invalid. Reconnect by clicking "Reconnect" in your data flow settings, or delete the connection and create a new one. You'll be asked to sign in again with your updated credentials.

Data discrepancies

Data in Coupler.io doesn't match what I see in Google Business Profile

Small discrepancies are normal due to data processing delays. Daily metrics are finalized after ~2 AM PT, so if you're comparing real-time data in GBP with yesterday's export, they won't match. Always compare using the same date range. If the difference is large (>10%), check that you're looking at the same metric (e.g., total actions vs. phone calls only).

Search keywords or metrics appear duplicated or with different values on different runs

This can happen if you run the data flow multiple times on the same day before GBP's data is finalized. Wait until after 2 AM PT for metrics to stabilize, then run your data flow. Use macros (e.g., {{yesterday}}) to pull yesterday's data for more consistent results.

Rate limits

My data flow is failing with a rate limit or quota error

Quick fix:

  • Space out your scheduled refreshes. Instead of running all flows at the same time, stagger them by 10–15 minutes.

  • Split large multi-location flows into smaller ones (e.g., 30–50 locations per flow).

  • Avoid running manual refreshes while scheduled refreshes are active.

If rate limiting persists, contact Coupler support; our team can request a quota increase from Google.

Reviews list consistently times out with 100+ locations

Reviews queries are data-heavy and Google's API must return all results within 9 minutes. With 100+ locations, this is difficult.

Solution: Split reviews into separate data flows by region or subset of locations. For example:

  • Flow 1: Locations 1–50

  • Flow 2: Locations 51–100

This reduces data volume and ensures each flow completes within the time limit.

Google Business Profile FAQ

Do you support Google My Business as well as Google Business Profile?

Coupler.io connects to Google Business Profile, which is the current standard. Google My Business was deprecated in favor of Business Profile. If you're still using an older My Business account, we recommend migrating to Business Profile in Google's help center first.

How many locations can I connect in a single data flow?

You can connect 50–100+ locations in one flow, but performance depends on the report type. Daily metrics and search keywords scale well to 100+ locations. Reviews are data-heavy; for 100+ locations with many reviews, consider splitting into multiple flows to avoid timeouts.

Does one data connection equal one location or one Google Business Profile account?

One data connection is one GBP account connected to one destination, regardless of how many locations you include. For example, if you have one GBP account with 50 locations connected to Google Sheets, that counts as one data connection. If you connect the same GBP account to both Google Sheets and Looker Studio, that's two data connections.

Can I filter or limit the number of reviews returned?

Reviews list pulls all reviews for the selected locations during the connection period. Coupler.io does not offer a built-in limit or filter by rating in the GBP source itself. However, after pulling to your destination, you can use transformations (filter, sort, or aggregate) to limit results or focus on specific ratings. You can also use Looker Studio's native filters if that's your destination.

Do you include paid actions or only organic actions?

Coupler.io pulls organic actions only. This includes calls, website clicks, direction requests, messages, and bookings initiated through your organic Google Business Profile listing. Paid ads (Google Ads, local service ads) are not included in GBP metrics.

What's the difference between "Business actions (total)" and the individual action metrics?

Business actions (total) is the sum of all action types: phone calls, website clicks, directions, messages, and bookings. Individual metrics (phone, website, directions, etc.) break this down by type. Use the total for overall engagement, and individual metrics to see which action type drives the most interaction.

Can I join GBP daily metrics with search keywords to see which keywords drive the most actions?

Yes! Use the Join transformation. Match on location name and date, then combine daily metrics with search keywords. This lets you see action counts for each keyword.

My Reviews list data flow times out. How do I fix it?

See the Common Issues page for detailed solutions, including splitting large location sets across multiple flows.

Reviews queries are data-heavy. If you have 100+ locations, create separate flows for each region or subset (e.g., locations 1–50 in one flow, 51–100 in another).

Why does my data in Coupler.io not match the numbers I see in Google Business Profile?

Small differences (1–5%) are normal due to processing delays. GBP finalizes metrics after ~2 AM PT, so if you compare data pulled before that time, it won't match. Always wait until after 2 AM PT to run data flows for the most accurate data. Also confirm you're comparing the same date range and metric type.

What if I only have one GBP account with many locations—do I need multiple data flows?

No. A single data flow can include all locations from one GBP account. However, if you encounter timeout errors or rate limits, splitting into multiple flows (by location group or region) helps. You can then use Append to combine the results in your destination.

Can I use Coupler.io to respond to reviews or manage my GBP profile settings?

No. Coupler.io is a read-only data integration tool. It pulls data from GBP but does not modify profiles, respond to reviews, or change settings. You must manage reviews and profile updates directly in Google Business Profile.

Do you support locations.getVoiceOfMerchantState or other GBP verification endpoints?

Currently, Coupler.io supports Daily metrics, Search keywords, and Reviews list. Advanced endpoints like getVoiceOfMerchantState are not available. If you need this data, contact Coupler support to discuss custom integration options.

On the free plan, how often can I refresh my data?

On the free plan, data flows require manual refresh. You run them whenever you need updated data. Scheduled, automated refreshes are available on our paid plans. Check our pricing page for scheduling options on each tier.

Last updated

Was this helpful?