Google Business Profile Business Profile Businessprofileperformance Locations API

The Business Profile Businessprofileperformance Locations API from Google Business Profile — 3 operation(s) for business profile businessprofileperformance locations.

GitHub OpenAPI

Operations 3

GET /v1/locations/{locationsId}:fetchMultiDailyMetricsTimeSeries Fetch multi daily metrics time series locations #
GET /v1/locations/{locationsId}:getDailyMetricsTimeSeries Get daily metrics time series locations #
GET /v1/locations/{locationsId}/searchkeywords/impressions/monthly List monthly #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-business-profile:google-business-profile-businessprofileperformance-locations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-business-profile-businessprofileperformance-locations-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Business Profile Performance API Locations API
  version: v1
  description: Generated from Google's published Discovery document for Business Profile Performance API (businessprofileperformance
    v1, revision 20261110). 3 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
externalDocs:
  url: https://developers.google.com/my-business/
servers:
- url: https://businessprofileperformance.googleapis.com
paths:
  /v1/locations/{locationsId}:fetchMultiDailyMetricsTimeSeries:
    get:
      operationId: businessprofileperformance.locations.fetchMultiDailyMetricsTimeSeries
      summary: Fetch multi daily metrics time series locations
      description: ' Returns the values for each date from a given time range that are associated with the specific daily
        metrics. Note: Only daily data is available. Hourly metrics are not supported. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31`'
      parameters:
      - name: locationsId
        in: path
        required: true
        description: Resource name segment (locationsId).
        schema:
          type: string
      - name: dailyMetrics
        in: query
        required: false
        description: Required. The metrics to retrieve time series for.
        schema:
          type: array
          items:
            enum:
            - DAILY_METRIC_UNKNOWN
            - BUSINESS_IMPRESSIONS_DESKTOP_MAPS
            - BUSINESS_IMPRESSIONS_DESKTOP_SEARCH
            - BUSINESS_IMPRESSIONS_MOBILE_MAPS
            - BUSINESS_IMPRESSIONS_MOBILE_SEARCH
            - BUSINESS_CONVERSATIONS
            - BUSINESS_DIRECTION_REQUESTS
            - CALL_CLICKS
            - WEBSITE_CLICKS
            - MESSAGING_CLICKS
            - BUSINESS_BOOKINGS
            - BUSINESS_FOOD_ORDERS
            - BUSINESS_FOOD_MENU_CLICKS
            type: string
      - name: dailyRange.endDate.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          type: integer
          format: int32
      - name: dailyRange.endDate.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          type: integer
          format: int32
      - name: dailyRange.endDate.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          format: int32
          type: integer
      - name: dailyRange.startDate.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          type: integer
          format: int32
      - name: dailyRange.startDate.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          type: integer
          format: int32
      - name: dailyRange.startDate.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchMultiDailyMetricsTimeSeriesResponse'
        4XX:
          content: &id001
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id001
          description: Error response (google.rpc.Status)
      security:
      - apiKey: []
      tags:
      - Locations
  /v1/locations/{locationsId}:getDailyMetricsTimeSeries:
    get:
      operationId: businessprofileperformance.locations.getDailyMetricsTimeSeries
      summary: Get daily metrics time series locations
      description: ' Returns the values for each date from a given time range that are associated with the specific daily
        metric. Note: Only daily data is available. Hourly metrics are not supported. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31`'
      parameters:
      - name: locationsId
        in: path
        required: true
        description: Resource name segment (locationsId).
        schema:
          type: string
      - name: dailyMetric
        in: query
        required: false
        description: Required. The metric to retrieve time series.
        schema:
          enum:
          - DAILY_METRIC_UNKNOWN
          - BUSINESS_IMPRESSIONS_DESKTOP_MAPS
          - BUSINESS_IMPRESSIONS_DESKTOP_SEARCH
          - BUSINESS_IMPRESSIONS_MOBILE_MAPS
          - BUSINESS_IMPRESSIONS_MOBILE_SEARCH
          - BUSINESS_CONVERSATIONS
          - BUSINESS_DIRECTION_REQUESTS
          - CALL_CLICKS
          - WEBSITE_CLICKS
          - MESSAGING_CLICKS
          - BUSINESS_BOOKINGS
          - BUSINESS_FOOD_ORDERS
          - BUSINESS_FOOD_MENU_CLICKS
          type: string
      - name: dailyRange.endDate.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          format: int32
          type: integer
      - name: dailyRange.endDate.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          format: int32
          type: integer
      - name: dailyRange.endDate.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          format: int32
          type: integer
      - name: dailyRange.startDate.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          format: int32
          type: integer
      - name: dailyRange.startDate.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          type: integer
          format: int32
      - name: dailyRange.startDate.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          type: integer
          format: int32
      - name: dailySubEntityType.dayOfWeek
        in: query
        required: false
        description: 'Represents the day of the week. Eg: MONDAY. Currently supported DailyMetrics = NONE.'
        schema:
          enum:
          - DAY_OF_WEEK_UNSPECIFIED
          - MONDAY
          - TUESDAY
          - WEDNESDAY
          - THURSDAY
          - FRIDAY
          - SATURDAY
          - SUNDAY
          type: string
      - name: dailySubEntityType.timeOfDay.hours
        in: query
        required: false
        description: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than
          or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
        schema:
          type: integer
          format: int32
      - name: dailySubEntityType.timeOfDay.minutes
        in: query
        required: false
        description: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
        schema:
          format: int32
          type: integer
      - name: dailySubEntityType.timeOfDay.nanos
        in: query
        required: false
        description: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
        schema:
          type: integer
          format: int32
      - name: dailySubEntityType.timeOfDay.seconds
        in: query
        required: false
        description: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59.
          An API may allow the value 60 if it allows leap-seconds.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDailyMetricsTimeSeriesResponse'
        4XX:
          content: &id002
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id002
          description: Error response (google.rpc.Status)
      security:
      - apiKey: []
      tags:
      - Locations
  /v1/locations/{locationsId}/searchkeywords/impressions/monthly:
    get:
      operationId: businessprofileperformance.locations.searchkeywords.impressions.monthly.list
      summary: List monthly
      description: 'Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied
        by impressions which are aggregated on a monthly basis. Example request: `GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3`'
      parameters:
      - name: locationsId
        in: path
        required: true
        description: Resource name segment (locationsId).
        schema:
          type: string
      - name: monthlyRange.endMonth.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          type: integer
          format: int32
      - name: monthlyRange.endMonth.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          format: int32
          type: integer
      - name: monthlyRange.endMonth.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          format: int32
          type: integer
      - name: monthlyRange.startMonth.day
        in: query
        required: false
        description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
          or a year and month where the day isn't significant.
        schema:
          type: integer
          format: int32
      - name: monthlyRange.startMonth.month
        in: query
        required: false
        description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        schema:
          type: integer
          format: int32
      - name: monthlyRange.startMonth.year
        in: query
        required: false
        description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        schema:
          format: int32
          type: integer
      - name: pageSize
        in: query
        required: false
        description: Optional. The number of results requested. The default page size is 100. Page size can be set to a maximum
          of 100.
        schema:
          format: int32
          type: integer
      - name: pageToken
        in: query
        required: false
        description: Optional. A token indicating the next paginated result to be returned.
        schema:
          format: byte
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSearchKeywordImpressionsMonthlyResponse'
        4XX:
          content: &id003
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content: *id003
          description: Error response (google.rpc.Status)
      security:
      - apiKey: []
      tags:
      - Locations
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
  schemas:
    DailyMetricTimeSeries:
      type: object
      properties:
        timeSeries:
          $ref: '#/components/schemas/TimeSeries'
          description: List of datapoints where each datapoint is a date-value pair.
        dailyMetric:
          type: string
          description: The DailyMetric that the TimeSeries represents.
          enum:
          - DAILY_METRIC_UNKNOWN
          - BUSINESS_IMPRESSIONS_DESKTOP_MAPS
          - BUSINESS_IMPRESSIONS_DESKTOP_SEARCH
          - BUSINESS_IMPRESSIONS_MOBILE_MAPS
          - BUSINESS_IMPRESSIONS_MOBILE_SEARCH
          - BUSINESS_CONVERSATIONS
          - BUSINESS_DIRECTION_REQUESTS
          - CALL_CLICKS
          - WEBSITE_CLICKS
          - MESSAGING_CLICKS
          - BUSINESS_BOOKINGS
          - BUSINESS_FOOD_ORDERS
          - BUSINESS_FOOD_MENU_CLICKS
        dailySubEntityType:
          $ref: '#/components/schemas/DailySubEntityType'
          description: The DailySubEntityType that the TimeSeries represents. Will not be present when breakdown does not
            exist.
      description: Represents a single datapoint, where each datapoint is a DailyMetric-DailySubEntityType-TimeSeries tuple.
    DailySubEntityType:
      type: object
      description: 'Represents all possible subentity types that are associated with DailyMetrics. Note: Currently, all metrics
        are returned as daily aggregates and sub-entity breakdowns are not supported.'
      properties:
        timeOfDay:
          $ref: '#/components/schemas/TimeOfDay'
          description: 'Represents the time of the day in 24 hour format. Eg: 13:34:20 Currently supported DailyMetrics =
            NONE.'
        dayOfWeek:
          enum:
          - DAY_OF_WEEK_UNSPECIFIED
          - MONDAY
          - TUESDAY
          - WEDNESDAY
          - THURSDAY
          - FRIDAY
          - SATURDAY
          - SUNDAY
          description: 'Represents the day of the week. Eg: MONDAY. Currently supported DailyMetrics = NONE.'
          type: string
    Date:
      type: object
      description: 'Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either
        specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of
        the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for
        example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day
        (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp'
      properties:
        year:
          format: int32
          type: integer
          description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        day:
          type: integer
          description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself
            or a year and month where the day isn't significant.
          format: int32
        month:
          type: integer
          description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
          format: int32
    DatedValue:
      description: Represents a single datapoint in the timeseries, where each datapoint is a date-value pair.
      properties:
        date:
          $ref: '#/components/schemas/Date'
          description: The date that the datapoint corresponds to. This represents a month value if the day field is not set.
        value:
          format: int64
          type: string
          description: The value of the datapoint. This will not be present when the value is zero.
      type: object
    FetchMultiDailyMetricsTimeSeriesResponse:
      description: Represents the response for FetchMultiDailyMetricsTimeSeries.
      type: object
      properties:
        multiDailyMetricTimeSeries:
          description: DailyMetrics and their corresponding time series.
          type: array
          items:
            $ref: '#/components/schemas/MultiDailyMetricTimeSeries'
    GetDailyMetricsTimeSeriesResponse:
      type: object
      description: Represents the response for GetDailyMetricsTimeSeries.
      properties:
        timeSeries:
          $ref: '#/components/schemas/TimeSeries'
          description: The daily time series.
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    InsightsValue:
      description: Represents an insights value.
      type: object
      properties:
        threshold:
          type: string
          format: int64
          description: Represents the threshold below which the actual value falls.
        value:
          type: string
          format: int64
          description: Represents the actual value.
    ListSearchKeywordImpressionsMonthlyResponse:
      type: object
      description: Represents the response for ListSearchKeywordImpressionsMonthly.
      properties:
        nextPageToken:
          format: byte
          type: string
          description: A token indicating the last paginated result returned. This can be used by succeeding requests to get
            the next "page" of keywords. It will only be present when there are more results to be returned.
        searchKeywordsCounts:
          type: array
          items:
            $ref: '#/components/schemas/SearchKeywordCount'
          description: Search terms which have been used to find a business.
    MultiDailyMetricTimeSeries:
      properties:
        dailyMetricTimeSeries:
          description: List of DailyMetric-TimeSeries pairs.
          type: array
          items:
            $ref: '#/components/schemas/DailyMetricTimeSeries'
      description: Represents a list of tuples of DailyMetric-DailySubEntityType-TimeSeries.
      type: object
    SearchKeywordCount:
      properties:
        insightsValue:
          $ref: '#/components/schemas/InsightsValue'
          description: 'One of either: 1) The sum of the number of unique users that used the keyword in a month, aggregated
            for each month requested. 2) A threshold that indicates that the actual value is below this threshold.'
        searchKeyword:
          type: string
          description: The lower-cased string that the user entered.
      type: object
      description: Represents a single search keyword and its value.
    TimeOfDay:
      type: object
      properties:
        seconds:
          format: int32
          description: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to
            59. An API may allow the value 60 if it allows leap-seconds.
          type: integer
        hours:
          description: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than
            or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.
          format: int32
          type: integer
        nanos:
          format: int32
          type: integer
          description: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to
            999,999,999.
        minutes:
          format: int32
          type: integer
          description: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
      description: Represents a time of day. The date and time zone are either not significant or are specified elsewhere.
        An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.
    TimeSeries:
      type: object
      description: Represents a timeseries.
      properties:
        datedValues:
          items:
            $ref: '#/components/schemas/DatedValue'
          type: array
          description: List of datapoints in the timeseries, where each datapoint is a date-value pair.
x-provenance:
  method: harvested
  publisher: Google
  source: https://businessprofileperformance.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)