LinkedIn Search People
LinkedIn Search People turns the keywords value in each submitted people-search URL into a name-oriented provider query. Results are candidate public profiles for identity review, not proof that a profile belongs to the intended person, and the endpoint does not replay company, school, location, industry, or connection filters encoded in the URL.
Features
- People-search URL inputSubmit one or more public LinkedIn URLs whose paths begin with /search/results/people.
- Explicit name mappingDecode keywords, map its first whitespace-delimited token to first_name, and join the remaining tokens as last_name.
- Candidate profile discoveryReceive public profile URLs and identity context that can support manual matching or later profile-specific collection.
- Canonical account recordsReturn stable identity, description, image, website, account-state, location, metric, and collection fields.
- Nullable source fidelityLeave unavailable fields null and avoid inferring private contact details, work history, education, skills, or identity certainty.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of public http or https LinkedIn URLs. Each host must be linkedin.com or a LinkedIn subdomain, and each path must begin with /search/results/people. Include keywords for reliable name-oriented behavior. |
How to Use
Prepare name-oriented people-search URLs, submit the asynchronous task, and review every returned candidate.
- Create a LinkedIn people-search URL with a keywords query value containing the person's name.
- POST urls to /v1/linkedin/search-people and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task reaches a terminal status.
- On success, process data.results.items and follow next_cursor whenever has_more is true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Profile URL discovery: Find candidate public LinkedIn profile URLs before using a profile-specific collection endpoint.
- Manual identity resolution: Compare names, descriptions, locations, images, and URLs across candidates while retaining uncertainty.
- Public directory intake: Feed normalized candidate accounts into a review queue without promising contact enrichment or private attributes.
- Name-variant research: Run carefully selected name spellings separately and compare the public candidates produced at each collection time.
Pro Tips
- Always include a meaningful keywords query value; a valid URL without it creates an empty name row whose provider behavior is not reliable.
- Remember that Mary Jane Smith is mapped to first_name Mary and last_name Jane Smith, not treated as a general keyword expression.
- Do not assume that location, company, school, industry, or connection filters in the URL are honored; the current adapter discards them.
- Use the public profile URL plus multiple corroborating attributes before identifying a person.
- Deduplicate repeated candidates by stable profile URL when multiple submitted searches overlap.
- There is no caller-controlled result limit, so design billing and review workflows around actual stored results.
Related APIs
Use these APIs when you need a different type of public LinkedIn data.
- LinkedIn Profiles API — Normalize public profile identity, roles, location, visible audience counts, experience, education, and skills from profile URLs.
- LinkedIn Companies API — Normalize public company descriptions, websites, logos, visible audience and employee counts, industries, locations, and specialties.
- LinkedIn Posts API — Collect public post text, authors, visible engagement, media, publication time, type, and hashtags from supported URLs.
- LinkedIn Jobs API — Normalize public job titles, companies, descriptions, locations, qualifications, employment details, application links, and available salary fields.
- LinkedIn Company Jobs API — Discover public job listings from prepared LinkedIn /jobs/ URLs with normalized role, company, location, employment, experience, remote, salary, and timing fields.
- LinkedIn Company Posts API — Discover public posts from LinkedIn company-page URLs with text, author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Post Comments API — Collect public comments exposed with a known LinkedIn post, including text, author context, timestamps, relationship IDs, and visible likes and reply counts.
- LinkedIn Profile Posts API — Discover public posts associated with LinkedIn profile URLs, with author context, media, hashtags, timestamps, and visible engagement.
- LinkedIn Search Jobs API — Search public LinkedIn jobs from a required location and optional filters, returning normalized role, company, place, employment, experience, remote, salary, and timing fields.
- LinkedIn Search Posts API — Discover Google-indexed public LinkedIn posts by keyword and optional date string, returning normalized content, authors, media, tags, timestamps, and visible engagement.