All tools
list-scheduled-gbp-postsfreeStored Metrics & Reporting

List Scheduled Posts Tool

List scheduled and historical Google Business Profile posts for a site, filterable by status and date range. Use after schedule-gbp-post / update-scheduled-gbp-post to confirm state, or to surface upcoming posts in a calendar view.

Parameters

NameTypeRequiredDescription
site_idintegerrequiredThe tracked site ID.
statusstringoptionalOptional status filter. One of: 'draft', 'pending_review', 'scheduled', 'publishing', 'published', 'failed', 'cancelled'.
fromstringoptionalInclusive lower bound on scheduled_at (YYYY-MM-DD or ISO-8601).
tostringoptionalInclusive upper bound on scheduled_at.
limitintegeroptionalMaximum rows. Default 50, max 200.

Plan access

Available on the free tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).

See plans