Business Search API: search people

Search profiles with the Business Search API. The endpoint queries linkedin_people in 3 modes and returns up to 100 records per page.

POST /search/people

cURL

ludicrous

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"
          }
        }
      },
      {
        "equals": {
          "country_code": "US"
        }
      },
      {
        "range": {
          "followers": {
            ">=": 1000
          }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name",
      "current_title",
      "current_company_name",
      "location",
      "followers",
      "url"
    ]
  }
}
'

200

{
  "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
      }
    }
  ]
}

POST /search/people returns professional profile records that match your conditions.

Related: People search for worked examples and people field guidance, Business Search query syntax for the structured query operators and Business Search field views for the fields each view value returns.

Authorizations

Authorization · string · header · required

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

Body

application/json

mode · enum<string> · required

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

Available options: ludicrous, instant, smart

Example:

"instant"

query · string object · required

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.

Example:

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

Example:

"linkedin_company"

view · enum<string> object · default: 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. Each view's fields are listed in Business Search field views.

Available options: id_only, summary, full

offset · integer · default: 0

How many results to skip. Minimum 0. Ludicrous accepts values up to 10,000. In Instant and Smart, offset plus limit cannot exceed 100.

Required range: x >= 0

Example:

0

limit · integer · default: 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.

Required range: x >= 0

Example:

10

Response

200

application/json

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.

meta · object

Show child attributes

documents · object[]

The matching records for this page, in ranked order. Preserve this order rather than re-sorting.

Show child attributes