Media API

Introduction to the Media API

The Media API is a powerful tool designed to simplify how you manage images for your listings. By using the Media API, you can efficiently upload profile, cover, and location images to PinMeTo directly from your own systems. It offers flexibility and control to ensure your listings always showcase recent, high-quality visuals; helping maintain a consistent and professional online presence across all connected networks.

FAQ

Are you a developer?

For technical documentation read our API Documentation

Image Types

Logo & Profile Image

Your logo and profile images play a key role in helping customers recognize your brand. With the Media API, you can choose to set different images for each location and network, or apply a single image across all locations and networks.

For detailed specifications and best practice recommendations, please see our Specifications Summary.

Cover Image

Cover images are large, visually impactful photos used to showcase your brand or location on each network. While recommended dimensions and aspect ratios vary between networks, the Media API gives you the flexibility to use the same image across platforms or tailor images for each.

Tips for cross-network cover images: Use 16:9 aspect ratio and center key content like logos, text or faces.

Google chooses the cover photo shown on your listing. To increase the chance your image is selected, use a clear, high-quality photo of the storefront. This helps people recognize your location when navigating.

For image specifications, network requirements, and best practices, refer to our Specifications Summary.

Location Images

Location images provide a realistic impression of what customers can expect when visiting your physical location. These may include photos of your storefront, interior, exterior, signage, staff, or products—anything that helps represent the in-person experience.

These images should be unique, recent, and taken at the actual location. With the Media API, you can efficiently upload multiple location images per store to Google, ensuring each listing accurately reflects the physical space. (Location images are currently only supported for Google Business Profile.)

Maintaining a gallery of at least 9 high-quality images per location improves both the credibility and visual appeal of your listings—helping potential customers recognize and choose your business.

Setting up Your API Access

Only users with access to Account Settings can set up the API Access. Go to Account Settings > API



Each API integration app can have their own configuration. Make sure that the app you want to use for media has both the Modify Locations and Modify Media boxes checked.

Approval

When uploading images via the Media API, PinMeTo offers two approval flows depending on your preferences: manual approval or automatic approval.

Manual Approval

With manual approval, all uploaded images must be reviewed by a user in your PinMeTo Listings account before they are published to any network. This ensures full control over the content being added to your listings.



Manual approval applies when:
Automatic approval is disabled for your account.
The API integration does not have permission to modify location data (configured under Account Settings > API).
Even if automatic approval is enabled, images can be flagged for manual review when submitted through the API.

In these cases, images are uploaded to PinMeTo but remain in a pending state until manually approved in the Listings interface by a user in your account.

Automatic Approval

With automatic approval enabled, images uploaded via the Media API are published to your listings automatically—without requiring manual review.




For automated approval to apply:
Automatic approval must be enabled for your account.
The API integration must have permission to modify location data (configured under Account Settings > API).

If you want to make exceptions, you can flag specific images for manual review, even when auto-approval is active.

Enable Automatic Approval:

Account Settings > API.
At the top of the page under API Settings, check the box that says "Automatically approve media in Media API requests" and press Save.

Make sure that you enable 'Modify Locations' permission under API Access to enable automatic approval

FAQ

What image formats are supported?

The Media API supports JPG and PNG formats. These are the standard formats accepted by both Google Business Profile and Facebook Business Manager.

Is there a size or rate limit when uploading images?

Yes. Please refer to the API Documentation for details.

What are the recommended resolutions and aspect ratios for each image type?

Here's a summary of recommended specifications for each type of image across networks:

Image Type	Network	Recommended Size	Aspect Ratio	Notes
Profile / Logo	Google, Facebook	720 x 720 px or larger	1:1 (Square)	Use a clear brand logo with a solid background
Cover	Facebook (Desktop)	820 x 312 px	~2.63:1	Center key content to prevent cropping
	Facebook (Mobile)	640 x 360 px		Facebook displays differently across devices
	Facebook (Recommended Upload)	820 x 360 px		Balances both views
	Google	1024 x 576 px	16:9	Avoid excessive filters or overlays
Location Images	Google	1024 x 768 px or higher		Use high-quality, recent photos of the actual location

Can I use the same image for different locations or networks?

Yes, you can use a single image across multiple locations and networks for profile/logo and cover images. The Media API will reuse the image and create the necessary associations between locations and networks.

No, not for location images. Location images should be unique photos taken at the location and should not be reused.

What happens if the same image is uploaded more than once?

The Media API automatically detects duplicate images. If the image is identical, it won’t be stored twice. Instead, it will create the necessary associations between locations and networks.

What happens if an image needs manual review?

If your site has manual approval enabled, or if the API integration lacks permissions to modify locations, images will remain in a pending state until a user with access to those locations manually approves them in Listings.

You can also disable automatic approval for specific media requests, even if automated approval is enabled. Talk to your developers and refer them to the API Documentation.

Updated on: 28/05/2025