---
title: "List Customer Media"
method: POST
path: "/v2/gbp/customer-media/"
tags: ["Manage Google Business Profile"]
---

# List Customer Media

`POST /v2/gbp/customer-media/`

## Request

- Base URL: `https://api.localfalcon.com`
- URL: `https://api.localfalcon.com/v2/gbp/customer-media/`
- Auth: none declared

List the photos customers have added to a connected Google Business Profile. These are read only.

When more results exist the response carries a `next_token`. Pass it back as `next_token` to fetch the next page. When it is absent you have reached the end.

## Request body `application/x-www-form-urlencoded`

- object
  - `api_key` string, required: Your Local Falcon API key.
  - `place_id` string, required: The Place ID of a connected location.
  - `media_id` string: Retrieve a single item instead of a list.
  - `limit` integer: Number of results to return, 1 to 100. Values outside that range are rejected. Omit to use the default.
  - `next_token` string: Page token from a previous response.

## Response `200`

Successful response

- object
  - `code` integer
  - `code_desc` union
    - string
    - boolean
  - `success` boolean
  - `message` union
    - string
    - boolean
  - `parameters` object
  - `data` object

## Other responses

- `400`: The request was malformed or missing required parameters.
- `401`: The API key is missing, invalid, or does not have permission for the requested resource.
- `429`: You have exceeded the rate limit. Please wait before making additional requests.
- `500`: An unexpected error occurred on the server. Please try again later.

## Changes

- **2026-09-03** `85390c3f81cf`: 2 info
  - api tag `Manage Google Business Profile` added
  - api tag `Google Business Profile` removed
- **2026-09-02** `ad66f8884700`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/localfalcon/apis/local-falcon-api/changes/v2/gbp/customer-media/post.md)

---

[API](https://skmtc.dev/localfalcon/apis/local-falcon-api.md) - [All operations](https://skmtc.dev/localfalcon/apis/local-falcon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/localfalcon/apis/local-falcon-api/revisions/304db93dea96?raw)