Skip to main content
Enrichments

Waterfall Personal Email Finder

post/v1/enrichments/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Use a standard public LinkedIn profile URL to find a personal email address. Sales Navigator URLs are not supported.

Public ID: waterfall-personal-email-finder. Get the current definition. You can read it without authentication. Check availability in the catalog.

Settings​

No public settings are currently required. Submit an empty settings object. Check the current definition before adding settings.

Additional properties are supported.

Inputs​

Give each input an inputId you can use to match the result to your record. Put profileUrl in its data object.

profileUrlstringrequired

Public LinkedIn profile URL, such as https://www.linkedin.com/in/example/. Sales Navigator URLs are not supported.

Additional properties are supported.

Outputs​

Each result contains your inputId, a status, the data in outputs, and creditsUsed. If the input failed, error explains why; otherwise it is null.

The fields below depend on your settings and the data found. Results can include fields not yet listed in the catalog.

emailFoundstringrequired

Email Found

format: "email"

Additional properties are supported.

Credits and limits​

Cost: 75 credits per email found

The standard price is 75 credits per personal email found. Usage depends on the result and is reported in creditsUsed. creditsPerInput: null does not mean the task is free.

Send 1–10,000 inputs per task, within 16 KiB per input and 10 MiB per request. Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days.

You can set maxCredits to stop starting new work after a credit threshold. Work already underway can still exceed it. Enrichment and source tasks share your account balance and task limits. See limits and errors.

Accepted task and results​

The API returns 202 Accepted with a task ID. Save it, then check links.self every few seconds. Once status is completed, failed, or stopped, read links.results. Failed and stopped tasks can still have useful results. See the task reference.

Example results (sample data and credit amounts):

json
{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "inputId": "row-1",
      "status": "success",
      "outputs": {
        "emailFound": "jane@example.net"
      },
      "creditsUsed": "75",
      "error": null
    }
  ],
  "nextCursor": null
}

If nextCursor is not null, pass it unchanged in the next request to get more results. Pages default to 50 results; limit accepts 1–100. A page is at most 128 KiB, so it may contain fewer results than requested.