Tracking Social Engagement
Overview
Social signals — Pinterest saves, Reddit mentions, and Facebook shares — indicate how your content resonates across social platforms. While not direct ranking factors, they correlate with visibility, link building, and brand awareness. TransformSEO provides live lookup tools for any URL, plus automated syncing to track your site's social presence over time.
get-social-pinterest
Returns the Pinterest pin count for up to 10 URLs. Useful for measuring how visual or shareable your content is on Pinterest.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
urls | array of strings | Yes | URLs to check (max 10) |
Example
"How many Pinterest pins does my homepage have?"
get-social-reddit
Returns Reddit mentions for up to 10 URLs — subreddit, author, title, permalink, and member count. Discover which communities are discussing your content.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
urls | array of strings | Yes | URLs to check (max 10) |
Example
"Check Reddit mentions for my top blog posts."
get-social-facebook
Returns the Facebook like count for up to 10 URLs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
urls | array of strings | Yes | URLs to check (max 10) |
sync-social-signals
Dispatches a background job to fetch social signals for a tracked site's top 10 pages (by Search Console clicks, or by backlink profile if no Search Console data). Snapshots are stored daily and can be read with get-social-signal-history.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID from list-sites |
get-social-signal-history
Reads stored social signal snapshots for a site. Shows Pinterest pins, Reddit mentions, and Facebook likes per page over time.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID from list-sites |
days | integer | No | Number of days of history (default: 90, max: 365) |
Tips
- Run
sync-social-signalsfirst if no data has been synced yet. - Social signals are synced automatically on a schedule based on your subscription tier.
- Track trends over time to see which pages gain or lose social engagement.
generate-monthly-report
Aggregates data from 9 stored sources (analytics, search console, domain overview, backlinks, site audits, Core Web Vitals, keyword rankings, competitors, and LLM mentions) into a single structured report payload with month-over-month deltas. Designed to be called by the monthly-seo-report prompt, but can also be used standalone.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID from list-sites |
month | string | No | Report month in YYYY-MM format (defaults to previous month) |
Tips
- Consumes 0 credits — reads only stored data.
- The response includes a
data_availabilityobject showing which sections have data. - Best used with the
monthly-seo-reportprompt, which formats the data into a professional report. - Ensure your site has synced data for the target month, otherwise sections will be empty.