🚀 LinkedIn Profile Scraper

A powerful Apify Actor that enriches LinkedIn profiles with comprehensive data extraction, email discovery, and mobile number lookup capabilities.

📋 Overview

The LinkedIn Profile Scraper is an enterprise-grade Apify Actor designed to extract comprehensive information from LinkedIn profiles. It automatically enriches profile data with contact information, work history, education, skills, and more, making it an essential tool for lead generation, recruitment, market research, and sales outreach.

Key Highlights:

• ✅ No LinkedIn Cookies Required – Operates without authentication cookies
• ✅ Bulk Processing – Process multiple profiles concurrently
• ✅ Smart Email Discovery – Automatically attempts to find email addresses
• ✅ Mobile Number Lookup – Exclusive mobile number enrichment for paying users
• ✅ Structured Output – Returns normalized, consistent JSON data format

---

✨ Features

👤 Comprehensive Profile Data

Extracts complete profile information including:

• Personal Information: Full name, headline, summary, profile pictures, location
• Work Experience: Current and past positions, companies, job descriptions, durations
• Education: Universities, degrees, fields of study, graduation dates
• Skills & Endorsements: Professional skills and endorsement counts
• Additional Data: Languages, certifications, publications, patents, volunteer work, recommendations

🏢 Company Intelligence

Automatically gathers company information from job history:

• Company name, industry, website, LinkedIn URL
• Company size (headcount range)
• Founded year and company identifiers

📧 Contact Enrichment

• Email Discovery: Automatically attempts to find email addresses of the person
• Mobile Number Lookup: For paying Apify users, attempts to find mobile phone numbers

⚡ Performance & Reliability

• Concurrent Processing: Processes multiple profiles in parallel
• Error Handling: Graceful error handling with detailed logging
• Retry Mechanism: Automatic retries for failed requests
• URL Validation: Automatic validation and normalization of LinkedIn URLs

---

🚀 Quick Start

1. Get Started: Create an Apify account if you don't have one
2. Prepare URLs: Collect the LinkedIn profile URLs you want to enrich
3. Run the Actor: Use the Apify Console UI to run the actor with your profile URLs
4. Download Results: Export your enriched data as JSON, CSV, or Excel

---

🛠️ Usage

Prerequisites

• An Apify account
• LinkedIn profile URLs you want to enrich

Input Format

The actor accepts a JSON input with an array of LinkedIn profile URLs:

{
  "profileUrls": [
    "https://www.linkedin.com/in/williamhgates",
    "https://www.linkedin.com/in/jeannie-wyrick-b4760710a"
  ]
}

Running the Actor

Option 1: Apify Console (Recommended)

1. Navigate to the actor on Apify Console
2. Enter your LinkedIn profile URLs in the input field
3. Click Start to begin the enrichment process

Option 2: API

curl -X POST \
  'https://api.apify.com/v2/acts/2SyF0bVxmgGr8IVCZ/runs?token=YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "profileUrls": [
      "https://www.linkedin.com/in/williamhgates"
    ]
  }'

Option 3: Local Development

# Install dependencies
npm install

# Run locally
npm start

# Or with TypeScript
npm run start:dev

---

📊 Output Format

The actor returns a structured JSON object for each successfully enriched profile.

Main Profile Data

{
  "linkedinUrl": "https://www.linkedin.com/in/williamhgates",
  "linkedinPublicUrl": "https://linkedin.com/in/williamhgates",
  "firstName": "Bill",
  "lastName": "Gates",
  "fullName": "Bill Gates",
  "headline": "Co-chair, Bill & Melinda Gates Foundation",
  "connections": 500,
  "followers": 15000,
  "email": "bill.gates@example.com",
  "mobileNumber": "+1234567890",
  "publicIdentifier": "williamhgates",
  "urn": "ACoAAABxN1IBk82L_jCY2opFKNZpSCCcsr6X1MU"
}

Work Experience

{
  "jobTitle": "Co-chair",
  "jobStartedOn": "2021-01",
  "jobLocation": "Seattle, Washington, United States",
  "jobStillWorking": true,
  "currentJobDuration": "3 yrs 6 mos",
  "currentJobDurationInYrs": 3.5,
  "companyName": "Bill & Melinda Gates Foundation",
  "companyIndustry": "Non-profit Organizations",
  "companyWebsite": "https://www.gatesfoundation.org",
  "companyLinkedin": "https://www.linkedin.com/company/gatesfoundation",
  "companySize": "1001-5000",
  "experiences": [
    {
      "companyId": "12345",
      "companyUrn": "urn:li:fsd_company:12345",
      "companyName": "Bill & Melinda Gates Foundation",
      "title": "Co-chair",
      "jobDescription": "Leading foundation initiatives, Strategic planning",
      "jobStartedOn": "2021-01",
      "jobEndedOn": null,
      "jobStillWorking": true,
      "jobLocation": "Seattle, Washington, United States",
      "companyWebsite": "https://www.gatesfoundation.org",
      "companyIndustry": "Non-profit Organizations",
      "companySize": "1001-5000"
    }
  ]
}

Additional Data Fields

The output includes comprehensive arrays for:

• educations: University, degree, field of study, dates
• skills: Professional skills with titles
• languages: Languages spoken
• certifications: Professional certifications and licenses
• publications: Published articles and papers
• recommendations: Recommendations received and given
• And many more fields...

Export Options

Your enriched data can be:

• Downloaded as JSON
• Accessed via Apify Dataset API
• Exported to other formats (CSV, Excel) via Apify Console

---

🎯 Rate Limits & Plan Restrictions

Free Plan Users

• Daily Run Limit: 10 runs per day
• Execution Method: UI only (cannot run via API or CLI)
• Mobile Number Lookup: Not available

Paying Users

• Daily Run Limit: 10,000,000 runs per day (effectively unlimited)
• Execution Method: UI, API, or CLI
• Mobile Number Lookup: Available

---

🔍 Error Handling

The actor handles errors gracefully:

• Invalid URLs: Automatically skipped with a warning message
• API Failures: Individual profile failures don't stop the entire run
• Timeout Errors: Clear error messages for timeout issues
• Rate Limits: Automatic enforcement with user-friendly messages

Error Output Format

{
  "inputUrl": "https://www.linkedin.com/in/invalid-profile",
  "succeeded": false,
  "error": "Profile enrichment API responded with success=false."
}

---

📈 Performance Tips

1. Batch Processing: Process multiple profiles in a single run to maximize efficiency
2. URL Validation: Ensure LinkedIn URLs are correctly formatted before submission
3. Monitor Progress: Check the Apify Console logs to track processing status

---

🔐 Security & Privacy

• No Cookies Required: The actor doesn't require LinkedIn authentication cookies
• Data Privacy: All data processing complies with Apify's data handling policies

---

🆘 Support

For issues, questions, or feature requests:

• Email: devfusion70@gmail.com
• Apify Actor: LinkedIn Profile Scraper

---

Made with ❤️ for the LinkedIn data enrichment community