Google Business Profile Analytics

warning

Analytics endpoints are not available on the Starter plan. Upgrade to Intermediate, Growth or Business plan to access these endpoints.

Google Business Profile analytics endpoints provide insights for your connected Google Business Profile accounts.

1. GET /api/gbp/overview

Returns account-level metrics with current vs. previous period comparison.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/gbp/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "metrics": [
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 25000,
        "value_last_period": 22000,
        "percentage_change": "+13.6%",
        "description": "Total number of profile views"
      },
      {
        "key": "search_appearances",
        "name": "Search Appearances",
        "value_current_period": 45000,
        "value_last_period": 40000,
        "percentage_change": "+12.5%",
        "description": "Total number of times appeared in search"
      },
      {
        "key": "interactions",
        "name": "Interactions",
        "value_current_period": 1200,
        "value_last_period": 1050,
        "percentage_change": "+14.3%",
        "description": "Total number of interactions"
      },
      {
        "key": "calls",
        "name": "Calls",
        "value_current_period": 180,
        "value_last_period": 160,
        "percentage_change": "+12.5%",
        "description": "Total number of calls"
      },
      {
        "key": "direction_requests",
        "name": "Direction Requests",
        "value_current_period": 450,
        "value_last_period": 400,
        "percentage_change": "+12.5%",
        "description": "Total number of direction requests"
      },
      {
        "key": "website_clicks",
        "name": "Website Clicks",
        "value_current_period": 570,
        "value_last_period": 490,
        "percentage_change": "+16.3%",
        "description": "Total number of website clicks"
      }
    ],
    "reviews_summary": {
      "average_rating": 4.7,
      "total_reviews": 245,
      "rating_distribution": {
        "5_star": 180,
        "4_star": 40,
        "3_star": 15,
        "2_star": 5,
        "1_star": 5
      }
    }
  }
}

Metrics

Key	Name	Description
views	Views	Total number of profile views
search_appearances	Search Appearances	Total number of times appeared in search
interactions	Interactions	Total number of interactions
calls	Calls	Total number of calls
direction_requests	Direction Requests	Total number of direction requests
website_clicks	Website Clicks	Total number of website clicks

---

2. GET /api/gbp/posts

Returns analytics for Google Business Profile posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/gbp/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "stats": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 10,
        "value_last_period": 8,
        "percentage_change": "+25.0%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 8500,
        "value_last_period": 7000,
        "percentage_change": "+21.4%",
        "description": "Total number of views on your posts"
      },
      {
        "key": "clicks",
        "name": "Clicks",
        "value_current_period": 420,
        "value_last_period": 350,
        "percentage_change": "+20.0%",
        "description": "Total number of clicks on your posts"
      }
    ],
    "posts": [
      {
        "id": "post_gbp_123",
        "page_id": "gbp_account_123",
        "format": "image",
        "text": "Special offer this week!",
        "permalink": "https://business.google.com/posts/123",
        "media_type": "IMAGE",
        "media_url": "https://example.com/gbp.jpg",
        "stats": {
          "views": 850,
          "clicks": 42
        },
        "timestamp": "2025-05-01 11:00:00"
      }
    ]
  }
}

Post Stats

Field	Description
views	Number of views on the post
clicks	Number of clicks on the post

---

3. GET /api/gbp/reviews

Returns reviews data for Google Business Profile.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/gbp/reviews?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "reviews": [
      {
        "id": "review_123",
        "reviewer_name": "John Doe",
        "rating": 5,
        "comment": "Great service and friendly staff!",
        "timestamp": "2025-05-01 14:30:00",
        "reply": null,
        "reply_timestamp": null
      },
      {
        "id": "review_124",
        "reviewer_name": "Jane Smith",
        "rating": 4,
        "comment": "Good experience overall.",
        "timestamp": "2025-04-30 10:15:00",
        "reply": "Thank you for your feedback!",
        "reply_timestamp": "2025-04-30 14:00:00"
      }
    ],
    "summary": {
      "average_rating": 4.7,
      "total_reviews": 245,
      "rating_distribution": {
        "5_star": 180,
        "4_star": 40,
        "3_star": 15,
        "2_star": 5,
        "1_star": 5
      }
    }
  }
}

Review Data

Field	Description
id	Unique review ID
reviewer_name	Name of the reviewer
rating	Star rating (1-5)
comment	Review text
timestamp	When the review was posted
reply	Business reply text
reply_timestamp	When the reply was posted

Summary Fields

Field	Description
average_rating	Average star rating
total_reviews	Total number of reviews
rating_distribution	Count of reviews by star rating

✅ Result: You have successfully retrieved Google Business Profile analytics data!