Skip to main content
POST
https://api.talktohumans.app
/
v1
/
enrich
curl --request POST \
  --url https://api.talktohumans.app/v1/enrich \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "42",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe/"
}
'
{
  "data": {
    "linkedin_enrichment": {
      "profile": {
        "participant": {
          "provider": "linkedin",
          "provider_participant_id": "urn:li:fsd_profile:abc",
          "kind": "member",
          "public_identifier": "jane-doe",
          "profile_url": "https://www.linkedin.com/in/jane-doe/",
          "first_name": "Jane",
          "last_name": "Doe",
          "full_name": "Jane Doe",
          "headline": "Founder at Acme",
          "avatar_url": "https://media.licdn.com/dms/image/example/profile-displayphoto.jpg",
          "background_cover_url": "https://media.licdn.com/dms/image/example/profile-cover.jpg",
          "primary_company": {
            "provider": "linkedin",
            "provider_participant_id": "urn:li:fsd_company:123"
          },
          "primary_company_name": "Acme",
          "primary_role_title": "Founder",
          "profile_fetched_at": "2026-05-31T12:00:00Z",
          "updated_at": "2026-05-31T12:00:00Z"
        },
        "languages": [
          {
            "language": "English",
            "metadata_json": null
          }
        ],
        "experiences": [
          {
            "company": {
              "provider": "linkedin",
              "provider_participant_id": "urn:li:fsd_company:123"
            },
            "company_name": "Acme",
            "title": "Founder",
            "employment_type": "Full-time",
            "location": "San Francisco Bay Area",
            "start_at": "2021-01",
            "end_at": null,
            "is_current": true,
            "description": "Building business software for sales teams.",
            "metadata_json": null
          }
        ],
        "educations": [
          {
            "school": {
              "provider": "linkedin",
              "provider_participant_id": "urn:li:fsd_company:987"
            },
            "school_name": "Stanford University",
            "degree": "MBA",
            "field_of_study": "Business Administration",
            "start_at": "2014",
            "end_at": "2016",
            "description": null,
            "metadata_json": null
          }
        ],
        "locations": [
          {
            "source": "linkedin",
            "sort_order": 0,
            "is_primary": true,
            "is_headquarter": false,
            "linkedin_text": "San Francisco Bay Area",
            "display_text": "San Francisco, California, United States",
            "country_code": "US",
            "region_code": "US-CA",
            "country": "United States",
            "country_full": "United States",
            "state": "California",
            "city": "San Francisco",
            "geographic_area": "San Francisco Bay Area",
            "line1": null,
            "line2": null,
            "postal_code": null,
            "description": null,
            "metadata_json": null
          }
        ],
        "industries": [
          {
            "sort_order": 0,
            "industry_urn": "urn:li:industry:4",
            "provider_industry_id": "4",
            "name": "Software Development",
            "title": "Software Development",
            "hierarchy": "Technology > Software",
            "metadata_json": null
          }
        ]
      },
      "company": {
        "participant": {
          "provider": "linkedin",
          "provider_participant_id": "urn:li:fsd_company:123",
          "kind": "company",
          "public_identifier": "acme",
          "profile_url": "https://www.linkedin.com/company/acme/",
          "full_name": "Acme",
          "headline": "Software Development",
          "avatar_url": "https://media.licdn.com/dms/image/example/company-logo.jpg",
          "background_cover_url": "https://media.licdn.com/dms/image/example/company-cover.jpg",
          "headcount": "51-200",
          "employee_count": 120,
          "website_url": "https://acme.example",
          "follower_count": 12000,
          "about": "Acme builds business software.",
          "profile_fetched_at": "2026-05-31T12:00:00Z",
          "updated_at": "2026-05-31T12:00:00Z"
        },
        "languages": [
          {
            "language": "English",
            "metadata_json": null
          }
        ],
        "experiences": [
          {
            "company": null,
            "company_name": "Acme",
            "title": "Company profile",
            "employment_type": null,
            "location": "San Francisco, CA",
            "start_at": null,
            "end_at": null,
            "is_current": true,
            "description": null,
            "metadata_json": null
          }
        ],
        "educations": [
          {
            "school": null,
            "school_name": null,
            "degree": null,
            "field_of_study": null,
            "start_at": null,
            "end_at": null,
            "description": null,
            "metadata_json": null
          }
        ],
        "locations": [
          {
            "source": "linkedin",
            "sort_order": 0,
            "is_primary": true,
            "is_headquarter": true,
            "linkedin_text": "San Francisco, CA",
            "display_text": "San Francisco, California, United States",
            "country_code": "US",
            "region_code": "US-CA",
            "country": "United States",
            "country_full": "United States",
            "state": "California",
            "city": "San Francisco",
            "geographic_area": "San Francisco Bay Area",
            "line1": null,
            "line2": null,
            "postal_code": null,
            "description": null,
            "metadata_json": null
          }
        ],
        "industries": [
          {
            "sort_order": 0,
            "industry_urn": "urn:li:industry:4",
            "provider_industry_id": "4",
            "name": "Software Development",
            "title": "Software Development",
            "hierarchy": "Technology > Software",
            "metadata_json": null
          }
        ]
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Pass your API key as Authorization: Bearer <api_key>.

Body

application/json

Provide exactly one target: contact_id, provider_participant_id, linkedin_url, or public_identifier.

​
contact_id
string
required

Contact ID returned by GET /v1/contacts.

Pattern: ^[1-9][0-9]*$
​
account_id
string

LinkedIn account ID returned by GET /v1/accounts. Required when the workspace has multiple LinkedIn accounts.

Pattern: ^[1-9][0-9]*$
​
provider_participant_id
string

LinkedIn participant ID, such as urn:li:fsd_profile:abc.

​
linkedin_url
string<uri>

LinkedIn profile URL.

​
public_identifier
string

LinkedIn public identifier from a profile URL.

​
force
boolean
default:false

Refresh cached enrichment data even when fresh data is already available.

Response

LinkedIn profile and primary company enrichment data.

​
data
object
required