Data tools
Connect Facebook, Instagram, Google Search Console and more once. Then your code or your AI agent can run their reports and lookups through the same API key and MCP server you post with.
How it works
A data account lists its tools with an input schema. Send the tool’s input as the JSON body and the result comes straight back.
Sign in with Google from Accounts in the dashboard. Each Google product connects on its own and asks only for its own access.
GET /api/v1/accounts/{id}/tools returns each tool’s name, description, read_only flag and input_schema.
POST /api/v1/accounts/{id}/tools/{tool} with the input as the JSON body. It runs once, straight away.
curl https://socialhelper.app/api/v1/accounts/ACCOUNT_ID/tools \
-H "Authorization: Bearer $SOCIALHELPER_API_KEY"curl https://socialhelper.app/api/v1/accounts/ACCOUNT_ID/tools/search_analytics \
-H "Authorization: Bearer $SOCIALHELPER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"site_url": "sc-domain:example.com",
"start_date": "2026-09-01",
"end_date": "2026-09-30",
"dimensions": [
"query"
],
"row_limit": 10
}'{
"object": "tool_result",
"account": "ACCOUNT_ID",
"tool": "search_analytics",
"data": {
"…": "…"
}
}List the Page's most recent posts, newest first, with their text, permalink, creation time and reaction, comment and share counts.
Read Page Insights over time. Allowed metrics: page_media_view, page_total_media_view_unique, page_post_engagements, page_total_actions, page_views_total, page_follows, page_daily_follows_unique, page_daily_unfollows_unique, page_actions_post_reactions_total, page_video_views, page_video_views_organic, page_video_views_paid, page_video_complete_views_30s, page_video_view_time. page_follows, page_actions_post_reactions_total and page_video_view_time only support period "day". Meta needs the Page to have 100 or more followers, keeps two years of data and returns at most 90 days per request.
Read lifetime Insights for one of the Page's posts. Allowed metrics: post_media_view, post_total_media_view_unique, post_clicks, post_clicks_by_type, post_reactions_by_type_total, post_reactions_like_total, post_reactions_love_total, post_reactions_wow_total, post_reactions_haha_total, post_reactions_sorry_total, post_reactions_anger_total, post_video_views, post_video_views_organic, post_video_views_paid, post_video_avg_time_watched, post_video_view_time, post_video_complete_views_organic, post_video_complete_views_paid, post_video_length.
List the account's most recent posts, reels and carousels, newest first (stories are not included), with caption, media type, publish time, permalink, and like and comment counts. Counts are null where the owner hid them.
Account-level insights summed over a date range (default: the last 24 hours), optionally broken down. Data can lag up to 48 hours; reach and accounts_engaged are estimates; follows_and_unfollows needs 100+ followers.
Lifetime insights for one post, reel or carousel (as list_media returns it). Metrics that do not apply to the media type are rejected by Instagram. Data can lag up to 48 hours.
List the Search Console properties this account can access, with its permission level on each.
Query search performance (clicks, impressions, CTR, average position), optionally grouped by query, page, country, device, search appearance, date or hour. Dates are Pacific Time; data usually lags 2–3 days unless data_state is "all".
Inspect how Google sees one URL of a property: index status, coverage, last crawl, canonical, mobile usability and rich results.
List the sitemaps submitted for a property, with their status, errors, warnings and indexed content counts.
List the Google Analytics accounts this login can access, with their GA4 properties (resource name, display name and type).
Run a GA4 report: metrics (e.g. activeUsers, newUsers, sessions, screenPageViews, engagementRate, keyEvents, totalRevenue) over a date range, optionally broken down by up to 9 dimensions (e.g. date, sessionDefaultChannelGroup, sessionSource, pagePath, landingPage, country, deviceCategory). Use get_metadata for every name the property supports, including custom ones. Dates are in the property's time zone.
Report on the last 30 minutes. Realtime supports fewer names: metrics activeUsers, eventCount, keyEvents, screenPageViews; dimensions such as country, city, deviceCategory, platform, eventName, unifiedScreenName, minutesAgo.
List the dimensions and metrics a property can report on, including its custom definitions, with their API names, UI names, descriptions and categories.
List the channel's most recent uploads, newest first, with title, publish time, privacy and view, like and comment counts. Counts are null where the owner hid them.
Get the channel's totals: subscribers (rounded down to three significant figures by YouTube), views and public videos.
List the Google Ads accounts this Google login can access directly, with name, currency, time zone, status and whether each is a manager (MCC) or test account. Accounts that can't be read (for example, not enabled) are listed with an error. Client accounts reached only through a manager are not listed; use list_child_accounts on the manager. Describes at most 50 accounts.
List the client accounts under a manager (MCC) account, with name, currency, time zone, status, whether each is itself a manager, and its level below the manager.
Run a read-only Google Ads Query Language (GAQL) query, e.g. "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS". Only SELECT queries are accepted. Rows are returned as Google sends them: camelCase field names, 64-bit numbers as strings, money in micros (millionths of the account currency). Reference: https://developers.google.com/google-ads/api/docs/query/overview
Per-campaign performance for a date range: impressions, clicks, cost, conversions, conversion value, CTR and average CPC, with status and channel type, sorted by cost. Cost and CPC are in the account currency. Dates are in the account's time zone. Give start_date and end_date, or during (default LAST_30_DAYS, not including today).
FAQ
Operations a connected account offers besides posting, such as reports and lookups. Each tool has a name, a description and an input schema, and runs straight away when you call it.
Right now: Facebook, Instagram, Google Search Console, Google Analytics, YouTube and Google Ads.
Most tools only read. Any tool that makes a change is marked “makes changes” here and has read_only set to false in its description.
The call returns 409 with code reconnect_required, the account is flagged in the dashboard, and the account.needs_reconnect webhook fires.
No. Tools run once, synchronously. If the platform is busy you get 503 with code temporarily_unavailable, and a Retry-After header when the platform sent one.
Create a free account, connect an account and send your first post in a few minutes.