Business Search API：搜索人物

curl --request POST \
  --url https://api.brightdata.com/search/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "linkedin_people",
  "mode": "ludicrous",
  "query": {
    "and": [
      {
        "text": {
          "all_text": {
            "value": "product manager",
            "mode": "all-or-top-bm25"
          }
        }
      },
      {
        "equals": {
          "country_code": "US"
        }
      },
      {
        "range": {
          "followers": {
            ">=": 1000
          }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name",
      "current_title",
      "current_company_name",
      "location",
      "followers",
      "url"
    ]
  }
}
'

{
  "req_id": "example_request_id",
  "source": "linkedin_people",
  "meta": {
    "matched": 18,
    "coverage_percent": 100,
    "offset": 0,
    "limit": 10
  },
  "documents": [
    {
      "bright_id": "example-profile-id",
      "data": {
        "name": "Example Person",
        "current_title": "Senior Product Manager",
        "current_company_name": "Example Software Company",
        "location": "Austin, Texas",
        "followers": 3200
      }
    }
  ]
}

{
  "error": "view: unknown field(s): not_a_released_field"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "Too many search requests, try again shortly"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

POST

people

curl --request POST \
  --url https://api.brightdata.com/search/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "linkedin_people",
  "mode": "ludicrous",
  "query": {
    "and": [
      {
        "text": {
          "all_text": {
            "value": "product manager",
            "mode": "all-or-top-bm25"
          }
        }
      },
      {
        "equals": {
          "country_code": "US"
        }
      },
      {
        "range": {
          "followers": {
            ">=": 1000
          }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name",
      "current_title",
      "current_company_name",
      "location",
      "followers",
      "url"
    ]
  }
}
'

{
  "req_id": "example_request_id",
  "source": "linkedin_people",
  "meta": {
    "matched": 18,
    "coverage_percent": 100,
    "offset": 0,
    "limit": 10
  },
  "documents": [
    {
      "bright_id": "example-profile-id",
      "data": {
        "name": "Example Person",
        "current_title": "Senior Product Manager",
        "current_company_name": "Example Software Company",
        "location": "Austin, Texas",
        "followers": 3200
      }
    }
  ]
}

{
  "error": "view: unknown field(s): not_a_released_field"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "Too many search requests, try again shortly"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

{
  "error": "view: unknown field(s): not_a_released_field",
  "error_code": "invalid_query"
}

POST /search/people 返回符合条件的职业档案记录。相关指南：人物搜索提供示例与人物字段说明，Business Search 查询语法提供结构化查询运算符。

授权

Authorization

string

header

必填

Your Bright Data API key, sent as Authorization: Bearer YOUR_API_KEY. Create one in the Bright Data Control Panel. See Authentication.

请求体

application/json

mode

enum<string>

必填

How the query is interpreted. ludicrous takes a structured JSON object. instant and smart take a natural-language string.

可用选项:

ludicrous,

instant,

smart

示例:

"instant"

query

必填

A structured object for ludicrous, or a string for instant and smart. Changing mode between ludicrous and a natural-language mode also changes the type of this property.

示例:

"US software companies with 50 to 500 employees"

source

string

The dataset to search within the category. Defaults to the category's default source: linkedin_company for /search/company and linkedin_people for /search/people.

示例:

"linkedin_company"

view

默认值:id_only

Which stored fields appear in each result's data object. Accepts id_only, summary, full, or an object with a fields array. Defaults to id_only, which returns identifiers rather than descriptive fields. view does not change the search conditions.

可用选项:

id_only,

summary,

full

offset

integer

默认值:0

How many results to skip. Minimum 0, no maximum.

必填范围: x >= 0

示例:

0

limit

integer

默认值:10

The requested maximum number of results in this page. Minimum 0, default 10. The maximum depends on the mode: 100 for ludicrous, 100 for instant and 10 for smart. The returned documents array can be shorter than the value you send.

必填范围: x >= 0

示例:

10

响应

The search ran. documents can be empty when nothing matched.

req_id

string

Identifies the request. Include it in support tickets.

source

string

The source that was searched.

基础

数据提取

网页搜索

AI 训练数据

代理

管理 API

Business Search API：搜索人物

授权

请求体

响应