> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Business Search field views

> Choose what each Business Search record returns: id_only, summary, full or a custom list, the stored fields per entity type and the values rejected.

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:

<CodeGroup>
  ```bash cURL highlight={17} theme={null}
  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"]
      }
    }'
  ```

  ```python Python highlight={23} theme={null}
  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)
  ```

  ```javascript Node.js highlight={20} theme={null}
  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());
  ```
</CodeGroup>

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](/products/business-search/error-codes#why-was-a-request-rejected).

<Warning>
  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.
</Warning>