Perform API LinkedIn search and export result

You have the ability to make searches on Classic, Sales Navigator, or Recruiter to get people, companies, jobs, or posts list results with the same criteria as the LinkedIn interface, on behalf of each account depending on the LinkedIn subscription.

That can be useful to extract a list of people to start an outreach sequence on your target, export a list of companies in a specific sector, location, or other criteria, search for the LinkedIn profile of someone with their name and company, list mutual relations with someone to ask for a warm intro, search for open profiles in Sales Navigator, run advanced candidate searches in Recruiter, search for posts that contain specific keywords, and many other use cases. Most things you can do manually on LinkedIn search can be automated.

We propose two ways to perform search: you can copy paste the URL of a search directly from your browser, or you can construct parameter values in your app and send a request with all those values in your postpress query.

Please have a look at the LinkedIn limitations about this endpoint.

Perform a search from copy/paste URL

You can copy paste a URL from any search result, saved search, or list of leads.

curl --request POST \
     --url 'https://api.postpress.ai/api/v1/linkedin/search?account_id={YOUR_ACCOUNT_ID}' \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "url": "https://www.linkedin.com/sales/search/people?query=(recentSearchParam%3A(id%3A3623570490%2CdoLogHistory%3Atrue)%2Cfilters%3AList((type%3AFUNCTION%2Cvalues%3AList((id%3A3%2Ctext%3AArts%2520and%2520Design%2CselectionType%3AINCLUDED)%2C(id%3A6%2Ctext%3AConsulting%2CselectionType%3AEXCLUDED)))%2C(type%3ACOMPANY_TYPE%2Cvalues%3AList((id%3AC%2Ctext%3APublic%2520Company%2CselectionType%3AINCLUDED)))))&sessionId=SsMfcb5pSmeVeTNnPOPxaw%3D%3D&viewAllFilters=true"
}'

Perform a search on basic fixed-value parameters

Example: search people on Sales Navigator with overall seniority from 5 years and English profile language.

curl --request POST \
     --url 'https://api.postpress.ai/api/v1/linkedin/search?account_id={YOUR_ACCOUNT_ID}' \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "api": "sales_navigator",
  "category": "people",
  "keywords": "developer",
  "tenure": [{ "min": 3 }],
  "profile_language": ["en"]
}'

Example: classic search to retrieve companies that have job offers, located in areas matching specific location IDs.

1 - Search for location IDs with parameters that match your text location

curl --request GET \
     --url 'https://api.postpress.ai/api/v1/linkedin/search/parameters?account_id={YOUR_ACCOUNT_ID}&type=LOCATION&keywords=los%20angeles&limit=100' \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json'

2 - Use this ID to perform the search

Example: search companies on classic that have job offers in two specific locations.

curl --request POST \
     --url 'https://api.postpress.ai/api/v1/linkedin/search?account_id={YOUR_ACCOUNT_ID}' \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "api": "classic",
  "category": "companies",
  "has_job_offers": true,
  "location": [102277331, 102448103]
}'

Example: search people on Recruiter whose role should be either developer OR engineer, whose skills should include 50517 (Typescript skill ID) and exclude 261 (PHP skill ID), whose industry includes 4 (Software Development industry ID), and who are first-, second-, or third-degree connections.

curl --request POST \
     --url 'https://api.postpress.ai/api/v1/linkedin/search?account_id={YOUR_ACCOUNT_ID}' \
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "api": "recruiter",
  "category": "people",
  "network_distance": [1, 2, 3],
  "industry": { "include": ["4"] },
  "role": [
    {
      "keywords": "developer OR engineer",
      "priority": "MUST_HAVE",
      "scope": "CURRENT_OR_PAST"
    }
  ],
  "skills": [
    { "id": "261",   "priority": "DOESNT_HAVE" },
    { "id": "50517", "priority": "MUST_HAVE" }
  ]
}'

Examples of results

Parameter search

{
  "object": "LinkedinSearchParametersList",
  "items": [
    { "object": "LinkedinSearchParameter", "title": "Technology, Information and Internet", "id": "6" },
    { "object": "LinkedinSearchParameter", "title": "Climate Technology Product Manufacturing", "id": "3251" },
    { "object": "LinkedinSearchParameter", "title": "Space Research and Technology", "id": "3089" },
    { "object": "LinkedinSearchParameter", "title": "Technical and Vocational Training", "id": "2018" },
    { "object": "LinkedinSearchParameter", "title": "Technology, Information and Media", "id": "1594" }
  ],
  "paging": { "page_count": 5 }
}

Search for Companies on Sales Navigator

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "COMPANY",
      "id": "103848457",
      "name": "Softwares For MLM",
      "profile_url": "https://www.linkedin.com/sales/company/103848457",
      "summary": "SFM specializes in delivering cutting-edge MLM software solutions...",
      "industry": "Software Development",
      "location": null,
      "headcount": "0"
    }
  ],
  "config": {
    "params": {
      "api": "sales_navigator",
      "category": "companies",
      "keywords": "softwares",
      "industry": { "include": [6] }
    }
  },
  "paging": { "start": 0, "page_count": 5, "total_count": 4886 },
  "cursor": "eyJhY2NvdW50X2lkIjoiOFJma0txU0tSTy1JbXpKT2k4T1I1USIsImxpbWl0Ijo1LCJzdGFydCI6NSwicGFyYW1zIjp7ImFwaSI6InNhbGVzX25hdmlnYXRvciIsImNhdGVnb3J5IjoiY29tcGFuaWVzIiwia2V5d29yZHMiOiJzb2Z0d2FyZXMiLCJpbmR1c3RyeSI6eyJpbmNsdWRlIjpbNl19fX0="
}

Search for People on Sales Navigator

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "PEOPLE",
      "id": "ACwAAASNCJcBS2NERCgi0j_f7_oYqCSbTGsNYBc",
      "industry": null,
      "name": "Luciano Bana",
      "first_name": "Luciano",
      "last_name": "Bana",
      "member_urn": "urn:li:member:76351639",
      "public_identifier": "luciano-bana-b876a021",
      "public_profile_url": "https://www.linkedin.com/in/luciano-bana-b876a021",
      "profile_url": "https://www.linkedin.com/sales/lead/ACwAAASNCJcBS2NERCgi0j_f7_oYqCSbTGsNYBc,NAME_SEARCH,NqOz",
      "network_distance": "DISTANCE_3",
      "location": "United States",
      "headline": "Building relationships one Hi-rise at a time...",
      "pending_invitation": false,
      "premium": true,
      "open_profile": true,
      "current_positions": [
        {
          "company": "Hudson Meridian Construction Group",
          "company_id": null,
          "role": "Sr Vice President of Construction",
          "tenure_at_company": { "years": 10 },
          "tenure_at_role": { "years": 10 }
        }
      ]
    }
  ],
  "config": { "params": { "api": "sales_navigator", "category": "people", "keywords": "sales" } },
  "paging": { "start": 0, "page_count": 5, "total_count": 25438 },
  "cursor": "..."
}

Search for People on Classic

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "PEOPLE",
      "id": "ACoAAAdHsOUBYtAunOfY0wJIbiwgewolov5X55M",
      "name": "Piyush Narwani",
      "member_urn": "urn:li:member:122138853",
      "profile_url": "https://www.linkedin.com/in/piyushnarwani",
      "network_distance": "DISTANCE_2",
      "location": "San Francisco, CA",
      "headline": "Co-Founder, Aerotime (YC W21)"
    },
    {
      "type": "PEOPLE",
      "id": "ACoAABT_1jMBUFFpMOvZAwTn9srI5NfD-buVuJA",
      "name": "Catherine Wu",
      "member_urn": "urn:li:member:352310835",
      "profile_url": "https://www.linkedin.com/in/cat-wu",
      "network_distance": "DISTANCE_2",
      "location": "San Francisco, CA",
      "headline": "Partner at Index Ventures"
    }
  ],
  "config": {
    "params": {
      "api": "classic",
      "category": "people",
      "location": [102277331, 102448103]
    }
  },
  "paging": { "start": 0, "page_count": 10, "total_count": 1000 },
  "cursor": "..."
}

Search for Companies on Classic

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "COMPANY",
      "id": "165158",
      "name": "Netflix",
      "profile_url": "https://www.linkedin.com/company/netflix/",
      "industry": "Entertainment Providers",
      "location": "Los Gatos, CA",
      "followers_count": 11000000,
      "job_offers_count": 427
    },
    {
      "type": "COMPANY",
      "id": "1441",
      "name": "Google",
      "profile_url": "https://www.linkedin.com/company/google/",
      "industry": "Software Development",
      "location": "Mountain View, CA",
      "followers_count": 34000000,
      "job_offers_count": 12
    }
  ],
  "config": {
    "params": {
      "api": "classic",
      "category": "companies",
      "has_job_offers": true,
      "location": [102277331, 102448103]
    }
  },
  "paging": { "start": 0, "page_count": 10, "total_count": 1000 },
  "cursor": "..."
}

Search for People on Recruiter

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "PEOPLE",
      "id": "AEMAAAQMevMBKmy0KNdlNZA1bV_xR06DjBJ47bY",
      "headline": "Software Engineer at LinkedIn",
      "location": "New York, New York, United States",
      "network_distance": "OUT_OF_NETWORK",
      "can_send_inmail": true,
      "recruiter_candidate_id": "67926771",
      "current_positions": [
        {
          "company": "LinkedIn",
          "company_id": "1337",
          "role": "Software Engineer",
          "start": { "month": 4, "year": 2019 }
        }
      ]
    }
  ],
  "config": {
    "params": {
      "api": "recruiter",
      "category": "people",
      "network_distance": [1, 2, 3],
      "industry": { "include": ["4"] },
      "role": [
        { "keywords": "developer OR engineer", "priority": "MUST_HAVE", "scope": "CURRENT_OR_PAST" }
      ],
      "skills": [
        { "id": "261",   "priority": "DOESNT_HAVE" },
        { "id": "50517", "priority": "MUST_HAVE" }
      ]
    }
  },
  "paging": { "start": 0, "page_count": 3, "total_count": 4433432 },
  "cursor": "..."
}

Search for Posts on Classic

{
  "object": "LinkedinSearch",
  "items": [
    {
      "type": "POST",
      "provider": "LINKEDIN",
      "social_id": "urn:li:activity:7236734771807019010",
      "share_url": "https://www.linkedin.com/posts/beau-atkins-105a273b_top-ten-tuesday-essential-reads-for-activity-7236734771807019010-3qVO",
      "parsed_datetime": "2024-09-03T14:02:20.213Z",
      "comment_counter": 2,
      "reaction_counter": 2,
      "repost_counter": 0,
      "permissions": { "can_post_comments": true, "can_react": true, "can_share": true },
      "text": "Top Ten Tuesday: Essential Reads for Finding Presence ...",
      "attachments": [
        {
          "id": "D5622AQGhe9HN1jjc5A",
          "type": "img",
          "size": { "height": 1536, "width": 1152 }
        }
      ],
      "author": {
        "public_identifier": "beau-atkins-105a273b",
        "name": "Beau Atkins",
        "is_company": false,
        "headline": "CEO at Evolve Family Law"
      },
      "is_repost": false,
      "id": "7236734771807019010"
    }
  ],
  "config": {
    "params": {
      "api": "classic",
      "category": "posts",
      "keywords": "boosting productivity",
      "sort_by": "date",
      "date_posted": "past_week",
      "content_type": "images",
      "author": { "keywords": "CEO" }
    }
  },
  "paging": { "start": 0, "page_count": 10, "total_count": 6 },
  "cursor": "..."
}
Updated May 2026