Skip to main content
Narrow down 900+ Bright Data Marketplace datasets across 900+ domains to the exact records and fields you need using the UI or API by creating filtered subsets and selecting the fields to include. What you can do:
  • Customize fields: choose which columns (fields) to include in your dataset view or export.
  • Filter a dataset: create a saved subset using filter rules.
Permissions: You need access to the dataset and permission to create subsets.

​
How to customize fields

Choose which fields (columns) appear in your Bright Data Marketplace dataset view and exports.
  1. Navigate to the dataset you want to work with.
  2. On the Data sample tab, click Edit table.
  3. Select the fields you want to include in the view.
  4. Click Apply, and save the view if prompted.
Expected result: The dataset preview and any export from this view include only the selected fields.

​
How to filter a dataset

Create a saved subset of a Bright Data Marketplace dataset by applying filter rules in the UI or through the API.

​
Filter a dataset using the UI

  1. Navigate to the dataset you want to filter.
  2. Click the Filter icon (top right).
  3. Enter a name so you can find this subset later.
  4. Under Include filters, add one or more filters (for example: country, job title, date).
  5. Click Create subset.
Expected result: A new subset appears with only the records that match your filters.

​
Filter operators reference

​
Select

Match one or more exact values from a predefined list (for example: countries or regions).

​
Boolean (true/false)

Filter fields that can only be true or false (for example: a field like verified).

​
Date

Filter records within a specific date range (start date and end date).

​
Number (operators)

  • Is: match an exact numeric value.
  • Not: exclude a numeric value.
  • Exists: include only records where the field is not empty.
  • List (exact match): match any value in a provided list.
  • Lower than / Lower or equal to: match values below (or up to) a threshold.
  • Greater than / Greater or equal to: match values above (or at) a threshold.

​
String

Filter text fields using the match types available in the UI (for example: exact match or contains).

​
Array

Use Array includes to match records where a multi-value (array) field contains a specific value (for example: categories, attributes or labels).

​
Upload a CSV list

If you need to match many values, use the CSV upload option in the value input. Upload a CSV with one value per row. CSV filtering limits depend on the filter type:
  • List (exact match): matches records where the field value exactly matches one of the uploaded values. Supports one CSV file up to 250 MB.
  • Includes: matches records where the field contains one of the uploaded values. Supports up to 100,000 values.

​
CSV upload limitations

  • CSV format: upload a .csv file with one value per row in a single column. CSV upload limits depend on the filter type:
    • List (exact match): supports one CSV file up to 250 MB. You do not need to split the CSV into multiple files unless the file exceeds 250 MB.
    • Includes: supports up to 100,000 values.
    No empty or whitespace-only lines: lines that contain only spaces are rejected. Single column only: the CSV must contain only one column. If you include a header, it must be a single column. One value per row: put exactly one filter value on each row. Do not comma-separate multiple values on the same row.

​
Includes vs List (exact match)

​
Includes

Use Includes to match records where the field contains the value you enter or upload. This is a partial match. Example: if the field is name and you filter with Includes = john, you match values like John Smith and Johnson. When using CSV upload with Includes, the CSV can contain up to 100,000 values.

​
List (exact match)

Use List (exact match) to match records where the field value is exactly one of the values in your list. This does not perform partial matching. Example: List (exact match) = John Smith, Jane Doe matches only those exact values. When using CSV upload with List (exact match), the CSV file can be up to 250 MB. A single CSV file can contain millions of values, depending on value length.

​
Group filters (rule-based filters)

  1. Click + Add filter.
  2. Select Add group.
  3. Define your group rules (for example: category is “Electronics” and brand is “Dell” or “Apple”).
Expected result: The subset includes only records that match your group logic.

​
Limitations

  • Filter groups can be nested up to 3 levels deep, with no limit on the number of sibling groups. See the filter syntax reference.
  • A maximum of four inputs per filter group is allowed.
  • To filter by more values, use a CSV list upload option if available. CSV limits depend on the filter type: List (exact match) supports one CSV file up to 250 MB, while Includes supports up to 100,000 values.
  • For more complex queries, contact your account manager.

​
Troubleshooting

  • I can’t see the Filter icon. Make sure you’re viewing the dataset table and that your account has permission to create subsets.
  • My subset returns no results. Remove filters one by one to identify the restrictive condition, then reapply the correct values and operators.

​
Next steps