> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search People

> Search LinkedIn people profiles. Reliability notes: `data.items: null` can mean a transient LinkedIn-side failure, a query that is too broad, or pagination past LinkedIn's accessible result window. Always retry null responses before treating them as definitive. `start: 0` is unusually flaky; prefer `start: 10` as the first practical page or retry page 0 with `start: 10`. Use bounded pagination with `start` values from 10 through about 990 and do not request `start >= 1000`. Keep searches narrow, ideally below roughly 10,000 reported total results, by combining 2-3 specific filters. Broad searches such as keywordTitle alone, geo alone, a large company alone, or first/last name alone often return a populated total with null items. For large companies, add firstName, lastName, or a specific keywordTitle. Do not treat `total` as an exact count; it is a fluctuating LinkedIn estimate. You may see fewer than 10 results per page because LinkedIn hides some profiles and the endpoint filters those hidden profiles from the returned items.



## OpenAPI

````yaml /openapi/linkedin.openapi.json get /v1/data/linkedin/search-people
openapi: 3.0.0
info:
  title: agntdata LinkedIn API
  description: Enrich profile and company data in real-time
  version: 1.0.0
  contact:
    name: agntdata
    url: https://agntdata.dev
servers:
  - url: https://api.agntdata.dev
    description: agntdata API
security:
  - ApiKeyAuth: []
tags:
  - name: Post
    description: ''
  - name: Article API
    description: ''
  - name: Location
    description: ''
  - name: System
    description: ''
  - name: Company
    description: ''
  - name: Profile APIs
    description: ''
  - name: Job APIs
    description: ''
paths:
  /v1/data/linkedin/search-people:
    get:
      tags:
        - Profile APIs
      summary: Search People
      description: >-
        Search LinkedIn people profiles. Reliability notes: `data.items: null`
        can mean a transient LinkedIn-side failure, a query that is too broad,
        or pagination past LinkedIn's accessible result window. Always retry
        null responses before treating them as definitive. `start: 0` is
        unusually flaky; prefer `start: 10` as the first practical page or retry
        page 0 with `start: 10`. Use bounded pagination with `start` values from
        10 through about 990 and do not request `start >= 1000`. Keep searches
        narrow, ideally below roughly 10,000 reported total results, by
        combining 2-3 specific filters. Broad searches such as keywordTitle
        alone, geo alone, a large company alone, or first/last name alone often
        return a populated total with null items. For large companies, add
        firstName, lastName, or a specific keywordTitle. Do not treat `total` as
        an exact count; it is a fluctuating LinkedIn estimate. You may see fewer
        than 10 results per page because LinkedIn hides some profiles and the
        endpoint filters those hidden profiles from the returned items.
      operationId: Search_People
      parameters:
        - name: firstName
          in: query
          required: false
          schema:
            type: string
        - name: geo
          in: query
          required: false
          schema:
            type: string
            default: 103644278,101165590
          description: please follow this to find location id
        - name: keywordTitle
          in: query
          required: false
          schema:
            type: string
        - name: start
          in: query
          required: false
          schema:
            type: string
            default: '0'
          description: it could be one of these; 0, 10, 20, 30, etc.
        - name: lastName
          in: query
          required: false
          schema:
            type: string
        - name: company
          in: query
          required: false
          schema:
            type: string
          description: Company name
        - name: keywordSchool
          in: query
          required: false
          schema:
            type: string
        - name: keywords
          in: query
          required: false
          schema:
            type: string
            default: max
        - name: schoolId
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get_linkedin_search_people_Response'
              example:
                success: true
                message: ''
                data:
                  total: 1000
                  items:
                    - fullName: Max Lopez
                      headline: Retired!! Ex Network Engineer
                      summary: ''
                      profilePicture: ''
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/max-lopez-7605972
                      username: max-lopez-7605972
                    - fullName: Max Borges
                      headline: President
                      summary: 'Current: President at Max Borges Agency'
                      profilePicture: >-
                        https://media.licdn.com/dms/image/C5103AQFcJuzITg30Sg/profile-displayphoto-shrink_100_100/0/1516244431418?e=1716422400&v=beta&t=blcfS-4axNvmr69VGCTZukn8SIFbRC9DWC7vi4WHNIU
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/max-borges-3ab2781
                      username: max-borges-3ab2781
                    - fullName: Max Brackett
                      headline: CIO/CTO/CISO
                      summary: 'Past: ..., PEO at Max Brackett Technology'
                      profilePicture: >-
                        https://media.licdn.com/dms/image/C5603AQH76ckRWmqmmw/profile-displayphoto-shrink_100_100/0/1517687003262?e=1716422400&v=beta&t=ZBAFxxdBBn7iZQBPf3qIVwEJEPQkvnWEccnwh2oNnkE
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/maxbrackett
                      username: maxbrackett
                    - fullName: Max Padilla
                      headline: President at MP Aircraft Enterprises, Inc.
                      summary: ''
                      profilePicture: ''
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/max-padilla-12209646
                      username: max-padilla-12209646
                    - fullName: Max Herbst
                      headline: BS Political Science at Florida Atlantic University
                      summary: ''
                      profilePicture: >-
                        https://media.licdn.com/dms/image/D4E03AQELm1pruJqCGA/profile-displayphoto-shrink_100_100/0/1707776110320?e=1716422400&v=beta&t=_LViMG69I2kD8E2UwPmgfkhk5dr-LftEwJbtoLLxziI
                      location: Miami-Fort Lauderdale Area
                      profileURL: https://www.linkedin.com/in/max-herbst-4a97b61b4
                      username: max-herbst-4a97b61b4
                    - fullName: Max Wahba
                      headline: Founder & CEO at Techsalerator
                      summary: ''
                      profilePicture: >-
                        https://media.licdn.com/dms/image/D4E03AQHkRCX1GAfueg/profile-displayphoto-shrink_100_100/0/1710174223104?e=1716422400&v=beta&t=5ytwgZvLem0vcH22hgNBttV1aWvRtqz5gnJqrkXSLOs
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/max-wahba-ba3604154
                      username: max-wahba-ba3604154
                    - fullName: Max Ball
                      headline: Co Founder @ Lofty (Y Combinator S19)
                      summary: ''
                      profilePicture: >-
                        https://media.licdn.com/dms/image/C5603AQFmMcXaYaBgaw/profile-displayphoto-shrink_100_100/0/1623906529733?e=1716422400&v=beta&t=cDDybeoK0wChJvS3uCth8enp-uMWq3yE4IehB49IYg8
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/maxball
                      username: maxball
                    - fullName: Rene-Max Landrin
                      headline: >-
                        Passionate and Driven Entry-Level Security Analyst |
                        Dedicated to Safeguarding Digital Assets | Cybersecurity
                        Enthusiast Ready to Make an Impact
                      summary: ''
                      profilePicture: >-
                        https://media.licdn.com/dms/image/C4E03AQEHE--DY_GuXw/profile-displayphoto-shrink_100_100/0/1583883592966?e=1716422400&v=beta&t=pjDBQZzt5vjeUa7u4L8kffvB4-ejBlWToYjKA2P0P-o
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/rene-max
                      username: rene-max
                    - fullName: Max Solomianyi
                      headline: >-
                        E-commerce and Digital Marketing Manager with over 15
                        years of hands-on experience. Skilled in leading teams
                        and growing sales across different e-commerce
                        marketplaces and platforms.
                      summary: ''
                      profilePicture: ''
                      location: Miami, FL
                      profileURL: https://www.linkedin.com/in/max-solomianyi-9986792b7
                      username: max-solomianyi-9986792b7
                    - fullName: Max Maurer
                      headline: Founder at Ghast Games Studio
                      summary: ''
                      profilePicture: >-
                        100_100/0/1688972718991?e=1716422400&v=beta&t=k2LeS8PRSLNECGuK6tn6Dwmwaz3zCrFJZLw1uEv8rsM
                      location: Cape Coral, FL
                      profileURL: https://www.linkedin.com/in/max-maurer-58a941282
                      username: max-maurer-58a941282
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Get_linkedin_search_people_Response:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          properties:
            total:
              type: integer
            items:
              type: array
              items:
                type: object
                properties:
                  fullName:
                    type: string
                  headline:
                    type: string
                  summary:
                    type: string
                  profilePicture:
                    type: string
                  location:
                    type: string
                  profileURL:
                    type: string
                  username:
                    type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Bearer token. Pass your agntdata API key as: Authorization: Bearer
        agnt_live_...

````