Skip to main content

LinkedIn Lookup

Find emails and phones for LinkedIn profile URLs. This endpoint supports both dashboard session auth and API key auth:

  • Dashboard session token → uses subscription credits
  • API key → uses API credits

Endpoint​

POST https://dievio.com/api/linkedin/lookup

Authentication​

Choose one:

Authorization: Bearer YOUR_SESSION_TOKEN

or

Authorization: Bearer YOUR_API_KEY

or

X-API-Key: YOUR_API_KEY

Request body​

Required​

  • linkedinUrls (string[]) — up to 100,000 URLs

Options​

  • includeWorkEmails (boolean, default true)
  • includePersonalEmails (boolean, default true)
  • onlyWithEmails (boolean, default true)
  • includePhones (boolean, default false)

Pagination & limits​

  • _page (default 1)
  • _per_page (default 100)
  • max_results (default linkedinUrls length; fallback 500, max 100000)

Response fields​

  • count: number of rows returned in this page
  • data: array of results (emails/phones merged)
  • page, per_page, total_pages, total_count, has_more, next_page
  • max_results

Credits​

  • 1 credit per result
  • Dashboard session uses subscription credits
  • API key uses API credits
  • Credits are deducted after results are generated, based on rows returned

Errors​

  • 401 — Missing or invalid credentials
  • 402 — Not enough credits (subscription or API)
  • 502 — LinkedIn service error (upstream VPS)
  • 500 — Server error

Example Request​

curl -X POST https://dievio.com/api/linkedin/lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkedinUrls": [
      "https://www.linkedin.com/in/example-1",
      "https://www.linkedin.com/in/example-2"
    ],
    "includeWorkEmails": true,
    "includePersonalEmails": true,
    "onlyWithEmails": true,
    "includePhones": false,
    "max_results": 500,
    "_per_page": 100,
    "_page": 1
  }'

Example Response​

{
  "success": true,
  "count": 2,
  "message": "Search completed.",
  "page": 1,
  "per_page": 100,
  "total_pages": 1,
  "total_count": 2,
  "has_more": false,
  "next_page": null,
  "max_results": 500,
  "data": [
    {
      "linkedin_url": "https://www.linkedin.com/in/example-1",
      "full_name": "Jane Doe",
      "first_name": "Jane",
      "last_name": "Doe",
      "job_title": "CEO",
      "company": "Acme Inc",
      "work_email": "jane@acme.com",
      "personal_emails": ["jane@gmail.com"],
      "personal_emails_count": 1,
      "has_email": true,
      "mobile_phone": null,
      "has_phone": false
    }
  ]
}