Bright Data Search Dataset

Usage-based pricing
ae_brightdata_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.

Social
Usage-based pricing

Pricing

ConditionCharge
Each call3 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.

ParameterTypeRequiredDescriptionDefault
sizeintegerNoNumber of records to return (max 10, default 10)10
sortstring | arrayNoSorting: "default", "random", or a custom array like [{"timestamp":"asc"}]. Use "default" or custom sort to paginate with search_after.—
filterobject | unknownYesFilter tree describing which records to match. Required, cannot be empty.—
filter.filtersarrayConditionalNo parameter description.—
filter.filters[].filtersarrayConditionalNo parameter description.—
filter.filters[].filters[].filtersarrayConditionalNo parameter description.—
filter.filters[].filters[].filters[].namestringYesField name to filter on. Get valid field names from the list_dataset_fields tool.—
filter.filters[].filters[].filters[].valuestring | number | boolean | arrayNoValue to compare against. Omit for is_null / is_not_null.—
filter.filters[].filters[].filters[].operatorstringYesFilter operator, one of: =, !=, <, <=, >, >=, in, not_in, includes, not_includes, array_includes, not_array_includes, is_null, is_not_null—
filter.filters[].filters[].operatorenum (and | or)YesNo parameter description.—
filter.filters[].operatorenum (and | or)YesNo parameter description.—
filter.operatorenum (and | or)YesNo parameter description.—
dataset_idenum (gd_l1viktl72bvl7bjuj0 | gd_me5ppxjr2ge6icjuh0 | gd_l1vikfnt1wgvvqz95w)YesID 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_afterarrayNoPagination cursor from a previous response's search_after value.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.