LinkedIn

LinkedIn is where B2B identities live—make sure the URLs you store truly point to the right people and companies. Delpha's LinkedIn Finder and LinkedIn Validator keep your CRM aligned with canonical LinkedIn profiles by normalizing URLs, checking format quality, and surfacing the most relevant matches.

What we assess:

• Completeness: Is a LinkedIn URL provided?

• Validity: Does the URL follow LinkedIn's accepted format (no existence check)?

• Consistency: Does the input equal the normalized canonical form (e.g., people → .../in/, companies → .../company/)?

• Accuracy: Does the URL appear to match the provided context (person: first & last name, optional company; company: company name, optional website)?

What you get back:

• A normalized LinkedIn URL and quality scores for the checks above.

• When context suggests a mismatch or uncertainty, AI-powered recommendations: candidate profiles/pages with confidence scores, rank, and helpful details (name, title, location, description). If a company website is provided, we can use it to help identify the official LinkedIn page.

With LinkedIn Finder and LinkedIn Validator, your records stay clean, standardized, and tied to the right LinkedIn identities—boosting routing accuracy and downstream engagement.

Submit linkedin for finding and validation

post

Submit an linkedin for finding and validation. Returns a job ID for tracking the process.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Body

application/json

Payload to submit a new LinkedIn quality job.

urlany ofOptional

The LinkedIn URL to assess.

Example: https://www.linkedin.com/in/victorgoubet/

stringOptional

or

nullOptional

websiteany ofOptional

The website URL associated with the LinkedIn entity.

Example: https://delpha.io/

stringOptional

or

nullOptional

company_nameany ofOptional

The name of the company.

Example: Delpha

stringOptional

or

nullOptional

first_nameany ofOptional

The first name of the entity if it's a profile.

Example: Victor

stringOptional

or

nullOptional

last_nameany ofOptional

The last name of the entity if it's a profile.

Example: Goubet

stringOptional

or

nullOptional

emailany ofOptional

The email address.

Example: [email protected]

stringOptional

or

nullOptional

Responses

202

Job submitted to assess_social_network_v16

application/json

400

Invalid linkedin format or missing required fields

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post

/v1/linkedin

HTTPcURLJavaScriptPython

POST /v1/linkedin HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "url": "https://www.linkedin.com/in/victorgoubet/",
  "website": "https://delpha.io/",
  "company_name": "Delpha",
  "first_name": "Victor",
  "last_name": "Goubet",
  "email": "[email protected]"
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "message": "Job submitted to assess_social_network_v16",
  "status": "SUCCESS",
  "status_code": 202
}

Get linkedin finder and validator job status

get

Retrieve the result and status of a previously submitted linkedin finder and validator job.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Path parameters

job_idstringRequired

The unique identifier of the linkedin job

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

Job succeeded.

application/json

Response after retrieving the status and result of an linkedin quality job.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: Job succeeded.

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

resultany ofOptional

The result of the linkedin quality job

Example: {"data_type":"social_network","label":"Ok","normalized_value":"https://www.linkedin.com/in/victorgoubet/","recommendations":[{"company_name":"Delpha","desc":"Data Engineer & Cloud specialist - AWS · Experience: Delpha · Education: ESILV - Ecole Supérieure d'Ingénieurs Léonard de Vinci · Location: Paris · 500+ ...","location":"Paris","profile_name":"Victor Goubet","rank":1,"score":0.8711710601954503,"title":"Victor Goubet - Delpha","url":"https://www.linkedin.com/in/victorgoubet/"}],"scores":{"accuracy":0.8711710601954503,"completeness":1,"consistency":1,"validity":1}}

or

nullOptional

process_timeany ofOptional

The total time taken to process the job, in seconds.

Example: 0.123

numberOptional

or

nullOptional

202

Job is still running.

application/json

400

Input validation failed.

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

500

Failed to retrieve job.

application/json

504

Job timed out.

application/json

get

/v1/linkedin/{job_id}

HTTPcURLJavaScriptPython

GET /v1/linkedin/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "data_type": "social_network",
    "normalized_value": "https://www.linkedin.com/in/victorgoubet/",
    "label": "Ok",
    "scores": {
      "accuracy": 0.8711710601954503,
      "completeness": 1,
      "consistency": 1,
      "validity": 1
    },
    "recommendations": [
      {
        "url": "https://www.linkedin.com/in/victorgoubet/",
        "score": 0.8711710601954503,
        "title": "Victor Goubet - Delpha",
        "rank": 1,
        "desc": "Data Engineer & Cloud specialist - AWS · Experience: Delpha · Education: ESILV - Ecole Supérieure d'Ingénieurs Léonard de Vinci · Location: Paris · 500+ ...",
        "company_name": "Delpha",
        "location": "Paris",
        "profile_name": "Victor Goubet"
      }
    ]
  },
  "process_time": 0.123
}