SPS

Social Post Search

Social Media · Basic · Updated March 2026

Search and filter social media posts by platform, status, date range, and category. Retrieve post performance data and scheduling information.

Finding specific posts across a busy content calendar is essential for reporting, auditing, and content management. Social Post Search lets you filter posts by platform, publication status, date range, and category, giving you programmatic access to the social content calendar.

What This MCP Tool Does

Search and filter social media posts with multiple criteria. Returns paginated results including post content, platform targets, publication status, scheduled dates, and performance data where available.

Endpoint Reference

Search posts: GET /social-media-posting/posts/search Query posts with filters for platform, status, date range, category, and tags. Returns paginated results.

Authentication

Requires a Private Integration Token (PIT) with the social-media-posting scope enabled.

Key Parameters

accounts — filter by specific social accounts
status — published, scheduled, draft, failed
fromDate, toDate — date range filters
categoryId — filter by content category
limit, offset — pagination

Important Notes

Search results include post metadata but may not include full engagement metrics. Platform-specific analytics (likes, comments, shares) depend on what GHL pulls back from each platform’s API.

Use date range filters for content calendar reporting — pull all posts for a month, group by platform, and build custom reports outside of GHL’s built-in analytics.

Common Questions

Can I search across all platforms at once? Yes. Omit the accounts filter to search across all connected platforms.

Does search return engagement metrics? Partially. Available metrics depend on what each platform’s API provides to GHL.

Can I export search results? Not directly as a file. Retrieve results via MCP and write them to whatever format you need.

Social Post CRUD — Create and manage the posts you’re searching
Social Categories — Categories used for filtering
Social Tags — Tags used for post organization
Social Accounts — The platform accounts posts are published to
Social Bulk Delete — Delete multiple posts found through search