Explanation

​
Fields

​
account_id

A unique identifier for the account associated with the location.

​
location_id

A unique identifier for the specific location of the business.

​
name

The name of the business.

​
description

A brief description of the business and its offerings.

​
city

The city where the business is located.

​
address

The physical address of the location.

​
phone_number

The main phone number for contacting the business. Important: According to Google Business Profile API requirements, phone_number and additional_phone_numbers must be updated together in the same request.

​
palceId

A unique identifier for the place in Google’s database.

​
postal

The postal code of the business location.

​
category / categories

The primary category that best describes the business (e.g., “gcid:restaurant”, “gcid:coffee_shop”). When updating via the API, use the categories object format with primaryCategory and optionally additionalCategories.

​
country_code

The country code of the location, indicating the country where the business is based.

​
administrative_area

The administrative area, state, or province where the business is located (e.g., “California”, “North Brabant”).

​
regular_hours

The standard operating hours of the business. A URL link for customers to leave reviews for the business.

​
special_hours

Any special operating hours, such as during holidays or events.

​
more_hours

Additional hours types beyond regular hours, such as delivery hours, takeout hours, drive-through hours, pickup hours, senior hours, online service hours, brunch hours, breakfast hours, lunch hours, dinner hours, kitchen hours, and happy hours.

​
service_items

Services and products offered by the business. Can be either structured services (using Google’s predefined service types) or free-form custom services. Each service can include pricing, descriptions, and display names. Services must have unique display names or service type IDs.

​
service_area

Defines the service area for businesses that serve customers at their locations (e.g., plumbers, delivery services). Includes business type (customer location only or both customer and business location) and a list of places served identified by Google Place IDs.

​
state

The current status of the business profile, such as active or inactive.

​
state_since

The timestamp indicating when the current state of the business profile was set.

​
store_code

A code identifying the specific store location within a larger chain or franchise.

​
website_uri

The website address for the business.

​
additional_categories

Extra categories that the business falls into, besides its primary category.

​
additional_phone_numbers

Additional phone numbers for the location (maximum 2). Important: According to Google Business Profile API requirements, additional_phone_numbers and phone_number must be updated together in the same request.

​
attribute_health

A metric indicating the overall completeness and accuracy of the location’s attributes.

​
attributes

Specific features or services offered by the business, such as payment options and types of delivery.

​
latitude

The latitude coordinate of the business location.

​
longitude

The longitude coordinate of the business location.

​
label

Tags or labels associated with the business for easier identification or categorization.

​
reviews

The total number of reviews the business has received.

​
reply_percentage

The percentage of customer reviews or inquiries that the business has replied to.

​
number_comments

The total number of reviews with comment in form of text that the business has received.

​
number_ratings

The total number of ratings the business has received.

​
average_rating

The average customer rating for the location, typically out of 5 stars.

​
average_response_time

The average time taken by the business to respond to customer inquiries or reviews.

​
health

Overall health score of the business profile, indicating completeness and accuracy.

​
is_published

Indicates whether the business profile is published and visible to the public.

​
is_verified

Indicates whether the business profile is verified.

​
has_additional_categories

Indicates whether the business has additional categories beyond its primary category.

​
has_address

Indicates whether the business has a physical address listed.

​
has_attributes

Indicates whether the business has specific attributes or features listed.

​
has_category

Indicates whether the business has a primary category listed.

​
has_cover_image

Indicates whether the business has a cover image uploaded.

​
has_description

Indicates whether the business has a description provided.

​
has_exterior_image

Indicates whether the business has an exterior image uploaded.

​
has_hours

Indicates whether the business has its operating hours listed.

​
has_interior_image

Indicates whether the business has an interior image uploaded.

​
has_logo_or_profile_image

Indicates whether the business has a logo or profile image uploaded.

​
has_pending_edits

Indicates whether there are pending edits or updates for the business information.

​
has_pending_edits

Indicates whether the business has a phone number listed.

​
has_service

Indicates whether the business offers specific services.

​
has_service_with_description

Indicates whether the business offers services that have descriptions provided.

​
has_special_hours

Indicates whether the business has special operating hours listed, such as for holidays.

​
has_utm_params

Indicates whether the business has UTM parameters set up for tracking purposes.

​
has_website

Indicates whether the business has a website listed.

​
Example

"location":
  { 
    "account_id": "1234567890987654321",    
    "location_id": "1234567890987654321", 
    "name": "GMBapi",
    "category": "Scooterwinkel",
    "city": "Rotterdam",
    "country_code": "NL",
    "description": "GMBapi description",
    "phone_number": "085 303 3345",
    "placeId": "ChIJE-4gaSfFCA5-zHToI4",
    "postal": " 5617 BC",
    "regular_hours": [],
    "reply_percentage": 55,
    "review_link": "https://search.google.com/local/writereview?placeid=ChIJE-4gaSfFCA5-zHToI4",
    "special_hours": [],
    "state": "Active",
    "state_since": 1477309168427,
    "store_code": "4",
    "website_uri": "gmbapi.com",
    "label": [
        "A", "B", "C"
    ],
    "latitude": 51.9219626,
    "longitude": 4.4959781,        
    "additional_categories": [
        "Fietsenwinkel"
    ],
    "additional_phone_numbers": [],
    "address": "Torenallee 20",
    "attribute_health": 0.88,
    "attributes": [
        "pay_credit_card",
        "pay_debit_card",
        "pay_mobile_nfc",
        "requires_cash_only",
        "has_curbside_pickup",
        "has_recycling_electronics",
        "has_in_store_pickup",
        "has_in_store_shopping",
        "has_delivery_same_day",
        "has_delivery",
        "pay_check",
        "url_tiktok",
        "url_inventory_search",
        "url_instagram"
    ],
    "reviews": 882,
    "number_comments": 678,
    "number_ratings": 882,
    "average_rating": 3.78,
    "average_response_time": 446.57,
    "health": 77.78,
    "is_published": 1,
    "is_verified": 1,
    "has_additional_categories": 1,
    "has_address": 1,
    "has_attributes": 1,
    "has_category": 1,
    "has_cover_image": 1,
    "has_description": 1,
    "has_exterior_image": 0,
    "has_hours": 1,
    "has_interior_image": 0,
    "has_logo_or_profile_image": 1,
    "has_pending_edits": 1,
    "has_phone": 1,
    "has_service": 0,
    "has_service_with_description": 0,
    "has_special_hours": 1,
    "has_utm_params": 1,
    "has_website": 1,
  }