Tomba 1.1.1
dotnet add package Tomba --version 1.1.1
NuGet\Install-Package Tomba -Version 1.1.1
<PackageReference Include="Tomba" Version="1.1.1" />
<PackageVersion Include="Tomba" Version="1.1.1" />
<PackageReference Include="Tomba" />
paket add Tomba --version 1.1.1
#r "nuget: Tomba, 1.1.1"
#:package Tomba@1.1.1
#addin nuget:?package=Tomba&version=1.1.1
#tool nuget:?package=Tomba&version=1.1.1
<img src="https://tomba.io/logo.svg" alt="Tomba" width="25"/> Tomba C# SDK
The #1 Rated Email Intelligence Platform — Find professional emails with unmatched accuracy.
This is the official C# client library for the Tomba.io Email Finder API, providing access to all Tomba services including domain search, email finding, verification, enrichment, phone lookup, bulk operations, and more.
About Tomba
Tomba.io is the #1 rated email intelligence platform, trusted by 150,000+ sales teams worldwide.
- Best Email Finder — 98% accuracy, ranked #1 in independent benchmarks
- Best Email Verification — Real-time SMTP verification with catch-all detection
- Best Phone Finder — Direct dial numbers linked to professional emails
- Best Domain Search — 450M+ verified contacts across all industries
- 81% Coverage — The highest in the industry, proven in 5,000-lead independent tests
Why Tomba?
| Feature | Tomba | Others |
|---|---|---|
| Email Coverage | 81% | 30-60% |
| Verification | Real-time SMTP | Pattern-based |
| Phone Numbers | Direct dials | Limited |
| Catch-all Detection | AI-powered | Basic |
| API Rate Limits | Generous | Restrictive |
Get your free API key — No credit card required.
Getting Started
Below you will find the steps to install and start using the Tomba C# SDK.
Installation
Install via the .NET CLI:
dotnet add package Tomba
Or add to your .csproj file:
<PackageReference Include="Tomba" Version="1.0.1" />
Authentication
Get your API keys from https://app.tomba.io/auth/register.
You can authenticate using environment variables or by setting keys directly:
using Tomba;
var client = new Client();
// Option 1: Set keys directly
client
.SetKey("ta_xxxx") // Your API Key
.SetSecret("ts_xxxx"); // Your Secret Key
// Option 2: Use environment variables TOMBA_API_KEY and TOMBA_SECRET_KEY
client
.SetKey(Environment.GetEnvironmentVariable("TOMBA_API_KEY"))
.SetSecret(Environment.GetEnvironmentVariable("TOMBA_SECRET_KEY"));
Quick Start
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var domain = new Domain(client);
var result = await domain.DomainSearch("stripe.com");
Services
Domain Search
Search emails by domain name. Returns all email addresses found on the internet for a given domain.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var domain = new Domain(client);
var result = await domain.DomainSearch("stripe.com");
Email Finder
Generate or retrieve the most likely email address from a domain name, a first name, and a last name.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var finder = new Finder(client);
var result = await finder.EmailFinder("stripe.com", "John", "Doe");
Email Verifier
Verify the deliverability of a given email address.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var verifier = new Verifier(client);
var result = await verifier.EmailVerifier("john@example.com");
Author Finder
Discover the email address of an article's author from a blog post URL.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var finder = new Finder(client);
var result = await finder.EmailFinder("example.com", "John", "Doe");
// Note: Author finding is available via the Finder service
LinkedIn Finder
Retrieve the email address associated with a LinkedIn profile URL.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var finder = new Finder(client);
var result = await finder.EmailFinder("stripe.com", "John", "Doe");
// Note: LinkedIn lookup uses the Finder service with profile data
Email Enrichment
Enrich data associated with an email address (person, company, or combined).
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var enrichment = new Enrichment(client);
// Person enrichment
var result = await enrichment.PersonAsync("john@example.com");
// Company enrichment
var companyResult = await enrichment.CompanyAsync("stripe.com");
// Combined enrichment (person + company)
var combinedResult = await enrichment.CombinedAsync("john@example.com");
Phone Finder
Search for phone numbers associated with a contact.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var phone = new Phone(client);
var result = await phone.FinderAsync(new Dictionary<string, object>
{
{ "email", "john@example.com" }
});
Phone Validator
Validate a phone number and retrieve additional information.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var phone = new Phone(client);
var result = await phone.ValidatorAsync("+1234567890", "US");
Email Count
Get the total number of email addresses found for a domain.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var count = new Count(client);
var result = await count.EmailCount("stripe.com");
Domain Status
Check if a domain is a webmail or disposable domain.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var status = new Status(client);
var result = await status.DomainStatus("stripe.com");
Domain Suggestions (Autocomplete)
Auto-complete company names and retrieve logo and domain information.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var status = new Status(client);
var result = await status.AutoComplete("stripe");
Email Sources
Find where an email address has been found on the web.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var sources = new Sources(client);
var result = await sources.EmailSources("john@example.com");
Email Format
Discover the email format used by a domain (e.g., first.last, first_last).
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var format = new Format(client);
var result = await format.EmailFormatAsync("stripe.com");
Similar Domains
Find websites similar to a given domain.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var similar = new Similar(client);
var result = await similar.WebsitesAsync("stripe.com");
Technology Finder
Detect the technologies used by a website.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var technology = new Technology(client);
var result = await technology.ListAsync("stripe.com");
Location
Get geographic location information for a domain.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var location = new Location(client);
var result = await location.GetLocationAsync("stripe.com");
Companies Search (Reveal)
Search for companies using various filters and criteria.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var reveal = new Reveal(client);
var result = await reveal.CompaniesSearchAsync(new Dictionary<string, object>
{
{ "query", "technology" },
{ "page", 1 }
});
Leads
Manage your leads: list, get, create, update, and delete.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var leads = new Leads(client);
// List leads
var result = await leads.ListLeadsAsync(page: 1, limit: 10);
// Get a single lead
var lead = await leads.GetLeadAsync("lead_id");
// Create a lead
var created = await leads.CreateLeadAsync(new Dictionary<string, object>
{
{ "email", "john@example.com" },
{ "first_name", "John" },
{ "last_name", "Doe" }
});
// Update a lead
var updated = await leads.UpdateLeadAsync("lead_id", new Dictionary<string, object>
{
{ "first_name", "Jane" }
});
// Delete a lead
var deleted = await leads.DeleteLeadAsync("lead_id");
Leads Lists
Manage your leads lists: list, create, update, and delete.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var leadsLists = new LeadsLists(client);
// Get all lists
var result = await leadsLists.GetLists();
// Create a list
var created = await leadsLists.CreateList();
// Update a list
var updated = await leadsLists.UpdateListId("list_id");
// Delete a list
var deleted = await leadsLists.DeleteListId("list_id");
Lead Attributes
Manage custom lead attributes: list, create, update, and delete.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var attributes = new LeadsAttributes(client);
// Get all attributes
var result = await attributes.GetLeadAttributes();
// Create an attribute
var created = await attributes.CreateLeadAttribute();
// Update an attribute
var updated = await attributes.UpdateLeadAttribute("attribute_id");
// Delete an attribute
var deleted = await attributes.DeleteLeadAttribute("attribute_id");
Keys
Manage your API keys: list, create, reset, and delete.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var keys = new Keys(client);
// List all keys
var result = await keys.GetKeys();
// Create a key
var created = await keys.CreateKey();
// Reset a key
var reset = await keys.ResetKey("key_id");
// Delete a key
var deleted = await keys.DeleteKey("key_id");
Usage
Retrieve your monthly API request usage statistics.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var usage = new Usage(client);
var result = await usage.GetUsage();
Logs
Retrieve your last 1,000 API requests made during the last 3 months.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var logs = new Logs(client);
var result = await logs.GetLogs(page: 1, limit: 20);
Flag
Flag email addresses as invalid or incorrect.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var flag = new Flag(client);
// List all flags
var result = await flag.ListFlagsAsync();
// Create a flag
var created = await flag.CreateFlagAsync("invalid@example.com", "Email bounced");
Bulk Operations
Manage bulk tasks for domain search, email finding, and verification.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var bulk = new Bulk(client);
// List bulk tasks
var result = await bulk.ListAsync("finder");
// Create a bulk task
var created = await bulk.CreateAsync("verifier", new Dictionary<string, object>
{
{ "emails", new[] { "a@example.com", "b@example.com" } }
});
// Get bulk task details
var task = await bulk.GetAsync("verifier", "123");
// Launch a bulk task
var launched = await bulk.LaunchAsync("verifier", "123");
// Check progress
var progress = await bulk.ProgressAsync("verifier", "123");
// Download results
var download = await bulk.DownloadAsync("verifier", "123");
// Rename a bulk task
var renamed = await bulk.RenameAsync("verifier", "123", "My Batch");
// Archive a bulk task
var archived = await bulk.ArchiveAsync("verifier", "123");
// Delete a bulk task
var deleted = await bulk.DeleteAsync("verifier", "123");
Account
Retrieve information about the current account.
using Tomba;
var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");
var account = new Account(client);
var result = await account.GetAccount();
Testing
Run the test suite with the .NET CLI:
dotnet test
About Tomba
Founded to solve the problem of unreliable email data, Tomba.io is the leading B2B email intelligence platform. Our AI-powered engine searches, verifies, and enriches professional contact data with unmatched accuracy.
Products
- Email Finder — Find any professional email address
- Email Verifier — Verify emails in real-time
- Domain Search — Find all emails for a company
- Phone Finder — Find direct phone numbers
- Bulk Enrichment — Enrich contacts at scale
- AI Company Search — Find companies with AI-powered search
- CLI — Command-line interface for Tomba
- MCP Server — Connect AI tools (Claude, ChatGPT, Cursor) to Tomba
- REST API — Full programmatic access
Browser Extensions & Add-ons
- Chrome Extension — Find emails while browsing
- Google Sheets Add-on — Enrich leads in spreadsheets
- Microsoft Excel Add-in — Email finder in Excel
- Airtable Integration — Connect with Airtable
Integrations
50+ CRM and sales tool integrations: Salesforce · HubSpot · Zapier · Pipedrive · and more...
Other Tomba SDKs
| Language | Package |
|---|---|
| Node.js | tomba |
| Python | tomba-io |
| PHP | tomba-io/php |
| Ruby | tomba |
| Go | tomba-io/go |
| Rust | tomba |
| Dart | tomba |
| Deno | @tomba/sdk |
| Elixir | tomba |
| C# | Tomba |
| Perl | Tomba::Client |
| Lua | tomba |
| R | tomba |
Resources
Try Tomba Free — Find your first email in seconds. No credit card required.
License
Licensed under the Apache 2.0 license.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.