---
title: "Search for LinkedIn Profile"
method: POST
path: "/search_linkedin_profile"
tags: ["Search"]
---

# Search for LinkedIn Profile

`POST /search_linkedin_profile`

## Request

- Base URL: `https://api.moltsets.com/api/v1/tools`
- URL: `https://api.moltsets.com/api/v1/tools/search_linkedin_profile`
- Auth: HTTP bearer

The LinkedIn Profile Search API finds a person or company's LinkedIn profile from a name and company domain.

Pass a full name (MoltSets splits it into first and last name for you) or send `first_name` and `last_name` separately, then add the company as a domain, for example `acme.com`. URLs are normalised automatically, so there's no need to clean up your inputs first.

Run a free count first with `count_only: true` to see how many matches exist, then tighten or loosen your search before spending tokens. Full results are only charged when a match is actually found, so an empty search costs nothing.

**Use this endpoint to:**
- Confirm you have the right LinkedIn profile before enriching a contact
- Check match volume before running a bulk search
- Attach LinkedIn URLs to contact records that are missing one

**Fair Use Policy:**
This API is subject to our <a href="https://moltsets.com/fair-use-policy-search/" target="_blank" rel="noopener">Fair Use Policy for Search</a>.

**Outcomes:**
A lookup that finds nothing is not an error. It returns HTTP `200` with `status: "not_found"`, empty or null `results`, and the usual `metadata` — and costs no tokens, though it still counts as one request against your Fair Use requests limit. Read `status`, not the HTTP code, to tell a hit from a miss. The API's only `404` is an unknown or retired tool name.

## Headers

- `User-Agent` string, required

## Request body

- object
  - `name` string: Full name (e.g. 'John Smith') — parsed into first and last name automatically.
  - `first_name` string: First name (used if `name` is not provided).
  - `last_name` string: Last name (used if `name` is not provided).
  - `company` string: Company domain (e.g. 'acme.com') or URL (e.g. 'https://acme.com') — normalized to domain.
  - `company_domain` string: Alias for `company` — company domain or URL.
  - `count_only` boolean: Free — returns the count of matching results without fetching data or charging tokens. Use this first to gauge result volume before committing to a full search.

## Response `200`

Success

## Other responses

- `401`: Unauthorized
- `402`: Payment Required — insufficient tokens
- `403`: Forbidden — missing `User-Agent` header, tool not on the plan, or account inactive
- `422`: Invalid Input — malformed body, or a parameter is missing, malformed, or outside its allowed values
- `429`: Too Many Requests — rate limit or Fair Use window exhausted
- `500`: Internal Server Error — the call could not complete. Usually the endpoint is temporarily unavailable, but an oversized request can also cause it. Retry with a smaller request first; the MoltSets team is alerted automatically.

---

[API](https://skmtc.dev/moltsets/apis/moltsets-api.md) - [All operations](https://skmtc.dev/moltsets/apis/moltsets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moltsets/apis/moltsets-api/revisions/b116df68bd90?raw)