LinkedIn URL → Profile

Endpoint POST /contacts/research · Credits 1 per profile · Delivery async (poll or webhook) · Versions v1, v2

Introduction

Send a LinkedIn profile URL and get back the contact details LinkedIn doesn’t show: work and personal emails with validation status, direct dials, mobile numbers, company phones, and a normalized location. Accepts public profile URLs, Sales Navigator URLs, and Recruiter URLs. Use it to enrich LinkedIn exports, Sales Navigator lead lists, and URLs captured by your own tools.

AI agent prompt

Read https://docs.seamless.ai/llms.txt and https://docs.seamless.ai/api-catalog/linkedin-to-profile.
Using my Seamless.AI API key from SEAMLESS_API_KEY, read a CSV of LinkedIn URLs, send them in batches
of up to 500 to POST https://api.seamless.ai/api/client/v1/contacts/research as
{"contacts":[{"liProfileUrl": <url>}]}, poll each requestId until done,
and write email, contactPhone1, jobTitle, and companyName back to the CSV.

Authentication

Send your API key in the Token header, or Authorization: Bearer <token> with OAuth. Create a key under Settings → Public API.

Example

curl -X POST https://api.seamless.ai/api/client/v1/contacts/research \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "liProfileUrl": "https://www.linkedin.com/in/janedoe" },
      { "liSalesNavUrl": "https://www.linkedin.com/sales/lead/ACwAAA..." }
    ]
  }'

import os, requests

resp = requests.post(
    "https://api.seamless.ai/api/client/v1/contacts/research",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"contacts": [{"liProfileUrl": "https://www.linkedin.com/in/janedoe"}]},
)
request_ids = resp.json()["requestIds"]  # poll /contacts/research/poll with these

const resp = await fetch("https://api.seamless.ai/api/client/v1/contacts/research", {
  method: "POST",
  headers: { Token: process.env.SEAMLESS_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ contacts: [{ liProfileUrl: "https://www.linkedin.com/in/janedoe" }] }),
});
const { requestIds } = await resp.json();

curl "https://api.seamless.ai/api/client/v1/contacts/research/poll?requestIds=REQUEST_ID" \
  -H "Token: $SEAMLESS_API_KEY"

Reference

Each item in contacts needs one of these URLs. Up to 500 items per request.

Parameter	Type	Description
`contacts[].liProfileUrl`	string	Public LinkedIn profile URL
`contacts[].liSalesNavUrl`	string	Sales Navigator lead URL
`contacts[].liRecruiterUrl`	string	LinkedIn Recruiter profile URL
`listIds`	integer[]	Optional. Add each contact to these Seamless lists.
`skipDeduplicationCheck`	boolean	Optional. Research again even if researched recently. Uses credits.

Response

The call returns 202 with requestIds. When a poll returns status: done, contact holds the full record:

Field	Description
`email`, `email1`-`email3`, `email{n}EmailAI`	Work emails with validation status
`personalEmail`	Personal email, when available
`contactPhone1`, `contactPhone2`, `contactPhone{n}DataType`	Direct dials and mobiles
`companyPhone1`-`companyPhone3`	Company phones
`fullName`, `jobTitle`, `seniority`, `companyName`, `companyDomain`	Identity and employer
`lIProfileUrl`, `lISalesNavUrl`, `lIRecruiterUrl`	All known LinkedIn URLs

See the Data dictionary for every field.

Errors

Status	Meaning
`401`	Missing or invalid API key
`422`	`insufficientCredits` or `missingLicense`
`429`	Rate limit reached
Poll `not found`	No person matched the URL

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

LinkedIn URL → Profile

Introduction

AI agent prompt

Authentication

Example

Reference

Response

Errors

​Introduction

​AI agent prompt

​Authentication

​Example

​Reference

​Response

​Errors

​Related

Introduction

AI agent prompt

Authentication

Example

Reference

Response

Errors

Related