Google Business Profile API

Google Business Profile Media API

List, upload, categorize, and delete Google Business Profile media items such as storefront, interior, product, menu, food, logo, and cover photos.

Last updated: May 2026

List existing Google Business Profile media items

Add media after the standard bundle.social upload flow

Delete media by Google media resource name

What the media workflow manages

This workflow manages media attached to the Google Business Profile location. Profile media appears in the Photos area of the business profile, not only inside a single Google post. It is useful for storefront photos, interiors, food and drink, menu images, product shots, team photos, cover photos, logos, and other profile gallery content.

Endpoint and payload shape

Use GET /api/v1/misc/google-business/media to list media, POST /api/v1/misc/google-business/media to add media, and DELETE /api/v1/misc/google-business/media to remove media. Adding media requires teamId and uploadId from the standard bundle.social upload flow. Deleting requires mediaName, the full Google media resource name returned for the item.

Supported media categories

The category field can describe how the media should be used, with values such as COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, and ADDITIONAL. Some categories may not apply cleanly to every business type, so list current media first and mirror how Google already categorizes that location when needed.

Where teams usually get stuck

Teams often mix up post media and profile media. A Google post image lives with a post. Google Business Profile media belongs to the location gallery. If your product has both publishing and profile management, make this distinction clear in the UI before users assume every upload becomes a post.

How bundle.social fits

bundle.social lets your app use the same upload infrastructure for social media publishing and Google Business Profile media. Upload the file once, receive an uploadId, then attach it to the selected location with the right category and description.

FAQ

Is Google Business Profile media the same as media in a Google post?

No. Profile media is attached to the business location gallery. Post media is attached to an individual post, event, or offer.

Do I upload the file directly to the media endpoint?

No. First upload the file through the standard bundle.social upload flow. Then use the returned uploadId in the Google Business Profile media endpoint.

Can I delete media?

Yes. Use the DELETE endpoint with teamId and mediaName. mediaName should be the full resource name returned by Google for that media item.

Build with less platform drag

Use one API for social publishing workflows

Create account