--- title: "Bright Data" description: "One account API key. Zones and the Product Hunt collector are found on the account." --- > Documentation Index > Fetch the complete documentation index at: https://help.tooluse.net/llms.txt > Use this file to discover all available pages before exploring further. # Bright Data

One account API key. Zones and the Product Hunt collector are found on the account.

What you can do (23)

What you can do

Available commands: 23 (23 read, 0 write). Enable only the commands your application needs.

Command Effect
Read Google or Bing search results — brightdata.serp-search Read
Read one public LinkedIn job posting — brightdata.linkedin-jobs Read
Discover LinkedIn jobs by company and keyword — brightdata.linkedin-jobs-discover Read
Collect commerce product records — brightdata.commerce-dataset Read
Discover Reddit posts by subreddit or keyword — brightdata.reddit-posts-discover Read
Collect comments on Reddit posts — brightdata.reddit-comments Read
Collect one public X post — brightdata.x-posts-collect Read
Collect public Threads posts or discover a bounded profile batch — brightdata.threads-posts-collect Read
Collect YouTube videos — brightdata.youtube-videos Read
Discover YouTube videos — brightdata.youtube-videos-discover Read
Collect YouTube comments — brightdata.youtube-comments Read
Fetch a page as Markdown text — brightdata.web-unlocker Read
Read Product Hunt page — brightdata.product-hunt-collect Read
Business Search company (ludicrous) — brightdata.business-search.company.ludicrous Read
Business Search company (instant) — brightdata.business-search.company.instant Read
Business Search company (smart) — brightdata.business-search.company.smart Read
Business Search people (ludicrous) — brightdata.business-search.people.ludicrous Read
Business Search people (instant) — brightdata.business-search.people.instant Read
Business Search people (smart) — brightdata.business-search.people.smart Read
Read an existing dataset snapshot — brightdata.dataset-snapshot-read Read
Discover X posts and accounts — brightdata.x-discovery Read
Submit one bounded public X community collection — brightdata.x-community-collect Read
Read one public professional profile — brightdata.linkedin-profile Read

Connect and use

Connect and use

Open the integration's connection form to check the available credential source. The source has not been resolved for this documentation export. The instructions below apply when using your own provider account.

Get your provider credentials

Follow these steps for Bright Data, then enter the issued values in the connection form below.

  1. Sign in to Bright Data, open account API-token settings and create an API token with the permissions your selected products need. Copy it into the connection's API Key field.

Official credential setup

Where to enter credentials

In the integration page, sign in, choose your workspace and open Connect. If a Credentials choice is shown, select Use my credentials. Fill the following connection fields and save. Provider credentials belong in this form, never in an MCP configuration or tool input.

Connection field Requirement
API Key Required
Web Unlocker zone Optional

Open API keys and create a Tooluse.net key for the enabled commands.

Set TOOLUSE_API_KEY in your client and use the shared MCP configuration.

Configure Claude Code, Codex or Cursor once

Permissions and results

If you have more than one workspace, check the selected workspace in the connection or API-key dialog before saving. Roles, enabled commands, expiry and revocation use Tooluse.net's existing permissions. Disabling a connection or revoking a key immediately prevents new calls.

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Your connection's daily allowance and key permissions also apply. Adding a connection does not make a provider request.

Calls return the shared execution receipt and a Claude tool_result. Provider output varies by operation; consult the provider documentation for its response fields. Unconfirmed calls should be checked before retrying.

Call from your client

Use the shared MCP configuration. Refresh your client's tool list after saving the connection or changing key permissions, then call the returned tool name with the example input below.

Configure Claude Code, Codex or Cursor once

Discover your enabled tools

List permitted tools in Claude format. Read every page using page and size (maximum 100) until all results have been received. Use the returned name, not a catalog capability identifier, in the tool_use block.

curl 'https://api.tooluse.net/v1/tools' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"

Find this command in the tool list permitted by your key. Replace svc_FROM_YOUR_TOOL_LIST with its returned name. Use a new Idempotency-Key for each new call and retain it when retrying that same call.

HTTP call

curl 'https://api.tooluse.net/v1/tool-calls' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-new-call-id' \
  --data '{
  "type": "tool_use",
  "id": "toolu_example",
  "name": "svc_FROM_YOUR_TOOL_LIST",
  "input": {
    "targetUrl": "https://www.google.com/search?q=Kestra&num=5&hl=en"
  }
}'

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Commands

Read one public LinkedIn job posting — brightdata.linkedin-jobs

Run Read one public LinkedIn job posting with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
targetUrl string Required Public LinkedIn job posting URL minLength: 1; maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://www.linkedin.com/jobs/view/4310512612/"
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Discover LinkedIn jobs by company and keyword — brightdata.linkedin-jobs-discover

Run Discover LinkedIn jobs by company and keyword with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
keyword string Required Job keyword minLength: 1; maxLength: 200
location string Required Job location minLength: 1; maxLength: 200
company string Required Company filter minLength: 1; maxLength: 200
country string Optional Two-letter country code pattern: "^[A-Za-z]{2}$"
limitRecords integer Required Maximum job records minimum: 1; maximum: 10

Full JSON Schema

Full JSON Schema

Example input

{
  "keyword": "software engineer",
  "location": "Taipei",
  "company": "1641286",
  "country": "TW",
  "limitRecords": 10
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect commerce product records — brightdata.commerce-dataset

Run Collect commerce product records with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
dataset string Required Registered commerce dataset enum: ["amazon-products","ebay-products","walmart-products","google-play-apps","google-play-reviews"]
mode string Required Collect product URLs or discover by keyword enum: ["collect","keyword"]
values array Required Product URLs or keywords minItems: 1; maxItems: 20
values[] string Optional minLength: 2; maxLength: 2048
limitPerInput integer Optional Records per input minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "dataset": "amazon-products",
  "mode": "collect",
  "values": [
    "https://www.amazon.com/dp/B0CHX1W1XY"
  ],
  "limitPerInput": 1
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Discover Reddit posts by subreddit or keyword — brightdata.reddit-posts-discover

Run Discover Reddit posts by subreddit or keyword with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
subreddits array Optional Subreddits to discover minItems: 1; maxItems: 5
subreddits[] object Optional additionalProperties: false
subreddits[].url string Required Subreddit URL minLength: 1; maxLength: 2048; format: "uri"
subreddits[].sortBy string Optional Sort order enum: ["hot","new","top"]
subreddits[].estimatedRecords integer Optional Expected posts minimum: 1; maximum: 100
queries array Optional Keyword queries minItems: 1; maxItems: 1
queries[] object Optional additionalProperties: false
queries[].keyword string Required Keyword minLength: 2; maxLength: 120
queries[].date string Optional Date filter enum: ["Past hour","Past day","Past week","Past month","Past year","All time"]
queries[].limit integer Optional Posts per keyword minimum: 1; maximum: 5

Full JSON Schema

Full JSON Schema

Example input

{
  "subreddits": [
    {
      "url": "https://www.reddit.com/r/kestra/",
      "sortBy": "hot",
      "estimatedRecords": 5
    }
  ]
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect comments on Reddit posts — brightdata.reddit-comments

Run Collect comments on Reddit posts with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
urls array Required Reddit post URLs minItems: 1; maxItems: 1
urls[] string Optional Public Reddit URL minLength: 1; maxLength: 2048; format: "uri"
daysBack integer Optional Comment age in days minimum: 1; maximum: 365
estimatedRecords integer Optional Expected comments minimum: 1; maximum: 40

Full JSON Schema

Full JSON Schema

Example input

{
  "urls": [
    "https://www.reddit.com/r/kestra/comments/abc123/"
  ],
  "daysBack": 30,
  "estimatedRecords": 40
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect one public X post — brightdata.x-posts-collect

Run Collect one public X post with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
targetUrl string Required X post URL minLength: 1; maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://x.com/kestra_io/status/1730000000000000000"
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect public Threads posts or discover a bounded profile batch — brightdata.threads-posts-collect

Run Collect public Threads posts or discover a bounded profile batch with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
targetUrl string Optional Threads post URL minLength: 1; maxLength: 2048; format: "uri"
profileUrls array Optional minItems: 1; maxItems: 4; uniqueItems: true
profileUrls[] string Optional maxLength: 2048; format: "uri"
maxPostsPerProfile integer Optional minimum: 1; maximum: 20

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://www.threads.com/@kestra_io/post/C1abcdefghi"
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect YouTube videos — brightdata.youtube-videos

Run Collect YouTube videos with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
urls array Required YouTube video URL minItems: 1; maxItems: 1; uniqueItems: true
urls[] string Optional Video URL maxLength: 2048; format: "uri"
transcriptionLanguage string Optional Transcript language tag pattern: "^[A-Za-z]{2,3}(?:-[A-Za-z]{2,4})?$"

Full JSON Schema

Full JSON Schema

Example input

{
  "urls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "transcriptionLanguage": "en"
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Discover YouTube videos — brightdata.youtube-videos-discover

Run Discover YouTube videos with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
channelUrl string Optional Channel URL maxLength: 2048; format: "uri"
expectedVideoCount integer Required Expected videos minimum: 1; maximum: 50
keyword string Optional Search keyword minLength: 1; maxLength: 200
startDate string Optional Published after (UTC) maxLength: 24; format: "date-time"
endDate string Optional Published before (UTC) maxLength: 24; format: "date-time"
keywords array Optional Search keywords sharing the total video limit minItems: 1; maxItems: 5; uniqueItems: true
keywords[] string Optional minLength: 1; maxLength: 200
sortBy string Optional Candidate ordering (keyword searches only) enum: ["upload-date"]
uploadDate string Optional Candidate discovery period (publisher dates are verified downstream) enum: ["this-week"]

Full JSON Schema

Full JSON Schema

Example input

{
  "channelUrl": "https://www.youtube.com/@nasa",
  "expectedVideoCount": 50
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Collect YouTube comments — brightdata.youtube-comments

Run Collect YouTube comments with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
urls array Required YouTube video URL minItems: 1; maxItems: 1; uniqueItems: true
urls[] string Optional Video URL maxLength: 2048; format: "uri"
estimatedRecords integer Optional Estimated comments minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "urls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "estimatedRecords": 100
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Fetch a page as Markdown text — brightdata.web-unlocker

Run Fetch a page as Markdown text with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
responseFormat string Optional Response format enum: ["markdown","raw"]; default: "markdown"
targetUrl string Required Public page URL minLength: 1; maxLength: 4096; format: "uri"
render boolean Optional Render JavaScript content default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://example.com/"
}

At most 2 provider requests per invocation; timeout: 90 seconds.

Read Product Hunt page — brightdata.product-hunt-collect

Run Read Product Hunt page with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
collectorId string Optional Existing Studio collector ID maxLength: 82; pattern: "^c_[A-Za-z0-9]{8,80}$"
targetUrl string Required Product or leaderboard URL minLength: 1; maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://www.producthunt.com/products/kestra"
}

At most 14 provider requests per invocation; timeout: 660 seconds.

Business Search company (ludicrous) — brightdata.business-search.company.ludicrous

Run Business Search company (ludicrous) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required Structured search query minProperties: 1; maxProperties: 1
offset integer Optional Result offset minimum: 0; maximum: 1000
limit integer Optional Results per page minimum: 1; maximum: 100
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["company_id","linkedin_id","name","slogan","industry","headquarters_location","headquarters_country_code","offices_cities","company_size_from","company_size_to","employees_in_linkedin","linkedin_followers","website","domain","url","logo","about","specialties","organization_type","founded_year","headquarters_city","offices_country_codes","alumni_count","linkedin_follower_to_employee_ratio","funding_stage","funding_raised","investor_names","similar_company_ids","affiliated_company_ids","crunchbase_id","image"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "text": {
      "industry": {
        "value": "software",
        "mode": "all"
      }
    }
  },
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Business Search company (instant) — brightdata.business-search.company.instant

Run Business Search company (instant) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query string Required Search query minLength: 1; maxLength: 200
offset integer Optional Result offset minimum: 0; maximum: 99
limit integer Optional Results per page minimum: 1; maximum: 100
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["company_id","linkedin_id","name","slogan","industry","headquarters_location","headquarters_country_code","offices_cities","company_size_from","company_size_to","employees_in_linkedin","linkedin_followers","website","domain","url","logo","about","specialties","organization_type","founded_year","headquarters_city","offices_country_codes","alumni_count","linkedin_follower_to_employee_ratio","funding_stage","funding_raised","investor_names","similar_company_ids","affiliated_company_ids","crunchbase_id","image"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": "Software companies in Taiwan",
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Business Search company (smart) — brightdata.business-search.company.smart

Run Business Search company (smart) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query string Required Search query minLength: 1; maxLength: 200
offset integer Optional Result offset minimum: 0; maximum: 99
limit integer Optional Results per page minimum: 1; maximum: 10
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["company_id","linkedin_id","name","slogan","industry","headquarters_location","headquarters_country_code","offices_cities","company_size_from","company_size_to","employees_in_linkedin","linkedin_followers","website","domain","url","logo","about","specialties","organization_type","founded_year","headquarters_city","offices_country_codes","alumni_count","linkedin_follower_to_employee_ratio","funding_stage","funding_raised","investor_names","similar_company_ids","affiliated_company_ids","crunchbase_id","image"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": "Software companies in Taiwan",
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Business Search people (ludicrous) — brightdata.business-search.people.ludicrous

Run Business Search people (ludicrous) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required Structured search query minProperties: 1; maxProperties: 1
offset integer Optional Result offset minimum: 0; maximum: 1000
limit integer Optional Results per page minimum: 1; maximum: 100
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["linkedin_num_id","linkedin_person_id","name","current_title","current_company_name","current_company_industry","location","city","country_code","followers","connections","url","avatar","first_name","about","recommendations_count","influencer","patent_count","current_tenure_months","experience_years","past_job_titles","past_company_names","past_company_ids","education_schools","education_details","certification_names","languages","current_company_id","current_company_specialties","current_company_country_code","current_company_size_from","current_company_size_to","current_company_funding_stage","current_company_funding_raised","similar_profile_ids","also_viewed_ids"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "text": {
      "current_title": {
        "value": "software engineer",
        "mode": "all"
      }
    }
  },
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Business Search people (instant) — brightdata.business-search.people.instant

Run Business Search people (instant) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query string Required Search query minLength: 1; maxLength: 200
offset integer Optional Result offset minimum: 0; maximum: 99
limit integer Optional Results per page minimum: 1; maximum: 100
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["linkedin_num_id","linkedin_person_id","name","current_title","current_company_name","current_company_industry","location","city","country_code","followers","connections","url","avatar","first_name","about","recommendations_count","influencer","patent_count","current_tenure_months","experience_years","past_job_titles","past_company_names","past_company_ids","education_schools","education_details","certification_names","languages","current_company_id","current_company_specialties","current_company_country_code","current_company_size_from","current_company_size_to","current_company_funding_stage","current_company_funding_raised","similar_profile_ids","also_viewed_ids"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": "Software engineers in Taiwan",
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Business Search people (smart) — brightdata.business-search.people.smart

Run Business Search people (smart) with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query string Required Search query minLength: 1; maxLength: 200
offset integer Optional Result offset minimum: 0; maximum: 99
limit integer Optional Results per page minimum: 1; maximum: 10
view — Optional Returned fields
view string Optional oneOf[1]; enum: ["id_only","summary","full"]
view object Optional oneOf[2]; additionalProperties: false
view.fields array Required oneOf[2]; minItems: 1; maxItems: 36; uniqueItems: true
view.fields[] string Optional oneOf[2]; enum: ["linkedin_num_id","linkedin_person_id","name","current_title","current_company_name","current_company_industry","location","city","country_code","followers","connections","url","avatar","first_name","about","recommendations_count","influencer","patent_count","current_tenure_months","experience_years","past_job_titles","past_company_names","past_company_ids","education_schools","education_details","certification_names","languages","current_company_id","current_company_specialties","current_company_country_code","current_company_size_from","current_company_size_to","current_company_funding_stage","current_company_funding_raised","similar_profile_ids","also_viewed_ids"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": "Software engineers in Taiwan",
  "limit": 10,
  "offset": 0,
  "view": "summary"
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Read an existing dataset snapshot — brightdata.dataset-snapshot-read

Run Read an existing dataset snapshot with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
snapshotId string Required Existing snapshot ID pattern: "^(?:sd|j)_[a-zA-Z0-9]{8,72}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "snapshotId": "sd_snapshotfixture123"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Discover X posts and accounts — brightdata.x-discovery

Run Discover X posts and accounts with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
mode string Required enum: ["profiles","profile-posts","posts","resolve"]
values array Required minItems: 1; maxItems: 100
values[] string Optional minLength: 1; maxLength: 2048
maxPostsPerProfile integer Optional minimum: 1; maximum: 100
startDate string Optional Optional paired calendar bound for profile-posts; exact publisher freshness is verified downstream. pattern: "^\\d{4}-\\d{2}-\\d{2}$"
endDate string Optional Optional paired calendar bound for profile-posts; exact publisher freshness is verified downstream. pattern: "^\\d{4}-\\d{2}-\\d{2}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "mode": "profiles",
  "values": [
    "https://x.com/github"
  ],
  "maxPostsPerProfile": 10
}

At most 1 provider requests per invocation; timeout: 120 seconds.

Submit one bounded public X community collection — brightdata.x-community-collect

Run Submit one bounded public X community collection with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
targetUrl string Required maxLength: 120; pattern: "^https://x\\.com/i/communities/[0-9]{5,30}$"
collectorId string Required maxLength: 82; pattern: "^c_[A-Za-z0-9]{8,80}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://x.com/i/communities/1493446837214187523",
  "collectorId": "c_example12345"
}

At most 1 provider requests per invocation; timeout: 60 seconds.

Read one public professional profile — brightdata.linkedin-profile

Run Read one public professional profile with Bright Data. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
targetUrl string Required Public LinkedIn profile URL minLength: 1; maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "targetUrl": "https://www.linkedin.com/in/example-professional/"
}

At most 242 provider requests per invocation; timeout: 660 seconds.

Errors

Check the key's expiry, revocation, workspace and allowed operations.

Reuse the same idempotency key only for the same request.

The connection or provider limit has been reached. Check the receipt before retrying.

Test the connection

Open the integration's commands below to inspect parameters and examples. Start with a read command for an account or resource you can access. Refresh your client's tool list, use the returned tool name, and check the execution result and usage. Provider charges and permissions still apply. Never test a write against production data without reviewing it.

Source: https://help.tooluse.net/integrations/brightdata/index.mdx