Skip to main content

Official Tomba API client for Ruby

See what a developer needs to connect Tomba to software written in Ruby.

Written by Tomba.io Team

Use this client when a developer wants to connect Tomba to software written in Ruby. A client is a ready-made code package that links your software to Tomba, so they don't have to build that link from scratch.

You don't need it to find or verify emails yourself. Search, Finder and Verify do that in your browser.

Before you start

Your developer needs two things:

  • Your API key and secret, the two values that tell Tomba the software is yours. See How to find my API key?.

  • Ruby 2.5 or later.

⚠️ Important: Keep your key and secret private. If they're shared by mistake, open API Keys and use Reset Key. The old key stops working right away. To replace the secret as well, see How to find my API key?.

Get the Ruby client

Step 1. Open Libraries, under API > Libraries.

Step 2. Find the Ruby card. You can type Ruby in Search libraries… to jump to it. The book icon on the card opens the developer guide.

The Libraries page with an arrow on the Search libraries box above the language cards

Step 3. Send your developer this install line: gem install tomba.

What it can do

Your developer can use these Tomba tools from your software:

  • Find emails: Domain Search, Email Finder and Author Finder

  • Check emails: Email Verifier

  • Find phones: Phone Finder and Phone Validator

  • Research companies: Similar Companies and Technology

  • Manage contacts: your Leads and lead lists

The Ruby client doesn't cover LinkedIn Finder, enrichment or Reveal.

💳 Credits: The client uses your plan's credits. Each lookup costs the same as in the app.

For developers: see the Ruby client docs.

Common questions

Can we use it on the Free plan?

Yes. The Free plan has 25 search credits and 0 verification credits, so you can try finding emails but not verifying them.

Why did it stop working?

The API key may have expired. Every key lasts 365 days at most, and Tomba emails the account owner 30 days, 7 days and 1 day before it ends. Open API Keys, use Reset & renew on the key, and give the new key to your developer.

How many lookups can it run?

Most plans set a limit per second, per minute and per day. See How many searches can I run per second, minute and day?.

Related articles

Did this answer your question?