Google Business Profile Analytics

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!