LinkedIn

LinkedIn API

Ranked profile
candidates

Find public LinkedIn profile candidates from name and company clues, then review the ranking evidence yourself.

  • Ranked candidates from public indexed results
  • Match reasons, score and confidence band
  • Candidate rows that always require review

Historical recordings · 1 recorded item in the saved sample

POST/acts/meka.im~linkedin-profile-candidate-finder/run-sync-get-dataset-items

Satya Nadella · profile candidate

LinkedIn · recorded sample

1 recorded item

LinkedIn Profile Finder

Satya Nadella - Chairman and CEO at Microsoft - LinkedIn

Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ...

The saved record is a raw candidate row, not a complete Dataset item. Treat it as historical evidence for manual review.

Recorded Sep 24, 2026Historical sample

Overview

What this API returns

Find public LinkedIn profile candidates from name and company clues, then review the ranking evidence yourself.

Send one people record per known person. A full name is required; company, domain, title, location and keywords improve ranking. maxCandidates, includeEvidence and minScore control how many candidates and how much evidence are returned.

A candidate is not a confirmed identity. score is ranking evidence, confidence is a ranking band, and requiresReview is always true. Review the returned URLs and evidence before using a candidate in a downstream workflow.

Input

People records

Output

Ranked candidate rows

01

Describe each person

Provide a full name plus optional company, domain, title, location and keywords.

02

Rank public candidates

The Actor searches public Google-indexed results and scores possible LinkedIn profile matches.

03

Review the evidence

Read candidate URLs, titles, snippets and match reasons. Every candidate still requires manual review.

Use cases

Where these records fit

The record is designed to sit inside research and review workflows. The examples below are starting points, not packaged scores.

Sourcing review

Generate a shortlist of possible profiles for a person you already know, then verify each candidate.

  • fullName
  • company
  • candidates

Manual verification

Use match reasons and confidence bands to prioritize which candidate a reviewer checks first.

  • score
  • confidence
  • matchReasons

Record matching

Enrich a people list with candidate URLs while keeping the review flag visible.

  • bestCandidateUrl
  • requiresReview
  • status

Try it

Inspect a recorded candidate row

The saved sample is a raw candidate record with title, URL and snippet. It is not a complete Dataset item and still requires review.

Checking live preview

Checking live preview availability… Saved samples remain available.

Enter a full name, with company or other context if available.

POSThttps://api.apify.com/v2/acts/meka.im~linkedin-profile-candidate-finder/run-sync-get-dataset-items
Recorded sample
Copyable cURL uses the current preview input and the Actor endpoint.

Rendered

Recorded
LinkedIn
1 record

LinkedIn Profile Finder

Satya Nadella - Chairman and CEO at Microsoft - LinkedIn

Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ...

Response details (3 fields)

Best candidate

The top ranked public profile candidate and the Google-indexed evidence behind it. Confirm the identity before use.

Candidate title
Satya Nadella - Chairman and CEO at Microsoft - LinkedIn
Search snippet
Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ...

Only returned fields are shown.

All returned fields

title
Satya Nadella - Chairman and CEO at Microsoft - LinkedIn
url
https://www.linkedin.com/in/satyanadella
snippet
Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ...

Recorded Sep 24, 2026 · Historical snapshot · Source: LinkedIn

JSON

Recordedapplication/json
1[2  {3    "title": "Satya Nadella - Chairman and CEO at Microsoft - LinkedIn",4    "url": "https://www.linkedin.com/in/satyanadella",5    "snippet": "Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ..."6  }7]

Reference

Request and response contract

POST to the Apify Actor endpoint with a bearer token. Request examples use $APIFY_TOKEN and the current product defaults; response examples come from a saved historical record.

Parameters

Request fields accepted by the Actor. Preview input is sent only when you run a live request.

peopleobject[]Required

One record per known person. A full name is required; company, domain, title, location, and keywords improve ranking.

Example: [{"fullName":"Satya Nadella","company":"Microsoft","domain":"microsoft.com","title":"CEO","location":"Redmond"}]

maxCandidatesinteger

Maximum ranked LinkedIn profile candidates returned for each successful input. Default: 5. Minimum: 1. Maximum: 10.

Example: 5

includeEvidenceboolean

Include Google result titles, snippets, and match reasons with each candidate. Default: true.

minScoreinteger

Higher thresholds return fewer candidates. A score is ranking evidence, not an identity-verification guarantee. Default: 40. Minimum: 0. Maximum: 100.

Example: 40

maxConcurrencyinteger

Maximum people processed concurrently. The conservative default is validated for the Google-only route. Default: 5. Minimum: 1. Maximum: 10.

Example: 5

Response

The saved example is a raw candidate record with title, url and snippet, not a complete Dataset item. The published response contract is listed below.

fullNamestringRequired

Input person's full name.

companystring | null

Optional input company.

domainstring | null

Optional input company domain.

titlestring | null

Optional input role or title.

Example: Satya Nadella - Chairman and CEO at Microsoft - LinkedIn

locationstring | null

Optional input location.

keywordsstring | null

Optional input keywords.

statusstringRequired

Candidate, no reliable indexed result, or execution/input error. Accepted: "candidate_found", "not_found", "error".

bestCandidateUrlstring | nullRequired

Top canonical linkedin.com/in candidate, or null.

bestCandidateTitlestring | null

Google-indexed title for the top candidate.

bestCandidateSnippetstring | null

Google-indexed snippet for the top candidate.

scoreintegerRequired

Deterministic ranking score from public input and Google evidence.

confidencestringRequired

Ranking band, never an identity guarantee. Accepted: "high", "medium", "low", "none".

matchReasonsstring[]Required

Public clues that contributed to the ranking score.

requiresReviewbooleanRequired

Always true because candidate identity must be reviewed.

sourcestringRequired

Public Google-indexed web results. Accepted: "google_public_index".

queryCountintegerRequired

Google-only query variants actually executed.

candidatesobject[]Required

Ranked, deduplicated canonical LinkedIn profile candidates.

errorCodestring | null

Machine-readable error code. Accepted: "invalid_input", "search_failed".

errorstring | null

User-readable error details.

curl -X POST 'https://api.apify.com/v2/acts/meka.im~linkedin-profile-candidate-finder/run-sync-get-dataset-items' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "people": [
    {
      "fullName": "Satya Nadella",
      "company": "Microsoft",
      "domain": "microsoft.com",
      "title": "CEO",
      "location": "Redmond"
    }
  ],
  "maxCandidates": 5,
  "includeEvidence": true,
  "minScore": 40
}'

Recorded sample

1 recorded item · historical sample

[
  {
    "title": "Satya Nadella - Chairman and CEO at Microsoft - LinkedIn",
    "url": "https://www.linkedin.com/in/satyanadella",
    "snippet": "Satya Nadella is an influencer. Chairman and CEO at Microsoft. Microsoft The University of Chicago Booth School of Business. Redmond, ..."
  }
]

Recorded Sep 24, 2026 · historical snapshot

Pricing & access

Usage is billed through the Actor

Published FREE-plan event rates from public Apify metadata. Plan-specific rates and usage terms remain on the Actor's pricing page.

Pricing

Pay per delivered event

Apify FREE-plan rate

$0.50per 1,000 candidate sets

Per delivered candidate set. Not-found and error records are free.

Checked 19 Oct 2026Apify pricing

Access

One POST endpoint

  • Authenticate with an Apify Bearer token.
  • Send a JSON body to the posted Actor endpoint.
  • Read the Dataset items array returned by the run.

https://api.apify.com/v2/acts/meka.im~linkedin-profile-candidate-finder/run-sync-get-dataset-items

FAQ

Questions about the contract

Authentication, response shape, recorded data and availability.

Does a high score confirm the person?

No. score is deterministic ranking evidence and confidence is a ranking band. Neither is an identity guarantee, and requiresReview is always true.

What does the saved sample contain?

The saved record is a historical raw candidate with title, url and snippet. It is not the complete Dataset contract; the published response fields are listed in Reference.

Which inputs improve the ranking?

A full name is required. Company, domain, title, location and keywords add context to the public search and can improve candidate ranking.

How do I authenticate requests?

Send an Apify token as a Bearer token in the Authorization header, as shown in the request examples.

Are the results on this page live?

Not by default. Saved samples are historical recordings from the source; each keeps the fields and values from that record and does not verify current availability. Live data is requested directly from the published Apify Actor endpoint with your own token.

Where can I find current pricing?

Current pricing and usage terms are published on the Apify Actor page.