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

# Search people

> Search LinkedIn users

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">1 credit</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">per request</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`I want to make an API call to https://api.keyapi.ai/v1/linkedin/search_people.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/linkedin/search_people

Description: Search LinkedIn users

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- name (Optional): Search keyword. Example: john
- first_name (Optional): First name. Example: john
- last_name (Optional): Last name. Example: oliver
- title (Optional): Job title. Example: manager
- company (Optional): Company
- school (Optional): School
- page (Optional): Page number, default is 1. Example: 1
- geocode_location (Optional): Geographic location code. Example: 103644278
- current_company (Optional): Current company ID
- profile_language (Optional): Profile language
- industry (Optional): Industry ID
- service_category (Optional): Service category ID

Example Response:
{
"code": 0,
"message": "success",
"data": {
"page": 1,
"total": 97,
"has_more": true,
"data": [
  {
    "id": "18380620",
    "urn": "ACoAAAEYd0wBlnBvs_IFDBqMXSjdP1QUYUOnP3I",
    "url": "https://www.linkedin.com/in/johnkoliver",
    "public_identifier": "johnkoliver",
    "full_name": "John K. Oliver",
    "title": "Advertising, Events, Branding and Communications",
    "location": "San Francisco Bay Area",
    "is_premium": true,
    "avatar": [
      {
        "width": 100,
        "height": 100,
        "url": "https://media.licdn.com/dms/image/v2/D5603AQFR4ooByXSaew/profile-displayphoto-scale_100_100/B56ZigUcE3HUAc-/0/1755036369608?e=1774483200&v=beta&t=qUclaV9JHyCN9RgMuPcSiVF-GCkYu31tJ7FHX-AFmC0",
        "expires_at": 1774483200000
      }
    ],
    "services": []
  },
  {
    "id": "168074402",
    "urn": "ACoAAAoEnKIBIBebVBNZ4-fhIIC0P7eH1l1S4Y0",
    "url": "https://www.linkedin.com/in/john-oliver-34235548",
    "public_identifier": "john-oliver-34235548",
    "full_name": "John Oliver",
    "title": "Operations Manager | Brokerage Leader | 13 Years of Industry Experience | Building Strong Client & Carrier Partnerships",
    "location": "Nashville, TN",
    "is_premium": false,
    "avatar": [
      {
        "width": 100,
        "height": 100,
        "url": "https://media.licdn.com/dms/image/v2/C4D03AQHIzrL7Bnw
... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/linkedin.openapi.json GET /v1/linkedin/search_people
openapi: 3.0.1
info:
  title: LinkedIn API english documentation
  description: >-
    The english reference documentation of the LinkedIn API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security:
  - JWT Bearer: []
tags: []
paths:
  /v1/linkedin/search_people:
    get:
      tags: []
      summary: Search people
      description: Search LinkedIn users
      parameters:
        - name: name
          in: query
          description: Search keyword
          required: false
          example: john
          schema:
            type: string
        - name: first_name
          in: query
          description: First name
          required: false
          example: john
          schema:
            type: string
        - name: last_name
          in: query
          description: Last name
          required: false
          example: oliver
          schema:
            type: string
        - name: title
          in: query
          description: Job title
          required: false
          example: manager
          schema:
            type: string
        - name: company
          in: query
          description: Company
          required: false
          schema:
            type: string
        - name: school
          in: query
          description: School
          required: false
          schema:
            type: string
        - name: page
          in: query
          description: Page number, default is 1
          required: false
          example: 1
          schema:
            type: integer
            default: 1
        - name: geocode_location
          in: query
          description: Geographic location code
          required: false
          example: '103644278'
          schema:
            type: string
        - name: current_company
          in: query
          description: Current company ID
          required: false
          schema:
            type: string
        - name: profile_language
          in: query
          description: Profile language
          required: false
          schema:
            type: string
        - name: industry
          in: query
          description: Industry ID
          required: false
          schema:
            type: string
        - name: service_category
          in: query
          description: Service category ID
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  page: 1
                  total: 97
                  has_more: true
                  data:
                    - id: '18380620'
                      urn: ACoAAAEYd0wBlnBvs_IFDBqMXSjdP1QUYUOnP3I
                      url: https://www.linkedin.com/in/johnkoliver
                      public_identifier: johnkoliver
                      full_name: John K. Oliver
                      title: Advertising, Events, Branding and Communications
                      location: San Francisco Bay Area
                      is_premium: true
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/D5603AQFR4ooByXSaew/profile-displayphoto-scale_100_100/B56ZigUcE3HUAc-/0/1755036369608?e=1774483200&v=beta&t=qUclaV9JHyCN9RgMuPcSiVF-GCkYu31tJ7FHX-AFmC0
                          expires_at: 1774483200000
                      services: []
                    - id: '168074402'
                      urn: ACoAAAoEnKIBIBebVBNZ4-fhIIC0P7eH1l1S4Y0
                      url: https://www.linkedin.com/in/john-oliver-34235548
                      public_identifier: john-oliver-34235548
                      full_name: John Oliver
                      title: >-
                        Operations Manager | Brokerage Leader | 13 Years of
                        Industry Experience | Building Strong Client & Carrier
                        Partnerships
                      location: Nashville, TN
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/C4D03AQHIzrL7BnwDNQ/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1646696448535?e=1774483200&v=beta&t=yGnhtwwVnmlGhORpJ3kDv_BuGyb8wm7QIhEJjMMoybw
                          expires_at: 1774483200000
                      services: []
                    - id: '223058512'
                      urn: ACoAAA1LmlABpme7d1H47meazo-1lyQ4a9mzfts
                      url: https://www.linkedin.com/in/john-l-oliver
                      public_identifier: john-l-oliver
                      full_name: John Oliver
                      title: >-
                        NA RME Planning Manager @ Amazon | Organizational
                        Leadership, Problem Solving
                      location: United States
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/C4E03AQGy7NLKRY0WiA/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1547214410106?e=1774483200&v=beta&t=wDPpALBF1IRtZcz5dFEB88ScAQzhRTNUmfVvNZc5wTs
                          expires_at: 1774483200000
                      services: []
                    - id: '87580240'
                      urn: ACoAAAU4XlABiPFlvi4N_gyVG9cyIOnVlQ0q8Sc
                      url: https://www.linkedin.com/in/john06
                      public_identifier: john06
                      full_name: John Oliver
                      title: >-
                        Sr. Program Manager: Procure to Pay, Travel & Expenses
                        and Global Payments @ Verily (Alphabet) | Procurement,
                        Supply Chain Management and Operations.
                      location: Austin, Texas Metropolitan Area
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/D5603AQHALp3Wx75_3Q/profile-displayphoto-scale_100_100/B56ZlOjmp_KMAg-/0/1757959580959?e=1774483200&v=beta&t=LD--NzTh4Ox6-ZWgqYj4_GPsqD_NXPmpH3eDlKVJqU0
                          expires_at: 1774483200000
                      services: []
                    - id: '370953003'
                      urn: ACoAABYcSysByLmCikdcB7qg2Si4bwVfq-rOhCM
                      url: https://www.linkedin.com/in/john-oliver-a63293a4
                      public_identifier: john-oliver-a63293a4
                      full_name: John Oliver
                      title: >-
                        Inspiring Servant Leader | Building High-Performing
                        Teams | Driving Results & Identifying Waste | Fostering
                        Collaboration | Eliminating Risk
                      location: San Antonio, TX
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/D5603AQGCQREELicm6g/profile-displayphoto-scale_100_100/B56ZhCLv0MHcAc-/0/1753457033835?e=1774483200&v=beta&t=UZuQdm4gmZZ_nQp2VqiZM-xZ4ACFlV4muNX-OEO2lUs
                          expires_at: 1774483200000
                      services: []
                    - id: '133370821'
                      urn: ACoAAAfzE8UBAATgZBT-G5PFRtA8jNRAdyOUifo
                      url: https://www.linkedin.com/in/john-oliver-2317ba38
                      public_identifier: john-oliver-2317ba38
                      full_name: John Oliver
                      title: >-
                        Manager of Maintenance Planning & Scheduling at Liggett
                        Vector Brands
                      location: Greensboro, NC
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/C5603AQHcfMRZgWoYgA/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1628292453971?e=1774483200&v=beta&t=yFKXKKYHfIlO4wNh_edoy8P0AGPmCX48noQJBUD85Io
                          expires_at: 1774483200000
                      services: []
                    - id: '559366084'
                      urn: ACoAACFXP8QBKiURKOCrLP8cDWDoIgyhZTgQ4p0
                      url: https://www.linkedin.com/in/john-oliver-2843b7137
                      public_identifier: john-oliver-2843b7137
                      full_name: John Oliver
                      title: Account Manager at Coca-Cola Beverages Florida
                      location: Tampa, FL
                      is_premium: false
                      services: []
                    - id: '308762529'
                      urn: ACoAABJnV6EBl5mTDQJ6a6a3lvMLmIiGxm1EISo
                      url: https://www.linkedin.com/in/john-oliver-0294a287
                      public_identifier: john-oliver-0294a287
                      full_name: John Oliver
                      title: TAM life / AWS
                      location: Greater Minneapolis-St. Paul Area
                      is_premium: false
                      services: []
                    - id: '243172981'
                      urn: ACoAAA5-hnUB0ea_Y7MDk6gn7Ig7_AbnMMcZogs
                      url: https://www.linkedin.com/in/john-oliver-13153169
                      public_identifier: john-oliver-13153169
                      full_name: John Oliver
                      title: Drainage and Flood Control Analyses and Design
                      location: Tucson, AZ
                      is_premium: false
                      services: []
                    - id: '161731618'
                      urn: ACoAAAmj1CIB8qQ_Pn44n45LFmsSWa6SM0RLg9Q
                      url: https://www.linkedin.com/in/john-oliver-82a1b646
                      public_identifier: john-oliver-82a1b646
                      full_name: John Oliver
                      title: ESG Strategy and Program Manager at AWS
                      location: Baltimore, MD
                      is_premium: false
                      avatar:
                        - width: 100
                          height: 100
                          url: >-
                            https://media.licdn.com/dms/image/v2/C5603AQFzhsDPWdUsOg/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1517424506807?e=1774483200&v=beta&t=L8KMIbBj3ZLsO1J92rFor--37IMLaVKVI7ApEYPX10A
                          expires_at: 1774483200000
                      services: []
                requestId: f087669e-6947-4509-a4c0-65f1a837495d
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/linkedin/search_people?name=john&first_name=john&last_name=oliver&title=manager&page=1&geocode_location=103644278' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/linkedin/search_people',
                params={"name": "john", "first_name": "john", "last_name": "oliver", "title": "manager", "page": 1, "geocode_location": "103644278"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"name": "john", "first_name":
            "john", "last_name": "oliver", "title": "manager", "page": 1,
            "geocode_location": "103644278"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/linkedin/search_people?${params}`, {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````