v1Resources/Posts/getRead paid post analytics
Read paid post analytics
Requires an active agency user with Social access and access to the owning client or location. Reads stored analytics without publishing, collecting new data or creating ad spend. from/to accept dates or ISO timestamps and default to the last 30 days. Local post analytics uses the exact timestamps (a date is UTC midnight); follower and boost aggregates use daily observations. Paid analytics supports brand (default) or local channel and a local tag name. Follower analytics retains observation coverage; local post analytics returns Google/Facebook views, clicks, trends and up to 20 top posts with metric-support flags.
get
posts:read/api/v1/posts/analytics/boostQuery parameters
clientIdstringrequired
channelstring (local | brand)optional
tagstringoptional
fromstringoptional
tostringoptional
Response
dataobjectoptional
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
503The post analytics could not be read.
get/api/v1/posts/analytics/boost
Your API key
clientId *
channel
tag
from
to
{}Guides that use this resource
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Publish Google Business Profile Posts ProgrammaticallyPublish announcements, offers and events to Google Business Profile via API, schedule them, handle the missing-connection draft, and measure post performance.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Publish a Google Business Profile Post via APIPublish an announcement, offer or event to a location's connected platforms, and handle the draft returned when a platform is not connected.