GET
/
api
/
enrich
/
contacts
curl --request GET \
  --url https://search.linkd.inc/api/enrich/contacts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "contacts": [
        {
          "type": "email",
          "value": "[email protected]",
          "subType": "work"
        },
        {
          "type": "email",
          "value": "[email protected]",
          "subType": "personal"
        },
        {
          "type": "phone",
          "value": "+1 555-123-4567",
          "subType": "mobile"
        }
      ],
      "social": [
        {
          "type": "li",
          "link": "https://www.linkedin.com/in/john-doe-12345678",
          "rating": "100"
        },
        {
          "type": "fb",
          "link": "https://www.facebook.com/johndoe",
          "rating": "100"
        }
      ]
    }
  ]
}

Retrieve contact information including email addresses and phone numbers for any profile. This endpoint accepts a LinkedIn URL, email address, or phone number as input and returns all available contact methods.

​
Get Contact Information

curl -X GET "https://search.linkd.inc/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/johndoe" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Query Parameters

Exactly one of the following parameters must be provided:

ParameterTypeRequiredDescription
linkedin_urlstringNoLinkedIn profile URL to look up
emailstringNoEmail address to search for
phonestringNoPhone number to search for

​
Examples

Search by LinkedIn URL:

curl -X GET "https://search.linkd.inc/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/johndoe" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search by Email:

curl -X GET "https://search.linkd.inc/api/enrich/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search by Phone:

curl -X GET "https://search.linkd.inc/api/enrich/contacts?phone=%2B1-555-123-4567" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "contacts": [
        {
          "type": "email",
          "value": "[email protected]",
          "subType": "work",
          "rating": "95"
        },
        {
          "type": "email", 
          "value": "[email protected]",
          "subType": "personal",
          "rating": "90"
        },
        {
          "type": "phone",
          "value": "+1 555-123-4567",
          "subType": "mobile",
          "rating": "92"
        }
      ],
      "social": [
        {
          "type": "li",
          "link": "https://www.linkedin.com/in/john-doe-12345678",
          "rating": "100"
        },
        {
          "type": "fb",
          "link": "https://www.facebook.com/johndoe",
          "rating": "85"
        },
        {
          "type": "tw",
          "link": "https://www.twitter.com/johndoe",
          "rating": "80"
        }
      ]
    }
  ]
}

​
Response (No Contacts Found)

{
  "data": [
    {
      "contacts": [],
      "social": []
    }
  ]
}

​
Response (Error)

{
  "data": [
    {
      "error": true,
      "message": "Error retrieving contact information",
      "details": "No LinkedIn profile found for email: [email protected]"
    }
  ]
}

​
Response Fields

​
Contact Object

FieldTypeDescription
typestringType of contact (“email” or “phone”)
valuestringThe actual contact value
subTypestringSubtype (“work”, “personal”, “mobile”, etc.)
ratingstringConfidence rating (0-100) for the contact accuracy

​
Social Object

FieldTypeDescription
typestringSocial platform type (“li”, “fb”, “tw”, “ig”)
linkstringURL to the social media profile
ratingstringConfidence rating (0-100) for the social media match

​
Social Platform Types

TypePlatform
liLinkedIn
fbFacebook
twTwitter
igInstagram

​
Error Responses

Status CodeDescription
400Bad Request - No parameters provided or multiple parameters provided
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits (costs 1 credit)
500Internal Server Error - Error processing request

​
Notes

  • Each request costs 1 credit, regardless of whether data comes from cache
  • High-quality contacts with rating ≥90 are prioritized
  • Social links with rating ≥60 are included
  • Results are cached for faster subsequent lookups
  • For email/phone searches, the system first finds the associated LinkedIn profile

Authorizations

​
Authorization
string
header
required

API key must be provided as a Bearer token in the Authorization header. Example: lk_your_api_key_here

Query Parameters

​
linkedin_url
string

The LinkedIn profile URL to look up. Exactly one of 'linkedin_url', 'email', or 'phone' must be provided.

​
email
string

Email address to search for. Exactly one of 'linkedin_url', 'email', or 'phone' must be provided.

​
phone
string

Phone number to search for. Exactly one of 'linkedin_url', 'email', or 'phone' must be provided.

Response

200
application/json

Successful contact information retrieval

The response is of type object.