# Phone number finder API for your agent Phone number finder API for an agent: it sends a LinkedIn profile URL, an email, or a name and a company domain to a catalog endpoint and reads phone number, line type and country code back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing. ## What this does 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. Example: https://www.linkedin.com/in/jane-doe-example. ## What differs between providers - Tomba (tomba-phone-finder): starts from an email, a LinkedIn URL or a domain, and returns international, local and E.164 formats with line type and carrier. - AI Ark (ai-ark-people-mobile-phone-finder): takes a LinkedIn URL, or a name with a domain, and returns null data when no person or no phone is found. - LeadMagic (leadmagic-people-mobile-finder): takes a profile URL, a work email or a personal email and returns the mobile number. - Aviato (aviato-person-phone): takes one identifier, such as an email, a LinkedIn URL or a Crunchbase id, and returns phone numbers with a score. - Findymail API documentation (findymail-api-search-phone): takes a LinkedIn URL and returns the phone and its line type, with no result for EU citizens. - Lusha (lusha-contacts-phone-find): takes a LinkedIn URL, an email, or a name with a domain, and is billed more when it finds a number than when it only matches the person. - Any Site API (anysite-api-phones-find): takes a LinkedIn URL and returns matches with a confidence level and how each was resolved. ## Before you start - 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. ## Prompt 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. ## Steps and providers - Find the phone number: tomba, ai-ark, leadmagic, aviato, findymail, lusha, anysite. 1 call per person. ## What comes back - Phone number - Line type - Country code and format - Carrier - Match confidence ## 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. - Tomba: {"endpointId":"tomba-phone-finder","input":{"linkedin":"https://www.linkedin.com/in/jane-doe-example"},"wait":30} - AI Ark: {"endpointId":"ai-ark-people-mobile-phone-finder","input":{"linkedin":"https://www.linkedin.com/in/jane-doe-example"},"wait":30} ## About calling rules looot returns data from providers and does not give legal advice. Check do-not-call lists and the rules for calling or messaging people in your market before you use a number. ## How do I find a phone number from a LinkedIn profile? 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. ## Can I find a phone number from an email address? Yes. Some providers take an email in place of a profile. Your agent reads each endpoint's parameters first, because the accepted inputs differ. ## Why is a phone lookup priced so much higher than an email lookup? Direct dials and mobiles are harder to source, so providers charge more for them. The live prices on this page show the spread, and the cheapest provider is not always the one with the best coverage. ## What does a result with no number mean? The provider matched nobody, or matched the person and holds no number. Some providers bill the second case at a lower rate. Your agent reports it as a miss and can move on to the next provider. ## Do these lookups work for people in Europe? Coverage varies. One provider returns nothing for EU citizens for legal reasons. Check the rules that apply to you before you call anyone from a purchased number. ## How much does one person cost? You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable. ## Do I pay when a phone number finder call fails? No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider. ## Do I need an account with each phone number finder provider? No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs. ## How do I call phone number finder from code? Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/. ## Can I run phone number finder on a schedule? That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results. ## Do I pay while my agent is idle? No. looot bills per call, and nothing runs while your agent is idle. ## Related pages - /use-cases/email-verification-api - /use-cases/find-professional-emails - /use-cases/enrich-a-person ## Last reviewed 2026-10-04. The cost per 1,000 person runs is read live from the catalog on the web page.