Business Search field views

The view property of a Business Search request controls which stored fields appear in each result’s data object. The property is part of the request body for each entity type.

Which values does view accept?

View	Returned data
`id_only`	Identifiers only: `company_id` and `linkedin_id` for companies, `linkedin_num_id` and `linkedin_person_id` for people
`summary`	A compact category-specific record: 14 fields for companies, 11 for people
`full`	Every released field: 30 for companies, 36 for people
`{ "fields": [...] }`	Only the named released fields

id_only is the default and returns identifiers rather than descriptive fields. The fields object has one required property, fields, an array of released field names. Any field in the company or people table on this page is a released field. This request returns eight company fields per record:

curl --request POST "https://api.brightdata.com/search/company" \
  --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
  --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"]
    }
  }'

import os
import requests

response = requests.post(
    "https://api.brightdata.com/search/company",
    headers={
        "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "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"]
        },
    },
)

print(response.text)

const response = await fetch("https://api.brightdata.com/search/company", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    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"],
    },
  }),
});

console.log(await response.text());

The array can name fields from any view, so founded_year, which summary leaves out, can be returned without requesting full.

Which fields does each view return for companies?

Field	`id_only`	`summary`	`full`
`company_id`	Yes	-	-
`linkedin_id`	Yes	-	Yes
`name`	-	Yes	Yes
`slogan`	-	Yes	Yes
`industry`	-	Yes	Yes
`headquarters_location`	-	Yes	Yes
`headquarters_country_code`	-	Yes	Yes
`offices_cities`	-	Yes	Yes
`company_size_from`	-	Yes	Yes
`company_size_to`	-	Yes	Yes
`employees_in_linkedin`	-	Yes	Yes
`linkedin_followers`	-	Yes	Yes
`website`	-	Yes	Yes
`domain`	-	Yes	Yes
`url`	-	Yes	Yes
`logo`	-	Yes	Yes
`about`	-	-	Yes
`specialties`	-	-	Yes
`organization_type`	-	-	Yes
`founded_year`	-	-	Yes
`headquarters_city`	-	-	Yes
`offices_country_codes`	-	-	Yes
`alumni_count`	-	-	Yes
`linkedin_follower_to_employee_ratio`	-	-	Yes
`funding_stage`	-	-	Yes
`funding_raised`	-	-	Yes
`investor_names`	-	-	Yes
`similar_company_ids`	-	-	Yes
`affiliated_company_ids`	-	-	Yes
`crunchbase_id`	-	-	Yes
`image`	-	-	Yes

Which fields does each view return for people?

Field	`id_only`	`summary`	`full`
`linkedin_num_id`	Yes	-	Yes
`linkedin_person_id`	Yes	-	Yes
`name`	-	Yes	Yes
`current_title`	-	Yes	Yes
`current_company_name`	-	Yes	Yes
`current_company_industry`	-	Yes	Yes
`location`	-	Yes	Yes
`city`	-	Yes	Yes
`country_code`	-	Yes	Yes
`followers`	-	Yes	Yes
`connections`	-	Yes	Yes
`url`	-	Yes	Yes
`avatar`	-	Yes	Yes
`first_name`	-	-	Yes
`about`	-	-	Yes
`recommendations_count`	-	-	Yes
`influencer`	-	-	Yes
`patent_count`	-	-	Yes
`current_tenure_months`	-	-	Yes
`experience_years`	-	-	Yes
`past_job_titles`	-	-	Yes
`past_company_names`	-	-	Yes
`past_company_ids`	-	-	Yes
`education_schools`	-	-	Yes
`education_details`	-	-	Yes
`certification_names`	-	-	Yes
`languages`	-	-	Yes
`current_company_id`	-	-	Yes
`current_company_specialties`	-	-	Yes
`current_company_country_code`	-	-	Yes
`current_company_size_from`	-	-	Yes
`current_company_size_to`	-	-	Yes
`current_company_funding_stage`	-	-	Yes
`current_company_funding_raised`	-	-	Yes
`similar_profile_ids`	-	-	Yes
`also_viewed_ids`	-	-	Yes

A field the record has no value for is left out of data rather than returned as null. Two records from the same request can carry different keys, and a full record usually carries fewer keys than the table lists. bright_id is an envelope field beside data on every record and is not selected through view.

Which view values are rejected?

Business Search rejects an unknown view name or an unreleased field name with HTTP 400. The error property names the rejected value:

Sent value	Error
`"view": "bogus_view"`	`view: unknown view profile "bogus_view"`
`"view": { "fields": ["not_a_released_field"] }`	`view: unknown field(s): not_a_released_field`

The other request body rejections are listed in Business Search error codes.

A field you select for output does not become a search condition. Requesting founded_year in view does not exclude companies that have no founding year on record.

Get started

Data extraction

Web search

AI training data

Proxy networks

Which values does view accept?

Which fields does each view return for companies?

Which fields does each view return for people?

Which view values are rejected?

​Which values does view accept?

​Which fields does each view return for companies?

​Which fields does each view return for people?

​Which view values are rejected?

Which values does view accept?

Which fields does each view return for companies?

Which fields does each view return for people?

Which view values are rejected?