v1Resources/Posts/getRead the client post rollup
Read the client post rollup
Requires Social and client access. Returns 30-day post totals and previous-period comparisons, posting health counts and missing brand platforms. Optional locationId narrows stat cards; health counts still cover the client, narrowed by tag when supplied. A tag limits results to its locations and excludes brand-level posts. Website locations include their own and brand-level posts. The location must belong to the named client. Drafts and ideas do not establish posting activity.
get
posts:read/api/v1/posts/rollupQuery parameters
clientIdstringrequired
locationIdstringoptional
tagstringoptional
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/rollup
Your API key
clientId *
locationId
tag
{}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.