GET
/
linkedin
/
profile-search
Search LinkedIn profiles
curl --request GET \
  --url https://api.harvest-api.com/linkedin/profile-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    {
      "id": "<string>",
      "publicIdentifier": "<string>",
      "name": "<string>",
      "position": "<string>",
      "location": {
        "linkedinText": "<string>"
      },
      "linkedinUrl": "<string>",
      "photo": "<string>",
      "hidden": true
    }
  ],
  "pagination": {
    "totalPages": 123,
    "totalElements": 123,
    "pageNumber": 123,
    "previousElements": 123,
    "pageSize": 123,
    "paginationToken": "<string>"
  },
  "status": "<string>",
  "error": "<string>",
  "query": {
    "search": "<string>",
    "companyId": "<string>",
    "location": "<string>",
    "geoId": "<string>",
    "page": "<string>"
  }
}
const params = new URLSearchParams({
  search: 'Mark',
  companyId: '1441',
  location: 'Australia',
  page: '1',
});
fetch(`https://api.harvest-api.com/linkedin/profile-search?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

​
How to get Company ID

​
By company URL or ID

const params = new URLSearchParams({
  query: 'https://www.linkedin.com/company/google',
  // query: 'google', // 'google' is also accepted as a company ID (last part of the URL)
  apiKey: '<api-key>',
});

fetch(`https://api.harvest-api.com/linkedin/company?${params.toString()}`)
  .then((res) => res.json())
  .then((data) => {
    const company = data.element;
    console.log(`LinkedIn ID for Google: ${company?.id}`);
  });

​
By searching for a company name

const params = new URLSearchParams({
  search: 'Google',
  apiKey: '<api-key>',
});

fetch(`https://api.harvest-api.com/linkedin/company-search?${params.toString()}`)
  .then((res) => res.json())
  .then((data) => {
    const companies = data.elements;
    const firstMatchId = companies[0].id;
    console.log(`LinkedIn ID for Google: ${firstMatchId}`);
  });

​
Search by LinkedIn GeoID

For most of the cases, when specifying full location name, the search by the location parameter should work fine.
However sometimes search by location may not give you what you expect, as LinkedIn have some other location for your text query. For example, NY returns New Zealand as first match instead of New York (it’s based on LinkedIn autocomplete feature, you can try it in UI).

To make sure the location is correct, you can fetch LinkedIn GeoID first and check it. GeoID search is free, it will not count against your quota.

const apiKey = '<api-key>';

fetch(`https://api.harvest-api.com/linkedin/geo-id-search?search=New York`, {
  headers: { 'X-API-Key': apiKey },
})
  .then((response) => response.json())
  .then((data) => {
    console.log('All matches:', data.elements);
    console.log('Closest match GeoID:', data.id);

    // Search for profiles in New York
    const params = new URLSearchParams({
      geoId: data.id,
      apiKey,
    });
    fetch(`https://api.harvest-api.com/linkedin/profile-search?${params.toString()}`)
      .then((response) => response.json())
      .then((data) => console.log(data));
  });

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
search
string
required

Search profiles by name

​
companyId
string

Filter by company ID. One value or multiple comma-separated

​
schoolId
string

Filter by school ID. One value or multiple comma-separated

​
location
string

Filter by location text

​
geoId
string

Filter by location as LinkedIn Geo ID. Overrides the location query param. Use the /linkedin/geo-id-search endpoint to find the Geo ID

​
page
string

Page number, use for pagination

Response

200
application/json

Profile search response

The response is of type object.