Google Business Profile Media API

These endpoints manage media items attached to the selected Business Profile location (photos and some videos). They complement post images: profile media appears in the Photos area of the profile, not only inside a single post. Media capabilities are partially category/profile dependent. Some categories or media types may be limited by Google policy, moderation, or profile eligibility. Base path: /api/v1/misc/google-business

List media

Endpoint: GET /api/v1/misc/google-business/media

Query	Required	Description
`teamId`	Yes	Team identifier.
`pageSize`	No	1 to 250.
`pageToken`	No	Pagination.

Response includes mediaItems (each may have name, googleUrl, mediaFormat PHOTO or VIDEO, thumbnailUrl, description, locationAssociation with optional category, and so on), plus optional nextPageToken and totalMediaItemCount.

Delete media

Endpoint: DELETE /api/v1/misc/google-business/media

{
  "teamId": "team_123",
  "mediaName": "accounts/123/locations/456/media/789"
}

mediaName is the full resource name returned by Google for that media item.

Add media (upload)

Endpoint: POST /api/v1/misc/google-business/media Use after you uploaded a file through the standard upload flow and obtained an uploadId.

Field	Required	Description
`teamId`	Yes	Team identifier.
`uploadId`	Yes	From your completed upload.
`category`	No	One of: `CATEGORY_UNSPECIFIED`, `COVER`, `PROFILE`, `LOGO`, `EXTERIOR`, `INTERIOR`, `PRODUCT`, `AT_WORK`, `FOOD_AND_DRINK`, `MENU`, `COMMON_AREA`, `ROOMS`, `TEAMS`, `ADDITIONAL` (default behavior may treat unspecified as `ADDITIONAL`).
`description`	No	Max 2000 characters.

Some category values may be less relevant or not applied consistently for specific business categories. If unsure, list current media first and mirror categories already used by Google on that location.

Example

{
  "teamId": "team_123",
  "uploadId": "upload_abc123",
  "category": "EXTERIOR",
  "description": "Storefront at night"
}

Google Business main guide for post images and post limits.
Connect social accounts if the account is not connected yet.

API Documentation

Platforms

Guides

Endpoints

Google Business Profile media

List media

Delete media

Add media (upload)

Example

​List media

​Delete media

​Add media (upload)

​Example

​Related

List media

Delete media

Add media (upload)

Example

Related