Business Search API: search companies

curl --request POST \
  --url https://api.brightdata.com/search/company \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "linkedin_company",
  "mode": "ludicrous",
  "query": {
    "and": [
      {
        "text": {
          "industry": "software"
        }
      },
      {
        "equals": {
          "headquarters_country_code": "US"
        }
      },
      {
        "range": {
          "employees_in_linkedin": {
            ">=": 50,
            "<=": 500
          }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name",
      "website",
      "industry",
      "headquarters_country_code",
      "employees_in_linkedin",
      "founded_year",
      "linkedin_followers",
      "url"
    ]
  }
}
'

{
  "req_id": "example_request_id",
  "source": "linkedin_company",
  "meta": {
    "matched": 42,
    "coverage_percent": 100,
    "offset": 0,
    "limit": 10
  },
  "documents": [
    {
      "bright_id": "example-company-id",
      "data": {
        "name": "Example Software Company",
        "website": "https://example.com",
        "industry": "Software Development",
        "headquarters_country_code": "US",
        "employees_in_linkedin": 284,
        "linkedin_followers": 12500
      }
    }
  ]
}

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

company

curl --request POST \
  --url https://api.brightdata.com/search/company \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": "linkedin_company",
  "mode": "ludicrous",
  "query": {
    "and": [
      {
        "text": {
          "industry": "software"
        }
      },
      {
        "equals": {
          "headquarters_country_code": "US"
        }
      },
      {
        "range": {
          "employees_in_linkedin": {
            ">=": 50,
            "<=": 500
          }
        }
      }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name",
      "website",
      "industry",
      "headquarters_country_code",
      "employees_in_linkedin",
      "founded_year",
      "linkedin_followers",
      "url"
    ]
  }
}
'

{
  "req_id": "example_request_id",
  "source": "linkedin_company",
  "meta": {
    "matched": 42,
    "coverage_percent": 100,
    "offset": 0,
    "limit": 10
  },
  "documents": [
    {
      "bright_id": "example-company-id",
      "data": {
        "name": "Example Software Company",
        "website": "https://example.com",
        "industry": "Software Development",
        "headquarters_country_code": "US",
        "employees_in_linkedin": 284,
        "linkedin_followers": 12500
      }
    }
  ]
}

{
  "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/company returns company records that match your conditions. Related: Company search for worked examples and company field guidance, and Business Search query syntax for the structured query operators.

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

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

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.

Available options:

id_only,

summary,

full

offset

integer

default:0

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

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

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.

Essentials

Data extraction

Web search

AI training data

Proxy

Administrative APIs

Business Search API: search companies

Authorizations

Body

Response