Use Steampipe to check emails and look up contact details by writing queries. A query is a question written in SQL, a language for working with data in tables. Tomba builds and maintains the plugin, which is the add-on that links Steampipe to Tomba.

This is a tool for technical users: you install it on your computer and type commands. If that's new to you, ask a developer to set it up. To check a list without any of this, use Bulks instead.

Before you start

You need your Tomba API key and secret. These are two private codes that let another app use your Tomba account.

Set up Steampipe

Step 1. Install Steampipe on your computer.

Step 2. Install the Tomba plugin, tomba-io/tomba. To see the install command, open Integrations in Tomba and select Connect on the Steampipe card, in the Others group. The plugin's page opens in a new tab.

The Others group on the Integrations page, with the Steampipe and Maltego names outlined and two cards marked Coming soon

Step 3. Open API Keys in Tomba and copy your key and secret. Your secret is in the Account secret row. For help, see How to find my API key?.

The API Keys page, with an arrow on the API Key & Secret column and show and copy icons beside each hidden value

Step 4. Add your key and secret to the plugin's settings file. The Tomba docs show exactly how.

Step 5. Run a query on one of the tables below.

What you can look up

Table	What it does	What you give it	Cost for each item
`tomba_verifier`	Checks an email	An email	1 verification credit
`tomba_enrich`	Adds details to an email	An email	1 search credit when found
`tomba_linkedin`	Finds an email from a LinkedIn link	A profile link	1 search credit when found
`tomba_author`	Finds a writer's email	An article link	1 search credit when found
`tomba_count`	Counts a company's emails	A website	1 email count credit
`tomba_account`	Shows your account details	Nothing	Free

You can combine these tables with your own lists. For example, you can check a list of emails and keep only the ones marked deliverable, which means mail should reach them.

💳 Credits: Each email, link or website in a query is a separate search. It costs the same as doing that search in Tomba.

⚠️ Important: A long list uses credits quickly. Checking 500 emails in one query can use 500 verification credits. Try a short list first.

⚠️ Important: tomba_account shows your API secret. If you share a Steampipe setup with other people, keep them away from this table.

Common questions

Can I list all the emails at a company?

No. Steampipe can count a company's emails, but it can't list them. Use Domain Search for that.

Does running the same query again use more credits?

Not within 5 minutes. By default, Steampipe keeps the results for that long. After that, repeating the same search before your credits reset is still free, except for tomba_count.

For developers: see the Tomba docs.

Steampipe integration