Overview

The V4MOS.AI Google Business Profile API gives you the raw records synced from the Business Profile accounts connected to your organization: accounts, locations, daily performance metrics, search keywords and reviews. Rows come as they were synced, with the warehouse column names (snake_case), so you can load them straight into your BI. All endpoints use the /v1/google-business-profile prefix and the same authentication, pagination and response format.

Getting startedCopy Anchor Link

Base URL: https://data.v4mos.ai. Every call requires your API credentials and the organizationId — see Authentication.

1. Connect Google Business Profile in app.v4mos.ai (Connected accounts) and wait for the first sync.
2. Call any endpoint below with your organizationId, for example GET /v1/google-business-profile/reviews?organizationId=….
3. Every row carries integration_id and integration_name: the connection it came from. To read a single connection, pass that value as integrationId.

Available endpointsCopy Anchor Link

• getAccounts/v1/google-business-profile/accountsOne row per Google Business Profile account: name, type and verification state.
• getLocations/v1/google-business-profile/locationsOne row per business location: title, store code, website and the categories, address, coordinates, opening status and metadata as JSON…
• getDaily performance metrics/v1/google-business-profile/daily-metricsOne row per location, day and metric (website clicks, calls, direction requests, conversations, bookings, food orders and impressions)…
• getSearch keywords/v1/google-business-profile/search-keywordsOne row per location, month and search keyword with the number of searches.
• getReviews/v1/google-business-profile/reviewsStar rating, review text, owner reply and dates.

ResourcesCopy Anchor Link

Pagination and filtersCopy Anchor Link

• page (default 1) and limit (default 500, max 5000). meta.hasNextPage says whether another page exists; rows come in a stable order, so walk the pages until it is false.
• dateFrom / dateTo (YYYY-MM-DD, inclusive) filter by the date column shown in the table above. Resources without one reject them.
• integrationId keeps the rows of one connection.
• Answers are cached for 30 minutes and the data is synced once a day — see Data sync.

Response formatCopy Anchor Link

{
  "data": [{ "...": "one object per row, with the columns listed on each endpoint" }],
  "meta": {
    "page": 1,
    "limit": 500,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Large counters (format: int64 fields in each endpoint's schema) arrive as text, for example "1250", so no precision is lost. Convert them to a numeric type on your side.