LinkedIn Person

Scrapes a LinkedIn person profile and returns comprehensive profile information including name, headline, experience, education, skills, and more. Cost: 3 credits

Endpoint

POST /v1/crawl/linkedin/person

Request

Headers

Header	Required	Description
`Authorization`	Yes	`ApiKey ck_...`
`Content-Type`	Yes	`application/json`

Body

{
  "url": "https://www.linkedin.com/in/john-doe/",
  "options": {
    "timeout": 30000
  }
}

Parameters

Parameter	Type	Required	Default	Description
`url`	string	Yes	-	LinkedIn profile URL (e.g., `https://www.linkedin.com/in/username/`)
`options.timeout`	number	No	30000	Page load timeout in milliseconds (5000-60000)

Response

Success (200)

{
  "success": true,
  "data": {
    "person": {
      "id": "john-doe",
      "name": "John Doe",
      "first_name": "John",
      "last_name": "Doe",
      "city": "San Francisco, California",
      "country_code": "US",
      "location": "San Francisco",
      "avatar": "https://media.licdn.com/dms/image/...",
      "banner_image": "https://static.licdn.com/...",
      "followers": 1250,
      "connections": 500,
      "url": "https://linkedin.com/in/john-doe",
      "linkedin_id": "john-doe",
      "linkedin_num_id": "123456789",
      "current_company": {
        "name": "TechCorp",
        "link": "https://linkedin.com/company/techcorp",
        "company_id": "techcorp",
        "location": "San Francisco, CA"
      },
      "current_company_name": "TechCorp",
      "current_company_company_id": "techcorp",
      "experience": [
        {
          "title": "Senior Software Engineer",
          "company": "TechCorp",
          "company_url": "https://linkedin.com/company/techcorp",
          "location": "San Francisco, CA",
          "start_date": "2020-01",
          "end_date": null,
          "description": "Leading backend development..."
        }
      ],
      "education": [
        {
          "title": "Stanford University",
          "url": "https://linkedin.com/school/stanford-university/",
          "start_year": "2015-09",
          "end_year": "2017-06",
          "description": "Master of Science in Computer Science",
          "description_html": null,
          "institute_logo_url": "https://media.licdn.com/..."
        }
      ],
      "educations_details": "Stanford University",
      "certifications": [
        {
          "title": "AWS Solutions Architect",
          "subtitle": "Amazon Web Services",
          "meta": "Issued Jan 2023",
          "credential_url": "https://...",
          "credential_id": "ABC123"
        }
      ],
      "honors_and_awards": null,
      "activity": [
        {
          "interaction": "Liked by John Doe",
          "link": "https://linkedin.com/posts/...",
          "title": "Post title or content preview...",
          "img": "https://static.licdn.com/...",
          "id": "7312736134415970305"
        }
      ],
      "similar_profiles": [],
      "bio_links": [],
      "default_avatar": false,
      "memorialized_account": false,
      "timestamp": "2025-01-15T10:30:00.000Z",
      "input": {
        "url": "https://www.linkedin.com/in/john-doe"
      },
      "_originalUrl": "https://www.linkedin.com/in/john-doe",
      "_scrapedAt": "2025-01-15T10:30:05.000Z"
    },
    "timing": {
      "total": 14403
    },
    "creditsUsed": 3,
    "creditsRemaining": 995
  }
}

Response Fields

Field	Type	Description
`person.id`	string	LinkedIn profile slug
`person.name`	string	Person’s full name
`person.first_name`	string	First name
`person.last_name`	string	Last name
`person.city`	string	City and country
`person.country_code`	string	ISO country code
`person.location`	string	Location name
`person.avatar`	string	Profile photo URL
`person.banner_image`	string	Background/banner image URL
`person.followers`	number	Follower count
`person.connections`	number	Connection count
`person.url`	string	LinkedIn profile URL
`person.linkedin_id`	string	LinkedIn profile slug
`person.linkedin_num_id`	string	LinkedIn numeric ID
`person.current_company`	object	Current company details
`person.current_company_name`	string	Current company name
`person.experience`	array \| null	Work experience list
`person.education`	array	Education history
`person.educations_details`	string	Education summary
`person.certifications`	array	Professional certifications
`person.honors_and_awards`	array \| null	Awards and honors
`person.activity`	array	Recent LinkedIn activity
`person.similar_profiles`	array	Similar profile suggestions
`person.bio_links`	array	External links from bio
`person.default_avatar`	boolean	Whether using default avatar
`person.memorialized_account`	boolean	Whether account is memorialized
`person.timestamp`	string	API response timestamp
`person._scrapedAt`	string	ISO timestamp of when data was scraped
`timing.total`	number	Total request time in milliseconds
`creditsUsed`	number	Credits charged (3)
`creditsRemaining`	number	Your remaining credit balance

The response structure may vary based on the profile’s privacy settings and available information. Some fields may be null or empty if the user hasn’t provided that information or has restricted visibility.

Examples

Basic Request

curl -X POST https://api.crawlkit.com/v1/crawl/linkedin/person \
  -H "Authorization: ApiKey ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.linkedin.com/in/john-doe/"}'

With Increased Timeout

curl -X POST https://api.crawlkit.com/v1/crawl/linkedin/person \
  -H "Authorization: ApiKey ck_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/in/john-doe/",
    "options": {
      "timeout": 60000
    }
  }'

Error Responses

Invalid URL (400)

{
  "success": false,
  "error": {
    "code": "INVALID_URL",
    "message": "URL must be a valid LinkedIn profile URL"
  }
}

Unauthorized (401)

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Insufficient Credits (402)

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "You need at least 3 credits for this operation"
  }
}

Timeout (408)

{
  "success": false,
  "error": {
    "code": "TIMEOUT",
    "message": "Page load timed out after 30000ms"
  }
}

Scrape Failed (502)

{
  "success": false,
  "error": {
    "code": "CRAWL_FAILED",
    "message": "Failed to scrape LinkedIn profile"
  }
}

Use Cases

Recruiting

Research candidates for job positions

Sales Prospecting

Gather information about potential leads

Networking

Learn about professionals before meetings

Background Research

Verify professional backgrounds

Tips

Use the correct URL format

LinkedIn profile URLs should follow the format: https://www.linkedin.com/in/username/. The trailing slash is optional.

Handle varying response structures

Profile data varies based on what users have shared. Always handle cases where fields might be missing or empty.

Respect rate limits

LinkedIn profiles require more resources to scrape. Consider spacing out your requests to avoid rate limiting.

Overview

Crawl Endpoints

Endpoint

Request

Headers

Body

Parameters

Response

Success (200)

Response Fields

Examples

Basic Request

With Increased Timeout

Error Responses

Invalid URL (400)

Unauthorized (401)

Insufficient Credits (402)

Timeout (408)

Scrape Failed (502)

Use Cases

Recruiting

Sales Prospecting

Networking

Background Research

Tips

Overview

Crawl Endpoints

​Endpoint

​Request

​Headers

​Body

​Parameters

​Response

​Success (200)

​Response Fields

​Examples

​Basic Request

​With Increased Timeout

​Error Responses

​Invalid URL (400)

​Unauthorized (401)

​Insufficient Credits (402)

​Timeout (408)

​Scrape Failed (502)

​Use Cases

Recruiting

Sales Prospecting

Networking

Background Research

​Tips

Endpoint

Request

Headers

Body

Parameters

Response

Success (200)

Response Fields

Examples

Basic Request

With Increased Timeout

Error Responses

Invalid URL (400)

Unauthorized (401)

Insufficient Credits (402)

Timeout (408)

Scrape Failed (502)

Use Cases

Tips