list-scheduled-gbp-postsfreeStored Metrics & ReportingList 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
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | integer | required | The tracked site ID. |
| status | string | optional | Optional status filter. One of: 'draft', 'pending_review', 'scheduled', 'publishing', 'published', 'failed', 'cancelled'. |
| from | string | optional | Inclusive lower bound on scheduled_at (YYYY-MM-DD or ISO-8601). |
| to | string | optional | Inclusive upper bound on scheduled_at. |
| limit | integer | optional | Maximum 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