Turn a natural-language audience brief into a clean, exportable prospect or business list.
$ARGUMENTS is a free-text description of the audience. Parse it for:
Example phrasings: “100 VP Engineering at Series B SaaS in the US that use Snowflake”, “heads of demand gen at 200-1000 fintech in NYC”, “50 CFOs at public manufacturing that raised funding in the last 90 days”, “cybersecurity under 500 employees in the UK with intent on zero trust”.
Decide list type. Prospects if the brief names person attributes (title, seniority, department). Businesses if only company attributes are named. If prospects are scoped by a prior company set, plan to thread that businesses table into the prospect fetch.
Discover canonical values. For every free-text field (industry, technology, job title, intent topic, city region), resolve the user’s phrase to the standardized value the API expects. Skip discovery for ISO country codes, region codes, bucket enums (size, revenue, age), seniority and department enums, and boolean flags.
Tighten loose title filters. Title filters are not enforced as exact-match: a job-title-only filter for “Vice President of Engineering” can return non-VP rows. Always combine a title with a seniority value (e.g. “vice president”) to keep the slice tight.
Size the audience. Get a total match count for the assembled filters before pulling rows. Use this number to frame the preview honestly and to warn the user early if the audience is unexpectedly small or massive.
Sample-first preview. Pull a small slice (5 rows) and render it for the user to sanity-check the filter translation before materializing the full list. The interactive preview is hard-capped at 5 rows: treat it as a sanity sample, not as the ranked top-N.
Pull the full list. Once the preview is approved, materialize the requested count via the paid export path. Restate the audience definition so the user can see what locked in.
Enrich the rows. For prospects, default to email-only contact enrichment (cheaper); add phone only when the user explicitly asks for it (e.g. dialer flows). Add profile data for LinkedIn URL and bio when requested. Prospect-side LinkedIn post content is NOT available: for recent activity, enrich LinkedIn posts on the employer instead. For businesses, layer in firmographics, technographics, funding, workforce trends, competitive landscape, ratings, or strategic insights based on the fields the user asked for.
Output as a table artifact with the CSV path called out so the user can download or pipe it onward.
Bulleted readout of every filter that landed: entity type, title and seniority, department, industry, size and revenue buckets, geography, tech stack, intent topics, growth events with their recency window, and any boolean flags. Call out any requested filter that had no direct equivalent and how it was approximated.
Show when entity type is prospects. Columns: name, job title, company, company domain, industry, company size, email (professional preferred), phone if pulled, LinkedIn URL, prospect_id. Drop columns the user did not ask for. Caveat: email and phone only populate after contact enrichment; the discovery preview returns identifiers only.
Show when entity type is businesses. Columns: company name, domain, industry, headcount, revenue bucket, country/region, plus any enrichment columns requested (tech stack, recent funding, hiring trend), business_id.
Total matching audience from step 4, rows returned in this pull, path to the CSV artifact, enrichment coverage (e.g. “92 of 100 rows have a verified email”). Frame as “Sample preview (5 of
Concrete next moves: tighten or broaden a bucket, add a reachability filter, swap geography granularity, layer a recent-event filter, pivot from businesses to prospects by reusing the current business table, add or remove an enrichment.