Search LinkedIn

GEThttps://api.acme.com/api/brand/search/linkedin

Available on Business, Enterprise plans.

Search for LinkedIn companies or people based on a search query. This endpoint is commonly used for typeahead mention completion in social media posts.

The linked account must be a LinkedIn company page to search. Personal LinkedIn accounts can not be used to perform searches.

For mentions in posts: When implementing @mentions, use this endpoint with typeahead functionality.
Company search: The exact company vanity name is required.
Person search: Start with at least 3 characters of a name for best results.
Rate limiting: This endpoint follows standard API rate limits.

Search Limitations

Companies: You can search for any LinkedIn company page
People: You can only search for people who are followers of your LinkedIn account and the ACME linked account must be a LinkedIn company page to perform the search. If a person has their LinkedIn visibility set to private, they will not be found in the search results.

Header Parameters

Authorizationstringrequired

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Keystring

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Query Parameters

searchstringrequired

Search query to find LinkedIn companies or people.

Requirements:

Minimum length: 3 characters for people and 1 character for companies.
Maximum length: 100 characters for both people and companies.

Search behavior:

For companies: Use the company's vanity name (found in the LinkedIn URL). Only exact vanity name matches will be returned.
- Example: For linkedin.com/company/acme, search for "acme".
- Searching for partial names like "ayrsh" will NOT return results.
For people: Use first name and/or last name. Partial name matches are supported.
- Example: "John Smith" will find people named John Smith. Be sure to URL encode the space.
- Partial matches like "Joh" or "Smi" will also return results.
- Remember: Only your LinkedIn followers can be found and the ACME linked account must be a LinkedIn company page to perform the search

personOnlybooleandefault: false

Controls the search scope: - false (default): Searches for companies first, then people if no companies are found. - true: Searches only for people (skips company search entirely).

Examples

const API_KEY = "API_KEY";

// Search for company or person
fetch("https://api.acme.com/api/brand/search/linkedin?search=acme", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

// Search for person only
fetch("https://api.acme.com/api/brand/search/linkedin?search=John%20Smith&personOnly=true", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`
  }
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

{
  "linkedin": {
    "action": "request",
    "status": "error",
    "code": 101,
    "message": "Missing or incorrect parameters. Please verify with the docs. https://www.acme.com/docs/apis",
    "details": "The search must be a string between 3 and 100 characters."
  }
}