GET
/
api
/
enrich
/
linkedin
curl --request GET \
  --url https://search.linkd.inc/api/enrich/linkedin \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "profile": {
        "id": "example_user_id",
        "name": "John Doe",
        "location": "San Francisco, CA",
        "headline": "Software Engineer at Tech Company",
        "description": "Experienced software engineer with a focus on AI and machine learning...",
        "title": "Software Engineer",
        "profile_picture_url": "https://example.com/pic.jpg",
        "linkedin_url": "https://linkedin.com/in/johndoe"
      },
      "experience": [
        {
          "title": "Software Engineer",
          "company_name": "Tech Company",
          "start_date": "2021-01",
          "end_date": null,
          "description": "Working on AI-powered features...",
          "location": "San Francisco, CA",
          "company_logo": "https://example.com/company-logo.jpg"
        }
      ],
      "education": [
        {
          "degree": "Bachelor of Science",
          "field_of_study": "Computer Science",
          "school_name": "Example University",
          "school_logo": "https://example.com/school-logo.jpg",
          "start_date": "2017-09",
          "end_date": "2021-05",
          "description": "Member of CS club, AI research assistant..."
        }
      ]
    }
  ]
}

Retrieve comprehensive profile information including work experience, education, and contact details. This endpoint accepts a LinkedIn URL, email address, or phone number as input.

​
Enrich Profile Data

curl -X GET "https://search.linkd.inc/api/enrich/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
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/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/linkedin?phone=%2B1-555-123-4567" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "profile": {
        "id": "example_user_id",
        "name": "John Doe",
        "location": "San Francisco, CA",
        "headline": "Software Engineer at Tech Company",
        "description": "Experienced software engineer with a focus on AI and machine learning...",
        "title": "Software Engineer",
        "profile_picture_url": "https://example.com/pic.jpg",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "twitter_handle": "johndoe",
        "websites": [
          {
            "url": "https://johndoe.com"
          }
        ]
      },
      "experience": [
        {
          "title": "Software Engineer",
          "company_name": "Tech Company",
          "start_date": "2021-01-01T00:00:00",
          "end_date": "1970-01-01T00:00:00",
          "description": "Working on AI-powered features...",
          "location": "San Francisco, CA",
          "company_logo": "https://example.com/company-logo.jpg"
        }
      ],
      "education": [
        {
          "degree": "Bachelor of Science",
          "field_of_study": "Computer Science",
          "school_name": "Example University",
          "school_logo": "https://example.com/school-logo.jpg",
          "start_date": "2017-09-01T00:00:00",
          "end_date": "2021-05-01T00:00:00",
          "description": "Member of CS club, AI research assistant..."
        }
      ],
      "languages": ["English", "Spanish"]
    }
  ]
}

​
Response (No Data Found)

{
  "data": [
    {
      "message": "No data found for LinkedIn URL: https://www.linkedin.com/in/johndoe"
    }
  ]
}

​
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 successful request costs 1 credit
  • If searching by email or phone, the system first finds the associated LinkedIn profile
  • End date of “1970-01-01T00:00:00” indicates current position
  • Website URLs are returned as objects with a “url” field
  • Languages are returned as an array of strings

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

​
url
string

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

​
email
string

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

​
phone
string

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

Response

200
application/json

Successful enrichment operation

The response is of type object.