Skip to main content
GET
/
linkedin
/
service-search
Search LinkedIn profile services
curl --request GET \
  --url https://api.harvest-api.com/linkedin/service-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    {
      "publicIdentifier": "<string>",
      "id": "<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>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.harvestapi.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Examples

const params = new URLSearchParams({
  search: 'Web Development',
  location: 'Australia',
  page: '1',
});
fetch(`https://api.harvest-api.com/linkedin/service-search?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

​
Search by LinkedIn GeoID

For most of the cases, when specifying full location name, the search by the location parameter works fine.
However sometimes search by location may not give you what you expect, as LinkedIn have some other suggested location for your text query. For example, NY returns New Zealand instead of New York; UK returns Ukraine instead of United Kingdom. The location search is based on LinkedIn autocomplete feature, you can try it on the website first. The scraper will use the first suggestion from the autocomplete popup when you type your location. The same autocomplete is available via our API. You can look up a location and get LinkedIn GeoID to use for the API endpoint. 
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.entityId);

    // Search for profiles in New York
    const params = new URLSearchParams({
      geoId: data.entityId,
      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<url>
required

Search profiles by name

​
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

Profile search response

​
elements
object[]
​
pagination
object
​
status
string
​
error
string
​
query
object