Get Converted Leads Summary (Smart Leads aggregates)
get_converted_leads_summaryFast aggregate summary of the account's converted leads (Smart Leads) — counts and rates only, no lead rows.
ALSO KNOWN AS: leads summary, lead totals, lead overview, MQL rate, lead-to-MQL conversion, smart leads summary.
KEYWORDS: LEAD COUNT, LEAD TOTALS, HOW MANY LEADS, LEADS SUMMARY, LEAD OVERVIEW, SMART LEADS, CONVERTED LEADS, MQL RATE, LEAD-TO-MQL, MQLS, UNIQUE LEADS, UNIQUE DOMAINS, LEAD CHANNEL MIX, LEADS BY CHANNEL, ENRICHMENT COVERAGE, SYNCED TO MARKETING AUTOMATION, LEAD QUALITY BASELINE, LEAD AUDIT BASELINE, PIPELINE FROM LEADS, TRIGGERED OPPORTUNITIES, INFLUENCED OPPORTUNITIES, LEAD SANITY CHECK
USE FOR: "How many leads do we have?", MQL rate and lead-to-MQL sanity checks, channel mix of leads (Facebook/Instagram/LinkedIn/Google Ads/display), enrichment coverage, leads synced to marketing automation, unique leads vs unique company domains, pipeline tie-back (triggered/influenced opportunities and amounts). ALWAYS call this FIRST in a lead audit to set the baseline before pulling rows with get_converted_leads.
NOT FOR: Inspecting individual leads or job-title/ICP distributions (use get_converted_leads); campaign performance metrics (use experiment_performance_stats).
RETURNED DATA: total | totalFacebook, totalInstagram, totalLinkedin, totalGoogleAds | fullyEnriched, autoEnriched, unenriched | syncedToMa | uniqueLeads, uniqueDomain | mqls, uniqueMqls, mqlRate, uniqueMqlRate | influencedOpps, triggeredOpps, influencedAmount, triggeredAmount.
RULES:
Accepts the same filters as get_converted_leads (no pagination/sort) — scope by campaignName/channels/startDate+endDate to summarize a slice.
mqlRate is a useful lead-quality indicator, but clients define MQL criteria differently and it rarely matches a true MQL — treat it as a secondary signal next to job-title/ICP fit.
uniqueDomain vs total shows lead concentration: many leads from few domains can mean a few companies dominate the results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Restrict the summary to specific lead IDs. | |
| No | Filter by lead email (partial match). | ||
| adName | No | Filter by the ad (library) name that captured the leads (partial match). | |
| syncMA | No | true = only leads synced to marketing automation; false = only unsynced. | |
| tagIds | No | Filter by tag IDs on the leads' experiments. | |
| endDate | No | Leads created on/before this date. ISO 8601; date-only is accepted. | |
| keyword | No | Filter by the exact search keyword that captured the leads. | |
| channels | No | Filter by acquisition channel(s). | |
| jobTitle | No | Filter by lead job title (partial match). | |
| lastName | No | Filter by lead last name (partial match). | |
| statuses | No | Lead statuses to include. The platform Leads tab defaults to ACTIVE. Omit to include all. | |
| companies | No | Filter by exact company names. | |
| countries | No | Filter by exact lead country names. | |
| firstName | No | Filter by lead first name (partial match). | |
| offerName | No | Filter by the offer name tied to the leads' experiments. | |
| startDate | No | Leads created on/after this date. ISO 8601; date-only is accepted. | |
| matchTypes | No | Filter by keyword match type (search channels). | |
| modifiedBy | No | Filter by the platform user email who last modified the leads (partial match). | |
| campaignName | No | Filter by campaign name (partial match). | |
| contentTypes | No | Data-completeness filter: only leads that HAVE this content. | |
| qualityTypes | No | Quality-signal filter (opportunities, MQL date/score). | |
| audienceTypes | No | Filter by audience type of the leads' experiments (e.g. FIRMOGRAPHIC_INCLUDE, CONTACT_LIST, BUYER_INTENT, NATIVE_LINKEDIN). | |
| isAutoUpdated | No | true = only auto-enriched leads. | |
| businessEmails | No | Filter by exact business email addresses (OR within the list). | |
| experimentName | No | Filter by experiment name (partial match). | |
| isFullyEnriched | No | true = only fully enriched leads; false = only not fully enriched. | |
| isManuallyUpdate | No | true = only manually enriched/edited leads (platform parameter name is 'isManuallyUpdate'). | |
| customAudienceName | No | Filter by targeted audience name (partial match). |