Skip to main content
GET
List Google Business Profile locations

Request contract

  • Method and path: GET /apis/v1/social/accounts/{accountId}/gmb-locations
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-locations
  • accountId: path; required
  • search: query; optional
  • filter: query; optional
  • limit: query; optional
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

Query Parameters

Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.

filter
string

Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".

limit
integer
default:100

Max locations to return (default 100, max 500). Raise it to enumerate an account with more than 100 locations; for accounts with thousands, use search/filter instead.

Required range: 1 <= x <= 500

Response

Locations list

cached
boolean
hasMore
boolean

True when more locations exist than were returned (use search to narrow down).

locations
object[]
selectedLocationId
string