connect_platform
ChatGPTConnect a platform to PaidSync. Returns a link for the user to open and sign in on PaidSync; nothing is entered in chat. On this connection it only returns that link and changes nothing in any ad account, property or container.
get_account_summary
ChatGPTGet account name, currency, timezone, and status for the active Google Ads account
get_ad_performance
ChatGPTGet ad-level performance breakdown: see which individual ads are performing best with impressions, clicks, CTR, CPC, conversions
get_campaign_performance
ChatGPTCampaign performance breakdown sorted by spend: impressions, clicks, CTR, CPC, cost, conversions, budget, and status per campaign.
get_fb_ad_performance
ChatGPTGet Facebook individual ad level performance: impressions, clicks, spend, reach, CTR, CPC. Use date_preset OR start_date + end_date.
get_fb_adset_performance
ChatGPTGet Facebook Ad Set level performance: impressions, clicks, spend, reach, CTR, CPC, conversions. Use date_preset OR start_date + end_date.
get_fb_performance
ChatGPTGet Facebook campaign performance: impressions, clicks, spend, CTR, CPC, ROAS, and conversions.
get_keyword_performance
ChatGPTKeyword performance report: top 100 keywords by cost or conversions with spend, clicks, impressions, quality score, max CPC bid. Sort with sort_by (cost or conversions). CTR and CPC are derivable from the returned clicks, impressions, and cost.
get_linkedin_performance
ChatGPTGet LinkedIn campaign performance: impressions, clicks, spend, CTR, CPC, and conversions. NOTE: conversions = website conversions + Lead Gen Form leads combined; Campaign Manager shows these as separate columns, and both components are returned separately as website_conversions and lead_gen_leads. Accepts either an explicit start_date/end_date pair OR a date_range shorthand (today, yesterday, last_7_days, last_14_days, last_28_days, last_30_days, last_90_days, last_365_days, this_month, last_month, this_quarter, last_quarter, this_year, last_year, maximum) for parity with other platforms.
get_ms_adgroup_performance
ChatGPTAd group level delivery with the full device, network, distribution, position and match-type breakdown, plus impression share and quality score (Microsoft AdGroupPerformanceReport). include_impression_share is a SEPARATE toggle from the other segmentations because Microsoft's own guidance is that a report must carry at least one NON-impression-share performance statistic: impression share columns cannot stand alone. The handler always keeps the non-impression-share metrics in the column list, so that rule cannot be broken by turning this on. Every segmentation toggle is echoed with the sentence that an attribute column splits rows and changes how the statistics aggregate, so a device-on total and a device-off total are the same money reported at different grain, not a discrepancy. This report publishes its own CurrencyCode column, so each row carries its real currency. Read-only.
get_ms_keyword_performance
ChatGPTKeyword level delivery, quality score components, bids and the full device, network and match-type breakdown (Microsoft KeywordPerformanceReport). THE TRAP UNIQUE TO THIS REPORT: it is the only one in this set that publishes a MaxRows element, and MaxRows makes MICROSOFT truncate the report server side. A total computed over a truncated report is NOT an account total. So when max_rows is sent, totals_complete is false, the message says the totals cover the returned rows only, and truncated_by_microsoft is true when the row count equals max_rows and 'unknown' otherwise, because Microsoft returns no truncation flag of its own. When max_rows is not sent, totals_complete is true. Quality score components come back only when include_quality_score is on, and are null rather than 0 when Microsoft returns a blank cell: a quality score of 0 is not a real score. keyword text is advertiser-written and is bounded and named in untrusted_fields. Read-only.
get_ms_performance
ChatGPTGet Microsoft Advertising (Bing) campaign performance: spend, clicks, impressions, conversions, revenue, CTR, average CPC, ROAS. Uses the Reporting API async submit-poll-download flow. Runs on the active Microsoft Ads account, or on account_id (with its customer_id) for this call only. Args: date_range (default last_30_days; also last_7_days, this_month, last_month, last_3_months, or last_N_days), start_date/end_date (YYYY-MM-DD) for a custom range, campaign_id to scope to one campaign, aggregation 'Summary' (default, one row per campaign) or 'Daily' (per-day breakdown).
get_openai_performance
ChatGPTGet OpenAI Ads performance insights. Scope can be ad_account, campaign, ad_group, or ad. Metrics include impressions, clicks, spend, CTR, CPC, CPM.
get_performance_summary
ChatGPTGet account-level performance metrics: impressions, clicks, CTR, CPC, conversions, cost, ROAS for a date range
get_pinterest_performance
ChatGPTGet Pinterest campaign performance (impressions, clicks, CTR, CPC, spend, conversions, ROAS) from the analytics API over a date range. Runs for the active or provided ad account. Supports attribution-split conversions (click vs view vs engagement), configurable attribution windows, and conversion-value columns for ROAS. Blended TOTAL_CONVERSIONS is NOT the last-click number: to get a strict click-through count comparable to Google/GA4, request the click-attributed columns (e.g. TOTAL_CLICK_CHECKOUT) and/or set click/view/engagement windows.
get_reddit_performance
ChatGPTGet Reddit Ads performance (impressions, clicks, spend, key conversions, purchase conversions) via the reports API for the active or provided ad account. Provide a date range and the breakdown grain: ACCOUNT, CAMPAIGN, AD_GROUP, or AD (defaults CAMPAIGN). Times are read in time_zone_id (default GMT) and must fall on a whole hour; a plain date means 00:00. ends_at is where the report stops, so to cover 1-7 Sep pass 2026-09-01 to 2026-09-08. Money fields (spend, CPC, CPM, cost per action, conversion value) are returned in the account currency.
get_search_terms_report
ChatGPTSearch terms report: queries that triggered your ads with per-query spend, clicks, and conversions to spot wasted spend and add negatives. Top 500 terms ranked by sort_by (cost by default, or clicks, impressions, conversions), ranked by Google before the cap, so a top-N is exact.
get_snapchat_performance
ChatGPTGet Snapchat campaign performance (impressions, swipes, spend, video views, conversions) from the stats API. Defaults to lifetime TOTAL; pass a date range for a windowed report.
get_tiktok_performance
ChatGPTGet TikTok Ads performance (impressions, clicks, CTR, CPC, CPM, spend, conversions) from the reporting API. Choose the level of grain (advertiser / campaign / adgroup / ad) and a date range. Data has ~1-2h delay.
get_x_performance
ChatGPTGet X Ads performance (spend, impressions, clicks, engagements) for the active or provided ads account. Provide an inclusive date range and the grain: ACCOUNT, CAMPAIGN, or LINE_ITEM (defaults CAMPAIGN). Spend is reported in the ad account's local currency; days follow the ad account's timezone; totals sum the ALL_ON_TWITTER and PUBLISHER_NETWORK placements (the applied scope is echoed in the response).
list_accounts
ChatGPTList all Google Ads accounts across every connected Google identity. Walks identities + their MCCs recursively (including nested MCCs). Returns a flat list with connected_via (which Google account surfaced each account), access_path (direct or under_mcc), via_mcc (parent MCC if applicable), and is_manager. When summarizing for the user, group accounts by connected_via so they can see which Google account has access to what. NOTE: this tool is Google Ads only. An empty result here means no Google Ads identity is connected; it does NOT mean Google is required to use Meta, LinkedIn, or any other platform.
list_fb_ad_accounts
ChatGPTList all Meta (Facebook) Ad Accounts across every connected Facebook identity. Each account carries connected_via (which Meta account has access) and token_type (oauth vs system_user). When summarizing for the user, group by connected_via so they can see which identity sees which account.
list_linkedin_ad_accounts
ChatGPTList all LinkedIn Ad Accounts across every connected LinkedIn identity. Each account carries connected_via (which LinkedIn account has access). When summarizing for the user, group by connected_via.
list_ms_accounts
ChatGPTList all Microsoft Advertising accounts accessible across connected identities.
list_openai_accounts
ChatGPTList all OpenAI Ads accounts connected across stored API keys. Each key corresponds to one ad account. Dedupes by account id and tags each with connected_via.
list_pinterest_accounts
ChatGPTList all Pinterest ad accounts accessible across connected Pinterest identities. Dedupes by ad_account_id and tags each with connected_via.
list_reddit_accounts
ChatGPTList all Reddit ad accounts accessible across connected Reddit identities. Walks each connected token, dedupes by ad_account_id, and tags each with connected_via (which Reddit identity surfaced it).
list_snapchat_accounts
ChatGPTList all Snapchat ad accounts accessible across connected Snapchat identities. Walks each connected token, lists organizations then ad accounts under each, dedupes by ad_account_id, and tags each with connected_via (which Snapchat identity surfaced it).
list_tiktok_advertisers
ChatGPTList all TikTok advertiser accounts accessible across connected TikTok identities. Walks every connected token, flags Business Center (BC) memberships via bc_id, dedupes by advertiser_id, and tags each with connected_via (which TikTok identity surfaced it). When summarizing for the user, group by connected_via.
list_x_accounts
ChatGPTList all X Ads (Twitter Ads) accounts accessible across connected X identities. Walks each connected token, dedupes by account_id, and tags each with connected_via (which X identity surfaced it).