Find Profile Url

Turn a person hint (name, headline fragment, or vanity) into a stable LinkedIn profile URL.

Edges is not related to LinkedIn and is not an official LinkedIn product.

API Endpoint

POST/v1/actions/linkedin-find-profile-url/run/live

Parameters

Input Parameters

Integration Parameters

Guide

What Find Profile Url does

Find Profile Url turns a person hint — a name, a headline fragment, a vanity string, or an email-derived guess — into a stable LinkedIn profile URL. You get back the canonical /in/{vanity}/ URL plus a short candidate list so your workflow can branch when the match is ambiguous.

It runs on the LinkedIn level and uses your connected LinkedIn session to search LinkedIn's own people index.

How it works

You pass a hint (full name, partial vanity, name plus company, or a handle). Edges signs the request with your authenticated LinkedIn session, queries LinkedIn's people search with the available fields, and returns the highest-confidence profile plus ranked alternatives. The action runs on Edges infrastructure with built-in pacing and retries.

Because Find Profile Url returns both the top match and a candidate array, you can automate resolution above a confidence threshold and hand off edge cases to a review queue — exactly the pattern needed for production enrichment at scale.

When to use Find Profile Url

Use Find Profile Url when your upstream data has people but not URLs — email exports, event attendee lists, support tickets, or CRM rows with a contact name and company. It is the resolution primitive in the LinkedIn profile & company data API workflow, sitting just before any extraction or outreach step.

Without it, every downstream action either fails on bad URLs or gets the wrong person, which poisons personalization in ways your team will not notice until a prospect replies.

Use cases

  • CRM enrichment. Resolve every contact record with a missing LinkedIn URL and store it so future extractions just work.
  • Event follow-up. Registration form collected name and company — Find Profile Url gets you to a profile URL before outreach.
  • Sequencer hydration. Before a sequence fires, resolve ambiguous names to canonical URLs so personalization fields are correct.
  • Team mapping. Turn a list of internal sponsor names at a target account into profile URLs your AE can actually view.
  • Support escalations. When a support ticket surfaces an exec name, resolve to LinkedIn so AMs can loop in.

Best practices

  • Always pass a company hint when you have one. Names are not unique — current company disambiguates faster than any other field.
  • Gate on `confidenceScore`. Automate the high-confidence matches; send low-confidence ones to a human review flow.
  • Cache aggressively. Once resolved, store the canonical URL — vanity URLs rarely change and caching is the cheapest way to protect your LinkedIn usage budget.
  • Stay within LinkedIn guardrails. Edges paces the work automatically; keep combined automation on the same account reasonable.

Common questions

How many profiles can I resolve per run?

One per run. Find Profile Url is a single-record primitive designed to sit inside a per-row loop or a webhook-triggered flow.

Does this use my LinkedIn account or a shared pool?

Your LinkedIn account. You connect LinkedIn to Edges once, and every lookup runs through that authenticated session.

Can I chain Find Profile Url with other Edges actions?

Yes. The resolved publicProfileUrl is the standard input for Extract LinkedIn Profile, Visit LinkedIn Profile, and Connect LinkedIn Profile.

Get started

Drop Find Profile Url into any enrichment pipeline that starts with person hints, or call it from the Edges API as the first step in your outreach workflow. Browse the full Actions library to see the rest of the LinkedIn stack.

Code Examples

bash
curl -X POST "https://api.edges.run/v1/actions/linkedin-find-profile-url/run/live" \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "identity_ids": [
    "your-identity-uuid"
  ],
  "identity_mode": "direct",
  "input": {
    "full_name": "example_value",
    "company_name": "example_value",
    "domain": "example_value",
    "job_title": "example_value",
    "custom_data": "example_value"
  }
}'

Output Example

{
  "linkedin_profile_url": "https://www.linkedin.com/in/example-profile"
}

Explore More Actions

Discover other powerful LinkedIn automation actions in our library.