User GuideHow DataDirector works
Ask questions in plain English. The AI selects the right tools, queries live voter data, and returns counts, tables, charts, and exports — all within your account.
How it works
From question to insight in seconds
Type your question
Ask in plain English — no jargon required. Say 'How many active Democrats are in Jefferson County?' or 'Show voters aged 30–50 who voted in 2024 but not 2022.'
AI interprets intent
DataDirector reads your query, identifies the right filters — party, geography, voting history — and confirms its plan before running anything.
Data runs in real-time
Your query executes against live voter data. Read-only access means your records are never changed. Results stream back in seconds.
Act on the results
View counts, tables, and charts. Drill down with follow-up questions. Export a CSV or save the audience when you're ready to act.
See it in action
Click a tool to preview its output
These are the quick-action buttons you'll find in every chat session. Click any one to see what it returns.
Click a tool to preview its output
Colorado Elected Officials
Example queries
Copy, paste, or adapt these to get started
These are real queries the AI understands. Try them exactly as written, or adjust them for your race.
Location & Geography
Party & Affiliation
Voting History
Demographics
Scores & Predictions
Export & Action
Quick actions
One-click tools in the chat toolbar
These appear in the toolbar at the bottom of every chat. Some are always available; others activate once you have voter data in the conversation. Click any card to see what it does and get an example prompt to try.
Always available
· click any card to expandAvailable after querying voter data
AI tools
What runs under the hood
DataDirector automatically selects and chains these tools based on your question. You don't invoke them directly — but knowing what they do helps you phrase requests for better results.
Plan Query
Runs first on every natural-language question. Parses your intent, normalizes location names, maps party terms, and translates everything into precise database filter configurations before any data is touched.
Query Voter Data
Executes the database query after planning. Returns counts, paginated record sets, or aggregate groupings depending on what you asked for. All reads — never writes.
Verify Data
Checks schema availability before a query runs — total record count, available states, represented parties, and demographic range. Prevents errors from querying fields that don't exist.
Get Field Values
Returns all unique values for a specific field. Used when the AI needs to enumerate options — e.g., all county names, all party codes, or all city spellings — to confirm your filters are valid.
Analyze Audience (tool)
Runs cross-tabulations, demographic breakdowns, age distributions, and party analyses against your filtered voter set. Powers the Analyze Audience quick action and any follow-up analysis requests.
Compare Audience (tool)
Pulls population baselines and computes how your audience differs from the broader voter pool. Used by the Compare quick action and any phrasing like 'how does this group compare to...'
Charts & Graphs (tool)
Generates chart data for gender, age, party, and voting history distributions. Renders results inline in the chat. Triggered by the Charts quick action or any request to visualize data.
Export Voter Data (tool)
Streams a CSV export of filtered voter records to your browser. Supports full-record format and phone bank format (12 columns optimized for dialing programs).
Phone Bank (tool)
Builds a calling list from the current audience — filters, sorts by cell reliability, and returns contact details. Powers the Phone Numbers quick action.
Explore Data (tool)
Runs a multi-dimensional overview of the voter file along a dimension you specify — geography, party, age, turnout — without requiring a precise filter query.
Political Context (tool)
Fetches current officeholder data for your state and district — crawls official sources to return accurate federal and state representative information in real time.
Political Climate (tool)
Aggregates national and local political context — recent results, key issues, and cycle-level trends — to inform strategy conversations and audience targeting decisions.
Data fields
197 fields — everything in your voter file
You don't need to know field names — describe what you want in plain English. Click any category to expand it.
Pro tips
Get more precise answers by adding context
Be specific about location
"Arapahoe County" works better than "east Denver area." Use city names, county names, zip codes, or district numbers like "CD-6" or "SD-19."
Specify voter status
Say "active voters" to exclude inactive registrations. By default, results may include both active and inactive voters depending on the query.
Reference elections by year and type
Say "2024 General," "2022 midterms," or "2020 Presidential Primary" — not just "recent election" or "last time." The AI needs specifics to filter correctly.
Chain follow-up questions
After a count, ask "now show me the breakdown by age" or "who among those voted in 2024?" The AI retains full context across the conversation.
Start broad, then narrow
"How many Democrats are in Jefferson County?" → "Of those, how many voted in 2024?" → "Export that list." Incremental queries get better results than complex one-shots.
Add context for strategy tools
Campaign Strategist and Political Climate work best when you tell them what you need: "I'm running in CD-6 targeting Unaffiliated voters, help me think through a turnout strategy."
Ready to get started?
See our plans and start querying voter data today.