Phone Finder
Find Single Phone
Find a single phone number from a LinkedIn URL or name and company with the Phone Finder API
POST
POST
Run an asynchronous search to find a phone number and the associated country. Authenticate every request with your API key in the
Option 2:
Additional:
x-api-key header.
The search needs to contain either:
- The URL of a person’s LinkedIn profile (e.g.,
https://www.linkedin.com/in/michael-scott/) - The combination of individual information:
firstname+lastname+ (company_nameorcompany_domain)
Request Body
Option 1 (Recommended):string
LinkedIn profile URL of the person.Note: Takes precedence over individual information if both are provided.
string
First name of the person
string
Last name of the person
string
Company domain (e.g.,
"dundermifflin.com")string
Company name (alternative to
company_domain)string
A custom value you can use to reference an internal ID. It will be present in the results.
object
Settings related to this search.
Response
201 — Single search created
string
Confirmation message
string
Unique identifier for this search. Use this to retrieve results via the GET endpoint.
number
Number of credits consumed (50 by default; may vary by plan). See Credits & billing for per-endpoint costs.
object
Credit breakdown
Error Responses
On insufficient credits (402), the response body is
{ "reason": "...", "success": false }. See Error handling for the full list of status codes and response formats.
Next steps
Get the result
Retrieve the found phone number using the search
id.Find phones in bulk
Run multiple phone searches in a single request.
Authentication
How to pass your API key in the x-api-key header.
Webhooks
Get notified automatically when a search completes.

