Linkedin Profiles API (V1)

The Linkedin Profiles API lets you find up to 500 Linkedin user profiles - all of which are based on your keyword/search query. Its best use-case is to find profiles that have your query in bio, profile subtitle, or have engaged with content related to your search term within the past year.

Endpoint cost is 1 credit / profile for successful requests

Pricing Note:

While we aim to provide you with the exact number of results you request. In some cases, certain restrictions will cause the number of returned results to be less than requested. Example: No more rows to be found OR duplicate removal.

You will only pay per result delivered. If you request 50 profiles and get 49, you will only be charged for 49.

Result Relevancy

Profiles are returned based on their relevancy to your search query. The more relevant a profile is, the higher it will be in the returned response.

Input Processing

To keep your query from breaking or returning unexpected results, we sanitize your input as follows:

Leading and trailing empty spaces are removed: ' foo ' --> 'foo'
Multiple consecutive spaces are collapsed: 'foo bar' --> 'foo bar'
The characters " : ( ) are not allowed

Request Parameters

API Endpoint: POST https://api.serpgrid.dev/v1/serps/linkedin-profiles
Required headers: X-API-KEY and Content-Type

Parameter	Description
query	Your search term The following characters are NOT allowed: `" : ( )` `Min length: 3 characters` `Max length: 35 characters`
strict	Boolean field denoting whether you want the search to be an exact character match `Default: false` `Accepts: true, 1 , false, 0`
results	The maximum number of rows to be returned if found Must be provided as a multiple of 10 `Default: 10` `Min: 10` & `Max: 500`

Strictness

Strictness indicates whether the search engine should use exact character matching or keep the default fuzzy search - by default strictness is disabled.

Ex. If you're searching for profiles marked as SEO Consultant, enabling strictness may be a good idea. However, when looking for SEO Consultant in Canada, keeping it disabled will yield more results as there are very few profiles with that exact sequence of characters.

Execution Time:

Due to the nature of how we request, parse, and sanitize these results in realtime for you, the larger number of results you request, the longer this endpoint will take.

Our target running time for the maximum result count of 500 is ~4-7 seconds.

Useful Tips

For best results, try searching for segmented target audience groups such as SEO Consultant or Web Designer.

Note: Running the same query multiple times will often generated identical results. You are therefore encouraged to find a set of keywords or queries that are of interest and run them in series.

Example: If you're interested in finding SEO consultant, you can run that as your first query, and later on run a separate request for SEO Agency or perhaps SEO Consultant New York.

Request Example 1

Linkedin Profiles Request

Linkedin Profiles Response

//Example Response
{
  "http_code": 200,
  "http_message": "Ok",
  "timestamp": 1754364768,
  "execution_ms": 1389,
  "message": "Successful execution",
  "payload": {
    "linkedin": {
      "parameters": {
        "query": "growth marketer",
        "strict": true,
        "results": 10,
        "found": 9
      },
      "results": {
        "profiles": [
          {
            "user": "samantha-contreras-barrera",
            "name": "Samantha Contreras, MBA",
            "about": "My Growth Marketer",
            "subtitle": "Sacramento, California, United States · My Growth Marketer",
            "snippet": "I am a seasoned marketing executive and business strategist with over a decade of… · Experience: My Growth Marketer · Education: University of California, ...",
            "url": "https://linkedin.com/in/samantha-contreras-barrera"
          },
          {
            "user": "neilpatel992",
            "name": "Neil Patel",
            "about": "Growth Marketing Lead and Consultant",
            "subtitle": "",
            "snippet": "I work with software startups and help set up marketing infrastructure that accelerates growth. Growth Vertical has 1 full-time growth marketer (me)",
            "url": "https://linkedin.com/in/neilpatel992"
          },
          {
            "user": "jake-dmochowski",
            "name": "Jake Dmochowski",
            "about": "Growth Marketer | MBA Candidate at ...",
            "subtitle": "Brooklyn, New York, United States · Director, Growth & Forecasting · WeightWatchers",
            "snippet": "Growth Marketer | MBA Candidate at NYU Stern · Agile growth/performance marketer with an expertise in digital acquisition - media buying; landing-page ...",
            "url": "https://linkedin.com/in/jake-dmochowski"
          },
          {
            "user": "jaymehoy",
            "name": "Jayme Hoy",
            "about": "Growth Marketer | Media Strategist",
            "subtitle": "Reno, Nevada, United States · Director of Performance Marketing · Intrepid Digital",
            "snippet": "Growth Marketer | Media Strategist | Passionate Team Leader · Passionate & data-driven business leader with over a decade of paid media strategy experience ...",
            "url": "https://linkedin.com/in/jaymehoy"
          },
          {
            "user": "quharrison-terry-728b3a89",
            "name": "QuHarrison Terry",
            "about": "International Best-Selling Author",
            "subtitle": "",
            "snippet": "QuHarrison Terry is an influencer. International Best-Selling Author | Growth Marketer | 4x LinkedIn Top Voice in Tech. VNM USA University of Wisconsin-Madison ...",
            "url": "https://linkedin.com/in/quharrison-terry-728b3a89"
          },
          {
            "user": "sakshipatel8251",
            "name": "Sakshi Patel",
            "about": "Growth Marketer | Early-Stage GTM & ...",
            "subtitle": "State College, Pennsylvania, United States · Marketing Expert · Home Genius Exteriors",
            "snippet": "Growth Marketer | Early-Stage GTM & Performance Strategy | 3x Pipeline Growth | Wellness, SaaS, AI · I'm a growth-obsessed marketer with 5+ years of ...",
            "url": "https://linkedin.com/in/sakshipatel8251"
          },
          {
            "user": "enrortegon",
            "name": "Enrique Ortegon",
            "about": "Growth Marketer - MDC Data Centers",
            "subtitle": "McAllen, Texas, United States · Growth Marketer · MDC Data Centers",
            "snippet": "Experience ; Growth Marketer. MDC Data Centers. Apr 2024 - Present 1 year 4 months ; Marketing Communication Manager. Acclaim Energy. Aug 2019 - Apr 2024 4 years ...",
            "url": "https://linkedin.com/in/enrortegon"
          },
          {
            "user": "randyschwartz2",
            "name": "Randy Schwartz",
            "about": "Data Design Lead, AI Co ...",
            "subtitle": "New York, New York, United States · Advisory Board Member · feedfeed",
            "snippet": "Data Design Lead, AI Co-Lead... Growth Marketer and Digital Strategist · Entrepreneurial, highly progressive Strategic, data-first digital leader with 20+ ...",
            "url": "https://linkedin.com/in/randyschwartz2"
          },
          {
            "user": "reem-sheikh",
            "name": "Reem S.",
            "about": "Marketing Strategist | Growth Marketer",
            "subtitle": "",
            "snippet": "Marketing Strategist | Growth Marketer | Brand Management | MS Integrated Marketing - NYU · I was born and brought up in Kuwait, but my roots are Indian.",
            "url": "https://linkedin.com/in/reem-sheikh"
          }
        ]
      }
    }
  }
}

Additional Information

The following headers will also be returned as part of the response to you:

X-Credits-Remaining The number of credits that remain in your account
X-Credits-Expire A datetime string with the expiration date
X-Credits-Used The number of credits the operation consumed

Errors are handled in line with our Error Rules. Please make sure to read it carefully and follow the instructions for the best experience possible.