Bright Data Search Dataset
Search Bright Data's existing LinkedIn datasets for people profiles, contact-enriched people profiles, or company information that match your criteria. Provide dataset_id and a nonempty filter. The supported IDs are gd_l1viktl72bvl7bjuj0 (people profiles), gd_me5ppxjr2ge6icjuh0 (contact-enriched people profiles), and gd_l1vikfnt1wgvvqz95w (company information). Before searching, call list_dataset_fields for the chosen dataset to learn valid field names and types. Build a filter from a single condition {name, operator, value}, or combine conditions with {operator:"and"|"or", filters:[...]}. Groups must be nonempty, with nesting limited to depth 3. Supported condition operators are =, !=, <, <=, >, >=, in, not_in, includes, not_includes, array_includes, not_array_includes, is_null, and is_not_null. Omit value for the two null checks; otherwise supply a value compatible with the field and operator. The optional size is 1–10 records, defaulting to 10. Use sort to select default ordering, random ordering, or custom field ordering with asc/desc. To retrieve another page, use default or custom ordering and supply the search_after cursor from the previous response. Returns matching Bright Data dataset records directly, without a snapshot step. Record fields depend on the chosen dataset and the service response; a fixed output schema is not supplied. This search operates on existing datasets; use run_scraper when you need fresh collection from specific URLs.
Pricing
| Condition | Charge |
|---|---|
| Each call | 3 AE credits per record, based on actual returned records. |
The same rate applies to people profiles, contact-enriched people profiles, and company information datasets. Charges depend on the number of records actually returned, not the requested result limit. No charge applies when the filter returns no records.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
size | integer | No | Number of records to return (max 10, default 10) | 10 |
sort | string | array | No | Sorting: "default", "random", or a custom array like [{"timestamp":"asc"}]. Use "default" or custom sort to paginate with search_after. | — |
filter | object | unknown | Yes | Filter tree describing which records to match. Required, cannot be empty. | — |
filter.filters | array | Conditional | No parameter description. | — |
filter.filters[].filters | array | Conditional | No parameter description. | — |
filter.filters[].filters[].filters | array | Conditional | No parameter description. | — |
filter.filters[].filters[].filters[].name | string | Yes | Field name to filter on. Get valid field names from the list_dataset_fields tool. | — |
filter.filters[].filters[].filters[].value | string | number | boolean | array | No | Value to compare against. Omit for is_null / is_not_null. | — |
filter.filters[].filters[].filters[].operator | string | Yes | Filter operator, one of: =, !=, <, <=, >, >=, in, not_in, includes, not_includes, array_includes, not_array_includes, is_null, is_not_null | — |
filter.filters[].filters[].operator | enum (and | or) | Yes | No parameter description. | — |
filter.filters[].operator | enum (and | or) | Yes | No parameter description. | — |
filter.operator | enum (and | or) | Yes | No parameter description. | — |
dataset_id | enum (gd_l1viktl72bvl7bjuj0 | gd_me5ppxjr2ge6icjuh0 | gd_l1vikfnt1wgvvqz95w) | Yes | ID of the Bright Data dataset to search: gd_l1viktl72bvl7bjuj0 for LinkedIn people profiles, gd_me5ppxjr2ge6icjuh0 for contact-enriched LinkedIn people profiles, or gd_l1vikfnt1wgvvqz95w for LinkedIn company information. | — |
search_after | array | No | Pagination cursor from a previous response's search_after value. | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_brightdata_search_dataset' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"dataset_id": "gd_l1viktl72bvl7bjuj0",
"filter": {
"filters": [
{
"name": "country_code",
"operator": "=",
"value": "AE"
},
{
"name": "current_company_name",
"operator": "in",
"value": [
"Omnixon Global LLC-FZ",
"Omnixon Global",
"ICTECH Distribution LLC",
"ICTECH",
"Infome Technologies LLC",
"Infome Technologies",
"NetForChoice",
"Netforchoice",
"DSSD",
"Coinfast",
"Coinfast Group",
"CyrusMiner",
"Cyrus Miner",
"Techno Track Trading",
"TechnoTrack Trading",
"Tech Speed Computers Systems",
"Techspeed Computers Systems",
"BC Computers LLC",
"Biny Computers",
"Infinity IT Solutions LLC",
"Infinity IT Solutions"
]
}
],
"operator": "and"
},
"size": 10,
"sort": "default"
}
}'{
"hits": [
{
"about": null,
"activity": null,
"avatar": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
"id": "sonu-biny-416482166",
"name": "SONU BINY",
"url": "https://www.linkedin.com/in/sonu-biny-416482166"
}
],
"search_after": [
"664053714"
],
"took": 265,
"total_hits": 1
}This example shows part of the response. Copied content is valid JSON.

