Turn an X follower list into contacts you can actually email

Build me an app that turns an X audience into people I can actually contact. I have built a following on X, and I also watch a few competitor accounts, but right now those followers are just names on a platform I do not control. I want to work through an audience, decide who is worth reaching, and come away with real email addresses and CRM records.

The main screen starts with a single input where I type an X handle, mine or a competitor's. Next to it is a toggle for which slice of the audience to pull: verified followers only, using the TwitterAPI.io Get User Verified Followers operation, or every follower, using Get User Followers. Verified followers come back only 20 per page, so page deliberately in both modes. Load one page at a time behind a Load more button, show a running count of how many followers are loaded so far, and never try to pull an entire follower graph up front. Optionally, before any paging starts, use Get User Follower IDs to show me the true size of the audience, since that is the cheapest way to count followers without pulling profile data.

Show the loaded followers as a table, one row per person, with their avatar, display name, handle, bio, follower count, following count, location, and whether they carry a verified badge. Let me filter and sort the rows I have loaded so I can narrow to the ones who look like a fit: a minimum follower count, a keyword search across bios, verified only, and a location match. Every row has a checkbox, and I can select all rows currently passing my filters. Selection is the heart of the app, so keep the selected count visible at all times.

In the header, always show my remaining Datagma balance, read with the Get Credits operation. Refresh it after every batch. Before I run an enrichment, show me the selected row count next to the remaining balance so I can see whether the batch fits, and warn me when I have selected more people than I have credits for. Datagma only charges on a successful match, so present the batch size as an upper bound on what it could cost rather than a guaranteed charge.

The primary action is a Find contact details button that runs only against the rows I have actually ticked, never the whole follower list. For each selected person, call the Datagma Get Twitter Profile by Username operation with their X handle. That returns a linked email, other social profiles such as LinkedIn, Facebook, and GitHub, and professional details like job title and current company. Then, for anyone where the result gave me a name and a company but still no verified work address, follow up with the Datagma Find Work Email operation using their name plus the company domain or LinkedIn company slug. Run the batch with visible per-row progress.

Handle misses gracefully. Datagma returns a 200 response even when nothing is found, carrying a NOT_FOUND status or a code of 5, so treat those as a clean no match on that row rather than an error, and make clear that no credit was spent on them. Each row should always show one of three states: not yet enriched, enriched, or no match found.

Once a row is enriched, extend the table with the new columns: personal email, work email and which lookup produced it, LinkedIn URL, other social profiles, job title, and company. Add one more column that checks each person against my CRM using the HubSpot Search Contacts operation, matching on email where I have one and falling back to name where I do not, and label the row as already tracked or net new. Keep this a quiet supporting column rather than the centrepiece of the screen. The point of the app is turning followers into reachable contacts, and the CRM check is just context that stops me from working someone twice.

Give me two ways to get the worked list out. First, push selected net-new people into the CRM with the HubSpot Create Contact operation, mapping their first and last name, email, company, job title, and X handle, and writing their bio into the contact record for context. Second, export the full worked list to a spreadsheet with the Google Sheets Append Values operation, one row per person with every column shown on screen. After a push to HubSpot, flip those rows to already tracked so I can see at a glance what has landed.

Persist each audience I work as a saved list belonging to me, holding the handle I searched, the follower mode and filters I used, the followers loaded so far, my selections, and every enrichment result. Reopening a saved list should never re-spend credits on people I have already enriched. Different people using the app keep their own saved lists and see only their own.