Update a Google Business Profile location
curl --request PUT \
--url https://api.social-api.ai/v1/platforms/google/accounts/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"ad_phone": "<string>",
"categories": {
"additional_categories": [
"<string>"
],
"primary_category": "categories/gcid:pizza_restaurant"
},
"description": "Wood-fired pizza since 1998",
"labels": [
"<string>"
],
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"open_status": "OPEN",
"phone_numbers": {
"additional_phones": [
"<string>"
],
"primary_phone": "+33 1 23 45 67 89"
},
"regular_hours": {
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
},
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"place_ids": [
"<string>"
]
},
"special_hours": {
"periods": [
{
"close_time": "<string>",
"closed": true,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
]
},
"store_code": "JP-01",
"storefront_address": {
"address_lines": [
"<string>"
],
"administrative_area": "<string>",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"title": "Joe's Pizza (Downtown)",
"website_uri": "https://joes.example"
}
EOFconst options = {
method: 'PUT',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ad_phone: '<string>',
categories: {
additional_categories: ['<string>'],
primary_category: 'categories/gcid:pizza_restaurant'
},
description: 'Wood-fired pizza since 1998',
labels: ['<string>'],
latlng: {latitude: 48.8566, longitude: 2.3522},
more_hours: [
{
hours_type_id: 'DRIVE_THROUGH',
periods: [
{
close_day: 'MONDAY',
close_time: '17:30',
open_day: 'MONDAY',
open_time: '09:00'
}
]
}
],
open_status: 'OPEN',
phone_numbers: {additional_phones: ['<string>'], primary_phone: '+33 1 23 45 67 89'},
regular_hours: {
periods: [
{
close_day: 'MONDAY',
close_time: '17:30',
open_day: 'MONDAY',
open_time: '09:00'
}
]
},
service_area: {business_type: 'CUSTOMER_LOCATION_ONLY', place_ids: ['<string>']},
special_hours: {
periods: [
{
close_time: '<string>',
closed: true,
end_date: '2026-12-25',
open_time: '<string>',
start_date: '2026-12-25'
}
]
},
store_code: 'JP-01',
storefront_address: {
address_lines: ['<string>'],
administrative_area: '<string>',
locality: 'Paris',
organization: '<string>',
postal_code: '75001',
region_code: 'FR',
sorting_code: '<string>',
sublocality: '<string>'
},
title: 'Joe\'s Pizza (Downtown)',
website_uri: 'https://joes.example'
})
};
fetch('https://api.social-api.ai/v1/platforms/google/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/platforms/google/accounts/{id}"
payload = {
"ad_phone": "<string>",
"categories": {
"additional_categories": ["<string>"],
"primary_category": "categories/gcid:pizza_restaurant"
},
"description": "Wood-fired pizza since 1998",
"labels": ["<string>"],
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"open_status": "OPEN",
"phone_numbers": {
"additional_phones": ["<string>"],
"primary_phone": "+33 1 23 45 67 89"
},
"regular_hours": { "periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
] },
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"place_ids": ["<string>"]
},
"special_hours": { "periods": [
{
"close_time": "<string>",
"closed": True,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
] },
"store_code": "JP-01",
"storefront_address": {
"address_lines": ["<string>"],
"administrative_area": "<string>",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"title": "Joe's Pizza (Downtown)",
"website_uri": "https://joes.example"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"ad_phone": "<string>",
"additional_categories": [
{
"display_name": "Pizza restaurant",
"name": "categories/gcid:pizza_restaurant"
}
],
"additional_phones": [
"<string>"
],
"can_delete": true,
"can_have_business_calls": true,
"can_have_food_menus": true,
"can_modify_service_list": true,
"can_operate_health_data": true,
"can_operate_local_post": true,
"can_operate_lodging_data": true,
"can_reopen": true,
"duplicate_location": "<string>",
"has_google_updated": true,
"has_pending_edits": true,
"has_voice_of_merchant": true,
"is_particularly_personal_place": true,
"labels": [
"<string>"
],
"language_code": "en",
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"maps_uri": "https://maps.google.com/?cid=123",
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"new_review_uri": "https://g.page/r/abc/review",
"open_status": "OPEN",
"opening_date": "2026-09-01",
"place_id": "ChIJabc",
"primary_category": {
"display_name": "Pizza restaurant",
"name": "categories/gcid:pizza_restaurant"
},
"primary_phone": "+33 1 23 45 67 89",
"regular_hours": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
],
"relationship_data": {
"children_locations": [
{
"place_id": "<string>",
"relation_type": "DEPARTMENT_OF"
}
],
"parent_chain": "<string>",
"parent_location": {
"place_id": "<string>",
"relation_type": "DEPARTMENT_OF"
}
},
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"places": [
{
"place_id": "<string>",
"place_name": "Paris"
}
],
"region_code": "FR"
},
"service_items": [
{
"free_form_service_item": {
"category": "<string>",
"label": {
"description": "<string>",
"display_name": "Emergency unlock",
"language_code": "en"
}
},
"price": {
"currency_code": "EUR",
"nanos": 123,
"units": "80"
},
"structured_service_item": {
"description": "<string>",
"service_type_id": "<string>"
}
}
],
"special_hours": [
{
"close_time": "<string>",
"closed": true,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
],
"store_code": "JP-01",
"storefront_address": {
"address_lines": [
"<string>"
],
"administrative_area": "Île-de-France",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"website_uri": "https://joes.example"
},
"validated": true
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Google
Update a Google Business Profile location
Writes the location’s public profile: name, description, phone numbers, address, website, categories, opening hours, service area. Only the fields you send are touched. A field you omit is left as it is, and a field you send with an empty value is CLEARED, which is how you remove a phone number or a website. Fields Google owns are not writable and are rejected: place_id, maps_uri, new_review_uri and the status flags are output-only, and language_code is fixed when the location is created. Google moderates these edits, so a 200 means the change was accepted for review rather than already live on Search and Maps; read the location back to see what is live and check has_pending_edits. Google allows 10 edits per minute per Business Profile and that limit cannot be raised. Pass validate_only=true to have Google check the change without applying it, which is the only way to test against a real profile since the API has no sandbox.
PUT
/
platforms
/
google
/
accounts
/
{id}
Update a Google Business Profile location
curl --request PUT \
--url https://api.social-api.ai/v1/platforms/google/accounts/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"ad_phone": "<string>",
"categories": {
"additional_categories": [
"<string>"
],
"primary_category": "categories/gcid:pizza_restaurant"
},
"description": "Wood-fired pizza since 1998",
"labels": [
"<string>"
],
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"open_status": "OPEN",
"phone_numbers": {
"additional_phones": [
"<string>"
],
"primary_phone": "+33 1 23 45 67 89"
},
"regular_hours": {
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
},
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"place_ids": [
"<string>"
]
},
"special_hours": {
"periods": [
{
"close_time": "<string>",
"closed": true,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
]
},
"store_code": "JP-01",
"storefront_address": {
"address_lines": [
"<string>"
],
"administrative_area": "<string>",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"title": "Joe's Pizza (Downtown)",
"website_uri": "https://joes.example"
}
EOFconst options = {
method: 'PUT',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ad_phone: '<string>',
categories: {
additional_categories: ['<string>'],
primary_category: 'categories/gcid:pizza_restaurant'
},
description: 'Wood-fired pizza since 1998',
labels: ['<string>'],
latlng: {latitude: 48.8566, longitude: 2.3522},
more_hours: [
{
hours_type_id: 'DRIVE_THROUGH',
periods: [
{
close_day: 'MONDAY',
close_time: '17:30',
open_day: 'MONDAY',
open_time: '09:00'
}
]
}
],
open_status: 'OPEN',
phone_numbers: {additional_phones: ['<string>'], primary_phone: '+33 1 23 45 67 89'},
regular_hours: {
periods: [
{
close_day: 'MONDAY',
close_time: '17:30',
open_day: 'MONDAY',
open_time: '09:00'
}
]
},
service_area: {business_type: 'CUSTOMER_LOCATION_ONLY', place_ids: ['<string>']},
special_hours: {
periods: [
{
close_time: '<string>',
closed: true,
end_date: '2026-12-25',
open_time: '<string>',
start_date: '2026-12-25'
}
]
},
store_code: 'JP-01',
storefront_address: {
address_lines: ['<string>'],
administrative_area: '<string>',
locality: 'Paris',
organization: '<string>',
postal_code: '75001',
region_code: 'FR',
sorting_code: '<string>',
sublocality: '<string>'
},
title: 'Joe\'s Pizza (Downtown)',
website_uri: 'https://joes.example'
})
};
fetch('https://api.social-api.ai/v1/platforms/google/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/platforms/google/accounts/{id}"
payload = {
"ad_phone": "<string>",
"categories": {
"additional_categories": ["<string>"],
"primary_category": "categories/gcid:pizza_restaurant"
},
"description": "Wood-fired pizza since 1998",
"labels": ["<string>"],
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"open_status": "OPEN",
"phone_numbers": {
"additional_phones": ["<string>"],
"primary_phone": "+33 1 23 45 67 89"
},
"regular_hours": { "periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
] },
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"place_ids": ["<string>"]
},
"special_hours": { "periods": [
{
"close_time": "<string>",
"closed": True,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
] },
"store_code": "JP-01",
"storefront_address": {
"address_lines": ["<string>"],
"administrative_area": "<string>",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"title": "Joe's Pizza (Downtown)",
"website_uri": "https://joes.example"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"data": {
"ad_phone": "<string>",
"additional_categories": [
{
"display_name": "Pizza restaurant",
"name": "categories/gcid:pizza_restaurant"
}
],
"additional_phones": [
"<string>"
],
"can_delete": true,
"can_have_business_calls": true,
"can_have_food_menus": true,
"can_modify_service_list": true,
"can_operate_health_data": true,
"can_operate_local_post": true,
"can_operate_lodging_data": true,
"can_reopen": true,
"duplicate_location": "<string>",
"has_google_updated": true,
"has_pending_edits": true,
"has_voice_of_merchant": true,
"is_particularly_personal_place": true,
"labels": [
"<string>"
],
"language_code": "en",
"latlng": {
"latitude": 48.8566,
"longitude": 2.3522
},
"maps_uri": "https://maps.google.com/?cid=123",
"more_hours": [
{
"hours_type_id": "DRIVE_THROUGH",
"periods": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
]
}
],
"new_review_uri": "https://g.page/r/abc/review",
"open_status": "OPEN",
"opening_date": "2026-09-01",
"place_id": "ChIJabc",
"primary_category": {
"display_name": "Pizza restaurant",
"name": "categories/gcid:pizza_restaurant"
},
"primary_phone": "+33 1 23 45 67 89",
"regular_hours": [
{
"close_day": "MONDAY",
"close_time": "17:30",
"open_day": "MONDAY",
"open_time": "09:00"
}
],
"relationship_data": {
"children_locations": [
{
"place_id": "<string>",
"relation_type": "DEPARTMENT_OF"
}
],
"parent_chain": "<string>",
"parent_location": {
"place_id": "<string>",
"relation_type": "DEPARTMENT_OF"
}
},
"service_area": {
"business_type": "CUSTOMER_LOCATION_ONLY",
"places": [
{
"place_id": "<string>",
"place_name": "Paris"
}
],
"region_code": "FR"
},
"service_items": [
{
"free_form_service_item": {
"category": "<string>",
"label": {
"description": "<string>",
"display_name": "Emergency unlock",
"language_code": "en"
}
},
"price": {
"currency_code": "EUR",
"nanos": 123,
"units": "80"
},
"structured_service_item": {
"description": "<string>",
"service_type_id": "<string>"
}
}
],
"special_hours": [
{
"close_time": "<string>",
"closed": true,
"end_date": "2026-12-25",
"open_time": "<string>",
"start_date": "2026-12-25"
}
],
"store_code": "JP-01",
"storefront_address": {
"address_lines": [
"<string>"
],
"administrative_area": "Île-de-France",
"locality": "Paris",
"organization": "<string>",
"postal_code": "75001",
"region_code": "FR",
"sorting_code": "<string>",
"sublocality": "<string>"
},
"website_uri": "https://joes.example"
},
"validated": true
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Path Parameters
Connected account ID
Query Parameters
Validate the change without applying it
Body
application/json
Fields to change
AdPhone is the alternate number shown on Google Ads extensions.
Show child attributes
Show child attributes
Example:
"Wood-fired pizza since 1998"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
OpenStatus is OPEN, CLOSED_PERMANENTLY or CLOSED_TEMPORARILY.
Example:
"OPEN"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"JP-01"
Show child attributes
Show child attributes
Example:
"Joe's Pizza (Downtown)"
Example:
"https://joes.example"