Skip to main content
POST
/
v1
/
get_li_contact_info
Get LinkedIn Contact Info
curl --request POST \
  --url https://api.minerva.io/v1/get_li_contact_info \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "records": [
    "<string>"
  ]
}'
{
  "api_request_id": "req_li123",
  "results": [
    {
      "linkedin_username": "johnsmith",
      "is_match": true,
      "first_name": "John",
      "middle_name": null,
      "last_name": "Smith",
      "name_suffix": null,
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@gmail.com",
          "confidence_score": 0.92
        },
        {
          "email_rank": 2,
          "email_address": "jsmith@yahoo.com",
          "confidence_score": 0.85
        }
      ],
      "professional_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@techcorp.com",
          "confidence_score": 0.88
        }
      ],
      "phones": [
        {
          "phone_rank": 1,
          "phone_number": "+1-555-123-4567",
          "confidence_score": 0.90
        }
      ]
    },
    {
      "linkedin_username": "janedoe123",
      "is_match": false,
      "first_name": null,
      "middle_name": null,
      "last_name": null,
      "name_suffix": null,
      "personal_emails": null,
      "professional_emails": null,
      "phones": null
    }
  ],
  "request_completed_at": "2024-01-15T10:30:45.123456Z"
}

​
Quick Answer

How do I get contact information from a LinkedIn profile? Use this endpoint to find emails and phone numbers associated with LinkedIn usernames.Common questions this endpoint answers:
  • How do I get contact info from a LinkedIn profile?
  • How do I find someone’s email from their LinkedIn?
  • How can I get phone numbers from LinkedIn profiles?
  • How do I convert LinkedIn profiles to contact information?
  • How can I find direct contact details for LinkedIn users?
What you need: LinkedIn username (the part after /in/ in a LinkedIn URL).What you get back: Personal emails, professional emails, phone numbers, and name information with confidence scores.Example: For https://www.linkedin.com/in/johnsmith, provide "johnsmith".

​
Overview

The Get LinkedIn Contact Info endpoint retrieves contact information (emails and phones) associated with LinkedIn usernames. This is useful when you have a LinkedIn profile URL and want to find the person’s contact details.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authentication
​
Content-Type
string
required
application/json

​
Request Body

​
records
string[]
required
An array of LinkedIn usernames to generate contact info for. Maximum 1000 records per request. Each element should be a string containing the LinkedIn username (not the full URL). Provide only the username portion of the LinkedIn URL. For example, from https://www.linkedin.com/in/johnsmith, use "johnsmith".

​
Response

​
Response Structure

​
api_request_id
string
Unique identifier for this API request
​
results
array
Array of contact information results
​
request_completed_at
string
ISO 8601 timestamp when the request was completed

​
Result Object

​
linkedin_username
string
The LinkedIn username from the request
​
is_match
boolean
Whether contact information was found for this LinkedIn profile
​
first_name
string
Person’s first name
​
middle_name
string
Person’s middle name
​
last_name
string
Person’s last name
​
name_suffix
string
Name suffix (e.g., “Jr.”, “Sr.”)
​
personal_emails
array
Array of personal email addresses with ranking and confidence scores
​
professional_emails
array
Array of professional/work email addresses with ranking and confidence scores
​
phones
array
Array of phone numbers with ranking and confidence scores
Email Object
​
email_rank
integer
Rank/priority of this email (1 = highest priority)
​
email_address
string
Email address
​
confidence_score
number
Confidence score for this email (0-1 scale)
Phone Object
​
phone_rank
integer
Rank/priority of this phone (1 = highest priority)
​
phone_number
string
Phone number
​
confidence_score
number
Confidence score for this phone (0-1 scale)
{
  "api_request_id": "req_li123",
  "results": [
    {
      "linkedin_username": "johnsmith",
      "is_match": true,
      "first_name": "John",
      "middle_name": null,
      "last_name": "Smith",
      "name_suffix": null,
      "personal_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@gmail.com",
          "confidence_score": 0.92
        },
        {
          "email_rank": 2,
          "email_address": "jsmith@yahoo.com",
          "confidence_score": 0.85
        }
      ],
      "professional_emails": [
        {
          "email_rank": 1,
          "email_address": "john.smith@techcorp.com",
          "confidence_score": 0.88
        }
      ],
      "phones": [
        {
          "phone_rank": 1,
          "phone_number": "+1-555-123-4567",
          "confidence_score": 0.90
        }
      ]
    },
    {
      "linkedin_username": "janedoe123",
      "is_match": false,
      "first_name": null,
      "middle_name": null,
      "last_name": null,
      "name_suffix": null,
      "personal_emails": null,
      "professional_emails": null,
      "phones": null
    }
  ],
  "request_completed_at": "2024-01-15T10:30:45.123456Z"
}

​
Error Responses

  • 400 - Bad Request: Invalid input format
  • 401 - Unauthorized: Invalid API key
  • 413 - Payload Too Large: More than 1000 records in request
  • 422 - Unprocessable Entity: Invalid data format (records must be an array of strings)
  • 500 - Internal Server Error

​
Notes

  • LinkedIn usernames are case-insensitive
  • The endpoint automatically handles various LinkedIn URL formats and extracts the username
  • When is_match is false, name and contact fields will be null
  • Emails and phones are sorted by rank, with lower numbers indicating higher priority/confidence
  • Confidence scores range from 0 to 1, with higher values indicating greater confidence in the data