API
APIs at PinMeTo
Table of Contents
Section 1: API Overview
What is an API?
API stands for Application Programming Interface and is simply a way for your tools to share information with each other automatically.
What are PinMeTo APIs?
Instead of copying data between systems or worrying about updates being missed, the API keeps everything in sync behind the scenes. Your location details, images, and reports stay accurate everywhere — without extra work from you.
Are you a developer?
For technical documentation read our APIs documentation 🔗
What Can You Build with PinMeTo APIs?
With the PinMeTo APIs, you’re not limited to using the platform as-is. You can connect your own systems, automate repetitive tasks, and customize how location data is managed and shared across your organization. Below are some examples of what you can build.
Location Management - One Source of Truth
Keep your internal systems and PinMeTo aligned by syncing location data automatically. This ensures information such as addresses, opening hours, and services stays consistent across systems. Read more about our Locations API.
Insights - Perform Better
Bring reviews, ratings, and keyword data into your reporting systems. These APIs let you combine customer feedback and performance data with your own business metrics. Insights APIs Documentation 🔗
Workflow Management - Empower Local Teams
Give local managers the ability to update information like opening hours, services, or images through tools you build. Changes can be reviewed in PinMeTo before they go live, or approved automatically. APIs Documentation 🔗
Media Management - Stay on Brand
Connect your internal tools or digital asset management (DAM) system to PinMeTo. This keeps photos up to date without needing to upload them manually in multiple places. Read more about our Media API.
Keyword Tracking - Be Relevant
Access the search terms customers use to find your locations. This data can be sent into your own analytics tools for monitoring trends and customer behavior. Keywords API Documentation 🔗
Setting up API access
- Go To Account Settings
- Go to Access Management and click on Add New User
- Fill out the information and make sure you set the role to API Developer
This will give the API Developer access to the API pages in Account Settings.
For more information, check out our User Management guide.
- After updating the role, go to Account Settings > API and click on Create new app for Listings
- The API developer should set up the new app according to the API Documentation 🔗
Automatic Approval & Updates
You can choose to have routine updates made through the APIs publish automatically, without requiring manual approval or conflict resolution in PinMeTo.
To Enable Automatic Approval & Updates
- Go to Account Settings > API.
- Under API Settings, check the box for the type of updates you want to approve automatically.
- Click Save to apply the changes.
Once enabled, updates sent through the selected API will be published automatically according to your chosen settings.
Media
For the Media API, this means that images uploaded through the API are automatically published to your listings without needing manual review.
Read more below about the approval process and automatic publishing with our Media API.
Location API v4
With Locations API v4, updates from your internal systems can be automatically published to your connected networks.
In earlier versions, updates sent from your systems were stored in PinMeTo but not published until they were manually approved.
With v4, you can automate this step — ensuring that location data is shared instantly and remains consistent across all networks.
Read more below about setup and configuration for our Locations API.
Section 2: Locations API
What is new in the latest version (v4) of the Locations API?
- Automatic updates of location updates.
- Improved validation for all data sent through the API.
- You can now get and set Google attributes.
- Create and manage hybrid- and service area locations – just like storefront locations.
Are you a developer?
For technical documentation read our Locations API documentation 🔗
What You Can Build with the Locations API
Location Information Management - One Source of Truth
Sync your internal systems with PinMeTo so location data (addresses, opening hours, attributes, etc.) stays consistent everywhere. You decide if your source of truth should be PinMeTo or your own systems or databases.
Workflow Management - Empower Local Teams
Build tools that let store managers or local/regional teams update details such as opening hours, attributes or temporary closures (e.g. renovations). Updates can be automatically published or manually reviewed in PinMeTo.
Automatic Updates
When integrating with the Locations API v4, you can choose how updates are handled:
- Routine updates (like open hours or attributes) can be set to publish automatically.
- Address or coordinate changes will show up in your To Do-list in the dashboard.
- New locations must always be verified before going live.
How Locations API v4 Handles Updates
In earlier versions of the API, updates from your systems were saved in PinMeTo but not automatically published to connected networks.
This registered as data conflicts between the updated information in PinMeTo and the information on networks, requiring you to manually resolve them before updates could go live.
With Locations API v4, you can automate this step. Updates sent from your internal systems are now updating the PinMeTo data and sent to your connected networks automatically — keeping all data in sync and reducing manual work.
To Enable Automatic Updates for Locations API v4 ONLY
- Make sure you are using the newest version of the Locations API (v4).
- Go to Account Settings > API.
- Under API Settings, check the box for Locations API v4.
- Click Save to apply the changes.
Section 3: 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.
Are you a developer?
For technical documentation read our API Documentation 🔗
Image Types
Logo & Profile Image
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.
Cover Image
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.
Location Images
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.)
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).
To Enable Automatic Approval for Media API ONLY
- Go to Account Settings > API.
- Under API Settings, check the box for Media.
- Click Save to apply the changes.
FAQ
Q: What kind of tools can connect with PinMeTo APIs?
A: Websites, store locators, reporting dashboards, internal systems — basically any tool that benefits from fresh, accurate location data.
Q: Do I need to know how to code to use the Locations API?
A: No. As a PinMeTo user you don’t need coding skills. But you do need an API Developer or your IT department to connect your systems to the API.
Q: Who in my team should set this up?
A: Typically, your API Developer or IT team will handle the technical setup. If you are a user in PinMeTo with the role Owner, start by adding a new user in Account Settings. Add the person who will handle the technical implementation and set their role to "API Developer". Read more about setting up the API.
Q: Does Automatic Updates mean I won't have to resolve conflicts?
A: No. When you send an update through the API, the new information is published to connected networks — and this will often resolve existing conflicts for that field.
However, if the data hasn’t changed, no update is sent. In those cases, any existing conflicts will remain until they’re manually resolved in PinMeTo.
Q: Do I still need to review address changes or verify new locations?
A: Yes. Address or coordinate changes sent through the API appear in your To Do list for manual review before publishing. New locations created via the API must also be verified in PinMeTo before going live.
You can find both tasks in the To Do section of your Listings dashboard.
Q: Can local teams use this without giving them full access to PinMeTo?
A: Yes. You can build custom tools with the API that let local teams manage specific details. What functionality the local teams should have access to is handled inside your own systems. Their updates are sent into PinMeTo for approval or automatic publishing, while you keep centralized oversight.
Q: What image formats are supported?
A: The Media API supports JPG and PNG formats. These are the standard formats accepted by both Google Business Profile and Facebook Business Manager.
Q: Is there a size or rate limit when uploading images?
A: Yes. Please refer to the API Documentation 🔗 for details.
Q: What are the recommended resolutions and aspect ratios for each image type?
A: You can find specifications in our Listings guide.
Q: Can I use the same image for different locations or networks?
A: 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. But no, you should not use the same image for different locations. Location images should be unique photos taken at the location and should not be reused.
Q: What happens if the same image is uploaded more than once?
A: 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.
Q: What happens if an image needs manual review?
A: 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: 04/11/2025
Thank you!