Use case, Phone number finder

Phone number finder API for your agent. One call per person.

Send a LinkedIn profile URL, an email, or a name and a company domain. Read phone number and line type back. Your agent picks the provider, and you pay per call.

Give this to your agent
set up looot - https://looot.ai/skill.md

The job

What the Phone number finder API gives your agent

A phone lookup starts from something you already know about a person, such as a LinkedIn profile or a work email, and returns a number. It is the most expensive lookup in the contact family, and the price spread across providers is wide.

That makes the order of attempts matter. Some providers return only a mobile number, some return every number they hold, and some return nothing for people in the EU. Your agent can ask the cheapest provider first and try the next one only when the first has no match.

You give

a LinkedIn profile URL, an email, or a name and a company domain

https://www.linkedin.com/in/jane-doe-example

You get

  • Phone number
  • Line type
  • Country code and format
  • Carrier
  • Match confidence

Sample calls

The request and what comes back

Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.

Request
{"endpointId":"tomba-phone-finder","input":{"linkedin":"https://www.linkedin.com/in/jane-doe-example"},"wait":30}
ResponseSample output
// POST /v1/runs, then read run.status and run.result
// result: starts from an email, a LinkedIn URL or a domain, and returns international, local and E.164 formats with line type and carrier

The prompt

Copy one prompt, give it to your agent.

Edit the names and numbers, paste it, and the agent runs the job and shows the cost.

  • One run is one person.
  • 1 steps across 7 providers.
  • Runs on demand, whenever you ask.
Prompt: Phone number finder API
Use looot to find a direct phone number for https://www.linkedin.com/in/jane-doe-example and tell me whether it is a mobile or a landline. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

Give this to your agent
Setup command
set up looot - https://looot.ai/skill.md

Before you start

Settle these before the first run

  • Know the region you call. One provider here returns no result for EU citizens for legal reasons, and others hold thinner data outside the US.
  • Respect do-not-call flags. One provider returns a doNotCall field, and your agent should keep it with the number.
  • A number that is found is billed. A lookup that matches nobody is often free, but the rules differ per provider, so read the endpoint page for the exact charge.

FAQ

Questions people ask

Send the profile URL to a phone-finder endpoint. Several providers here accept it. Use the vanity alias in the URL, not the numeric id. The answer is a number with a line type, or an empty result.

For agents
use case
Phone number finder API
run
person
schedule
on demand
step
Find the phone number: tomba ai-ark leadmagic aviato findymail lusha anysite
setup
https://looot.ai/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04
markdown /use-cases/find-phone-numbers.md

Try Phone number finder with your own agent.

Start your workspace, top up, and paste the prompt into the agent you already use.

Start your workspace See agent recipes