> ## 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.

# 搜索用户

> 搜索LinkedIn用户

<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">每次请求</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">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</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("我想调用 KeyAPI 接口：GET https://api.keyapi.ai/v1/linkedin/search_people\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/linkedin/search_people\n\nDescription: LinkedIn 的「用户搜索」接口用于按关键词、地区或筛选条件检索数据，返回匹配结果、核心指标和分页信息。适用于数据采集、监测、分析和业务自动化。可结合接口参数进行筛选或分页查询。\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- name (Optional): name 参数. Example: john\n- first_name (Optional): first_name 参数. Example: john\n- last_name (Optional): last_name 参数. Example: oliver\n- title (Optional): title 参数. Example: manager\n- company (Optional): company 参数\n- school (Optional): school 参数\n- page (Optional): 页码. Example: 1\n- geocode_location (Optional): geocode_location 参数. Example: 103644278\n- current_company (Optional): current_company 参数\n- profile_language (Optional): profile_language 参数\n- industry (Optional): industry 参数\n- service_category (Optional): service_category 参数\n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"page\": 1,\n    \"total\": 97,\n    \"has_more\": true,\n    \"data\": [\n      {\n        \"id\": \"18380620\",\n        \"urn\": \"ACoAAAEYd0wBlnBvs_IFDBqMXSjdP1QUYUOnP3I\",\n        \"url\": \"https://www.linkedin.com/in/johnkoliver\",\n        \"public_identifier\": \"johnkoliver\",\n        \"full_name\": \"John K. Oliver\",\n        \"title\": \"Advertising, Events, Branding and Communications\",\n        \"location\": \"San Francisco Bay Area\",\n        \"is_premium\": true,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"168074402\",\n        \"urn\": \"ACoAAAoEnKIBIBebVBNZ4-fhIIC0P7eH1l1S4Y0\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-34235548\",\n        \"public_identifier\": \"john-oliver-34235548\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Operations Manager | Brokerage Leader | 13 Years of Industry Experience | Building Strong Client & Carrier Partnerships\",\n        \"location\": \"Nashville, TN\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"223058512\",\n        \"urn\": \"ACoAAA1LmlABpme7d1H47meazo-1lyQ4a9mzfts\",\n        \"url\": \"https://www.linkedin.com/in/john-l-oliver\",\n        \"public_identifier\": \"john-l-oliver\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"NA RME Planning Manager @ Amazon | Organizational Leadership, Problem Solving\",\n        \"location\": \"United States\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"87580240\",\n        \"urn\": \"ACoAAAU4XlABiPFlvi4N_gyVG9cyIOnVlQ0q8Sc\",\n        \"url\": \"https://www.linkedin.com/in/john06\",\n        \"public_identifier\": \"john06\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Sr. Program Manager: Procure to Pay, Travel & Expenses and Global Payments @ Verily (Alphabet) | Procurement, Supply Chain Management and Operations.\",\n        \"location\": \"Austin, Texas Metropolitan Area\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"370953003\",\n        \"urn\": \"ACoAABYcSysByLmCikdcB7qg2Si4bwVfq-rOhCM\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-a63293a4\",\n        \"public_identifier\": \"john-oliver-a63293a4\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Inspiring Servant Leader | Building High-Performing Teams | Driving Results & Identifying Waste | Fostering Collaboration | Eliminating Risk\",\n        \"location\": \"San Antonio, TX\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"133370821\",\n        \"urn\": \"ACoAAAfzE8UBAATgZBT-G5PFRtA8jNRAdyOUifo\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-2317ba38\",\n        \"public_identifier\": \"john-oliver-2317ba38\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Manager of Maintenance Planning & Scheduling at Liggett Vector Brands\",\n        \"location\": \"Greensboro, NC\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      },\n      {\n        \"id\": \"559366084\",\n        \"urn\": \"ACoAACFXP8QBKiURKOCrLP8cDWDoIgyhZTgQ4p0\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-2843b7137\",\n        \"public_identifier\": \"john-oliver-2843b7137\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Account Manager at Coca-Cola Beverages Florida\",\n        \"location\": \"Tampa, FL\",\n        \"is_premium\": false,\n        \"services\": []\n      },\n      {\n        \"id\": \"308762529\",\n        \"urn\": \"ACoAABJnV6EBl5mTDQJ6a6a3lvMLmIiGxm1EISo\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-0294a287\",\n        \"public_identifier\": \"john-oliver-0294a287\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"TAM life / AWS\",\n        \"location\": \"Greater Minneapolis-St. Paul Area\",\n        \"is_premium\": false,\n        \"services\": []\n      },\n      {\n        \"id\": \"243172981\",\n        \"urn\": \"ACoAAA5-hnUB0ea_Y7MDk6gn7Ig7_AbnMMcZogs\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-13153169\",\n        \"public_identifier\": \"john-oliver-13153169\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"Drainage and Flood Control Analyses and Design\",\n        \"location\": \"Tucson, AZ\",\n        \"is_premium\": false,\n        \"services\": []\n      },\n      {\n        \"id\": \"161731618\",\n        \"urn\": \"ACoAAAmj1CIB8qQ_Pn44n45LFmsSWa6SM0RLg9Q\",\n        \"url\": \"https://www.linkedin.com/in/john-oliver-82a1b646\",\n        \"public_identifier\": \"john-oliver-82a1b646\",\n        \"full_name\": \"John Oliver\",\n        \"title\": \"ESG Strategy and Program Manager at AWS\",\n        \"location\": \"Baltimore, MD\",\n        \"is_premium\": false,\n        \"avatar\": [\n          {\n            \"width\": 100,\n            \"height\": 100,\n            \"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\",\n            \"expires_at\": 1774483200000\n          }\n        ],\n        \"services\": []\n      }\n    ]\n  },\n  \"requestId\": \"f087669e-6947-4509-a4c0-65f1a837495d\"\n}\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/linkedin.zh.openapi.json GET /v1/linkedin/search_people
openapi: 3.0.1
info:
  title: LinkedIn API 中文文档
  description: LinkedIn API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security:
  - JWT Bearer: []
tags: []
paths:
  /v1/linkedin/search_people:
    get:
      tags: []
      summary: 搜索用户
      description: 搜索LinkedIn用户
      parameters:
        - name: name
          in: query
          description: 搜索关键词
          required: false
          example: john
          schema:
            type: string
        - name: first_name
          in: query
          description: 名
          required: false
          example: john
          schema:
            type: string
        - name: last_name
          in: query
          description: 姓
          required: false
          example: oliver
          schema:
            type: string
        - name: title
          in: query
          description: 职位
          required: false
          example: manager
          schema:
            type: string
        - name: company
          in: query
          description: 公司
          required: false
          schema:
            type: string
        - name: school
          in: query
          description: 学校
          required: false
          schema:
            type: string
        - name: page
          in: query
          description: 页码，默认为1
          required: false
          example: 1
          schema:
            type: integer
            default: 1
        - name: geocode_location
          in: query
          description: 地理位置代码
          required: false
          example: '103644278'
          schema:
            type: string
        - name: current_company
          in: query
          description: 当前公司ID
          required: false
          schema:
            type: string
        - name: profile_language
          in: query
          description: 个人资料语言
          required: false
          schema:
            type: string
        - name: industry
          in: query
          description: 行业ID
          required: false
          schema:
            type: string
        - name: service_category
          in: query
          description: 服务类别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: 请求参数错误，请检查必填字段和参数格式
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: 账户余额或额度不足
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: 请求过于频繁，已触发限流
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: 服务器内部错误，请稍后重试
          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: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````