Waterfalls - Databar Docs

Want to use waterfalls programmatically? Check out the Waterfalls API reference or use them directly from the MCP Server.

A waterfall chains multiple data providers together and tries them one by one until one returns a result. If the first provider has no data, the next is tried automatically. This continues down the chain until a provider succeeds or all have been exhausted. This gives you the highest possible data coverage from a single operation, without manually running and merging results from multiple sources.

Why use waterfalls

No single data provider covers every record. One service might find 60% of emails, another a different 50%, and a third might cover niche domains the others miss. Waterfalls automate the fallback logic so you define the provider order once and Databar handles the rest.

Available waterfalls

Databar ships several pre-built waterfalls. Each one is purpose-built for a specific enrichment use case.

The list of waterfalls and data providers below may not be fully up to date. We ship updates frequently and may have added new waterfalls or providers since this page was last updated. Check the enrichment panel in your table for the latest options.

Email by name

Find a work email address from a person’s name and the company they work at.Input

Parameter	Required	Description
First name	Yes	The first name of the person
Last name	Yes	The last name of the person
Company	Yes	The company name or website domain

Output

Field	Type
Email	Text

ProvidersSnov.io · Icypeas · Leadmagic · Datagma · Hunter.io · Prospeo · Findymail · RocketReach · People Data LabsThis waterfall supports email verification. When enabled, each found email is checked for deliverability before being accepted. If the email fails verification, the waterfall moves on to the next provider.

Email by name waterfall setup with first name, last name, and company inputs, and a verify email toggle with Emailable, Bouncer, and Zerobounce options

Email by link

Get work and personal email addresses from a social profile link (typically a LinkedIn URL).Input

Parameter	Required	Description
Link	Yes	A social profile URL (e.g. LinkedIn)

Output

Field	Type
First name	Text
Last name	Text
Work email	Text
Personal email	Text

ProvidersProspeo · Muraena · Findymail · Leadmagic · Pubrio · RocketReach · ContactOut · Forager · People Data LabsThis waterfall also supports email verification, with the same behavior as the Email by name waterfall.

Reverse email lookup

Enrich a person’s profile from their email address. Returns identity, job, and company information.Input

Parameter	Required	Description
Email	Yes	The email address of the person

Output

Field	Type
First name	Text
Last name	Text
LinkedIn URL	Text
Job title	Text
Country	Text
Company data	JSON
Education	JSON

ProvidersDiffbot · Snov.io · Datagma · Forager · People Data Labs · RocketReach

Phone

Get a phone number from a LinkedIn profile URL.Input

Parameter	Required	Description
LinkedIn	Yes	The LinkedIn profile URL of the person

Output

Field	Type
Phone	Text

ProvidersLeadmagic · Databar Labs · Pubrio · Prospeo · Upcell · Limadata · People Data Labs · Datagma · Forager · Findymail

Lookup company data

Get firmographic data about a company from its website URL, including employee count, funding, revenue, and industry.Input

Parameter	Required	Description
Company website	Yes	The website URL of the company

Output

Field	Type
Company name	Text
Description	Text
LinkedIn link	Text
Number of employees	Text
Address	JSON
Industries	Text
Est. revenue	Text
Funding	JSON

ProvidersDiffbot · Owler · Muraena · ContactOut · People Data Labs

Lookup company data waterfall setup showing company website input, automation settings, and run conditions toggle

Company URL finder

Resolve a company name to its website URL. Useful as a preparatory step before running other company-based waterfalls.Input

Parameter	Required	Description
Company name	Yes	The name of the company

Output

Field	Type
Company URL	Text

ProvidersDatabar APIs · People Data Labs

Job postings

Get active job listings from a company’s website, including titles, links, descriptions, and locations.Input

Parameter	Required	Description
Company website	Yes	The website URL of the company

Output

Field	Type
Job postings	JSON (title, link, description, location per posting)

ProvidersPredictLeads · Leadmagic

Setting up a waterfall

Adding a waterfall to your table works similarly to adding a single enrichment:

Add an enrichment

Click Enrich in the top-left corner of your table, then select Add a new Enrichment and switch to the Waterfalls tab.

Choose a waterfall

Select the waterfall you want to use. The setup sidebar will appear. Categories that include waterfalls are marked with a small waterfall icon.

Enrichment categories showing waterfall icons next to categories that have waterfalls available

Configure the waterfall setup

Click on Waterfall setup to expand the provider configuration. Here you can see all available data providers for this waterfall, each showing its name, logo, and credit cost.You can customize the waterfall in three ways:

Reorder providers by dragging the provider cards up or down. The order determines which provider is tried first.
Toggle providers on or off. Click a provider card to enable or disable it. Disabled providers are skipped during execution.
Add an email verifier (email waterfalls only). Toggle the “Verify email” switch and select a verification service.

Waterfall setup section showing provider icons and mapping inputs

Map input parameters

Under Mapping, map each required input parameter to a column in your table or enter a static value.

Run the waterfall

Click Run (or Install waterfall for new setups) to process your rows.

All standard table features work with waterfalls: run conditions, automations, cell-level statuses, and run strategies (run all, run empty, run single row).

Email verification

The Email by name and Email by link waterfalls support optional email verification. When enabled, each time a provider returns an email, the verifier checks its deliverability before the waterfall accepts it. If the email fails verification, the waterfall continues to the next provider instead of returning an undeliverable address. Available email verifiers:

Each verifier has its own credit cost, shown in the setup sidebar. You can choose whichever verifier you prefer.

When a provider returns an email that fails verification, the waterfall moves on to the next provider, but you are still charged for the successful run on the original provider. The provider did return a result; it just didn’t pass the verification step. Keep this in mind when estimating costs, as verification can increase the total credits consumed per row.

Provider ordering and cost optimization

Providers are tried from top to bottom. The waterfall stops at the first provider that returns a usable result. This means provider order directly affects your cost per lookup.

Place your cheapest or highest-coverage providers first. For example, if Provider A costs 1 credit and covers 40% of records while Provider B costs 3 credits and covers 70%, putting Provider A first means you only pay the higher price for the 60% of records that Provider A misses.

Using waterfalls headlessly

You can run waterfalls programmatically without a table using the REST API, Python SDK, CLI, or MCP server.

REST API
Python SDK
CLI
MCP Server

curl -X POST "https://api.databar.ai/v1/waterfalls/WATERFALL_ID/run" \
  -H "x-apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "first_name": "Jane",
      "last_name": "Doe",
      "company": "acme.com"
    }
  }'

See the full Waterfalls API reference for all endpoints.

from databar import DatabarClient

client = DatabarClient()
result = client.run_waterfall_sync(WATERFALL_ID, {
    "first_name": "Jane",
    "last_name": "Doe",
    "company": "acme.com"
})
print(result)

See the Python SDK docs for setup and additional methods.

For bulk runs, use the bulk endpoint to process multiple records in a single request.

Task data from headless runs is stored for 24 hours. Retrieve and save your results before they expire.

Enrichments

Learn how single-provider enrichments work

Waterfalls API

Browse and run waterfalls programmatically

Documentation Index

​Why use waterfalls

​Available waterfalls

​Setting up a waterfall

​Email verification

​Provider ordering and cost optimization

​Using waterfalls headlessly

​Related

Enrichments

Waterfalls API

Why use waterfalls

Available waterfalls

Setting up a waterfall

Email verification

Provider ordering and cost optimization

Using waterfalls headlessly

Related