Skip to content

Bright Data

Updated View as Markdown

Use one account API key for Bright Data and Scraper Studio. Discover collectors and jobs, configure approved collectors, submit custom inputs and retain results.

Example workflows

Copy a prompt into your connected AI client after connecting this integration. Choose resources you can access and review the supported command before running it.

Read Google or Bing search results

Help me with this task in Bright Data: Read Google or Bing search results. Ask me for any required inputs and confirm the resources and scope before calling the command. Read one response page. Turn the returned data into a concise working summary with original IDs, dates and source links when available. Separate missing information from confirmed results and tell me whether more pages remain. Do not invent fields or change data.

Explore this command: brightdata.serp-search

Read one public LinkedIn job posting

Help me with this task in Bright Data: Read one public LinkedIn job posting. Ask me for any required inputs and confirm the resources and scope before calling the command. Read one response page. Turn the returned data into a concise working summary with original IDs, dates and source links when available. Separate missing information from confirmed results and tell me whether more pages remain. Do not invent fields or change data.

Explore this command: brightdata.linkedin-jobs

What you can do (30)

What you can do

Available commands: 30 (30 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
Find public Instagram or TikTok profiles — brightdata.creator-search Read
Read public Instagram creator profiles — brightdata.instagram-profiles Read
Read public TikTok creator profiles — brightdata.tiktok-profiles Read
Start a Scraper Studio collection — brightdata.studio-collect Read
List Scraper Studio collectors — brightdata.studio-collectors-list Read
List Scraper Studio jobs — brightdata.studio-jobs-list Read
Read a Scraper Studio job — brightdata.studio-job-read Read

Connect and use

Connect and use

Tooluse.net supplies the provider credentials for these commands. You do not need to apply for a provider API key. Select Tooluse.net credentials in the connection form; complete provider sign-in or authorization if prompted.

Connect this integration, select Tooluse.net credentials, choose the commands you need and save. Complete provider sign-in if prompted.

Tooluse.net credentials cover only the commands listed below. Check each remaining command's connection instructions for its available credential source.

Commands available with Tooluse.net credentials

  • Read Google or Bing search results — brightdata.serp-search

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

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

  • Collect commerce product records — brightdata.commerce-dataset

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

  • Collect comments on Reddit posts — brightdata.reddit-comments

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

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

  • Collect YouTube videos — brightdata.youtube-videos

  • Discover YouTube videos — brightdata.youtube-videos-discover

  • Collect YouTube comments — brightdata.youtube-comments

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

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

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

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

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

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

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

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

  • Read one public professional profile — brightdata.linkedin-profile

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
Scraper Studio collector ID Optional
Scraper Studio allowed origin Optional
Scraper Studio collectors JSON 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

Scraper Studio and robots.txt

The Bright Data API key belongs to your account, not to Trustpilot or any other target website. Use the same account connection for Studio discovery, job inspection and every collector explicitly configured on that connection.

Bright Data’s immediate residential mode follows the target’s robots.txt. A bad_endpoint response mentioning KYC identifies a restriction in that mode. For an authorized public source, use its official API, a maintained Bright Data scraper, or a custom Scraper Studio collector supported by Bright Data. Studio is a separate provider product; this route does not change the target’s robots.txt, waive provider restrictions or guarantee access.

Bright Data residential access and KYC · Scraper Studio documentation · Trustpilot official reviews API · Bright Data’s Trustpilot Scraper API

Discover collectors and existing jobs

Enable the read commands you need on your Bright Data connection: brightdata.studio-collectors-list, brightdata.studio-jobs-list and brightdata.studio-job-read. Discovery needs only the account API key. Listing a collector does not authorize running it. The collector list includes IDs, active status, output schema and delivery type; delivery credentials are omitted.

Use search to find a collector by name. Read its published input schema in the Bright Data IDE. The collector list’s output_schema describes results, not inputs. To inspect history, pass collectorId, fromDate, toDate, offset and limit to brightdata.studio-jobs-list. A request covers at most 31 days and 100 jobs. Advance offset within a finite read allowance. Inspect one original j_… ID with brightdata.studio-job-read to see status, page loads, failures, line counts and timestamps.

Configure multiple collectors with one key

In the Tooluse Bright Data connection, set Scraper Studio collectors JSON to an object keyed by the approved c_… collector IDs. Each profile declares an exact public HTTPS origin and its inputSchema. Use a closed object schema (additionalProperties: false), matching the collector’s Inputs tab. One connection accepts up to 20 profiles. URL values must stay on the profile’s origin; non-URL fields support keywords, product IDs, categories, locales and other collector-specific parameters.

{"c_keywordfixture1234":{"origin":"https://example.com","inputSchema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"maxLength":100},"country":{"enum":["US","GB"]}},"required":["keyword","country"],"additionalProperties":false}}}

Keep Scraper Studio collector ID and Scraper Studio allowed origin for a simple collector with a single url field. Do not duplicate that ID in the JSON profiles. Additional collectors can be added without entering the API key again. Tooluse retains stored credentials when an edit leaves the API key blank.

Submit one bounded input

Enable brightdata.studio-collect and brightdata.dataset-snapshot-read. Publish and review each collector in the Bright Data IDE before enabling execution: at most three billable page loads per input, bounded output, bounded retries, no recursive crawling, and no unbounded media downloads. Check the provider account’s Scraper Studio price and spend limit. Tooluse’s three-unit reservation is an estimate; it does not enforce the collector’s internal browser commands. Collectors requiring more work must be redesigned to fit this allowance.

Call brightdata.studio-collect with collectorId and exactly one input object matching its configured schema. For example: {"collectorId":"c_keywordfixture1234","input":{"keyword":"software","country":"US"}}. The existing targetUrl shortcut remains available for a URL collector. Each invocation submits one input in one provider request; arrays, per-request delivery overrides and development-version execution are not exposed.

Normalize and deduplicate inputs, reuse fresh results, and persist one Idempotency-Key per collector, input and refresh window before submission. Tooluse reserves three page-load units against existing application and connection allowances. It does not raise prices, quotas, request caps or schedule frequency. Metadata reads also consume the existing request allowance.

Read the original job

Store the trigger receipt and confirm providerHttpStatus. Retain its gzip/base64 bytes and SHA-256. collectionId identifies the original j_… job. UNKNOWN requires reconciliation using the original Tooluse receipt and Studio job history; submitting again can create another paid collection.

Call brightdata.dataset-snapshot-read with that same ID. Each invocation performs one GET and preserves the complete raw response. SUCCESS means the response was retained; inspect providerHttpStatus and the decoded provider status before treating the dataset as ready. Use a finite number of spaced reads while pending. Never replace a pending or uncertain collection with a new trigger.

Save the complete downloaded receipt before parsing it. Validate source identity, dates, output schema and duplicates. Report received, accepted, stored and published counts separately. A draft collector, Preview output or successful metadata read does not prove a production collection or database ingestion succeeded.

Create, edit, test and publish collector code in the Bright Data Studio IDE. Tooluse exposes the reusable collection lifecycle; it does not silently create supplier subscriptions, deploy arbitrary collector code, change delivery destinations or resume paused flows.

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.

Read public Instagram creator profiles — brightdata.instagram-profiles

Run Read public Instagram creator profiles 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 minItems: 1; maxItems: 1
urls[] string Optional maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "urls": [
    "https://www.instagram.com/instagram/"
  ]
}

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

Read public TikTok creator profiles — brightdata.tiktok-profiles

Run Read public TikTok creator profiles 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 minItems: 1; maxItems: 1
urls[] string Optional maxLength: 2048; format: "uri"

Full JSON Schema

Full JSON Schema

Example input

{
  "urls": [
    "https://www.tiktok.com/@tiktok"
  ]
}

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

Start a Scraper Studio collection — brightdata.studio-collect

Run Start a Scraper Studio 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 Optional Public HTTPS URL on the approved origin minLength: 1; maxLength: 2048; format: "uri"
collectorId string Optional Approved Studio collector ID pattern: "^c_[A-Za-z0-9]{8,80}$"
input object Optional One input object matching the configured collector schema maxProperties: 100

Full JSON Schema

Full JSON Schema

Example input

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

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

List Scraper Studio collectors — brightdata.studio-collectors-list

Run List Scraper Studio collectors 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
search string Optional Collector name filter maxLength: 100

Full JSON Schema

Full JSON Schema

Example input

{}

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

List Scraper Studio jobs — brightdata.studio-jobs-list

Run List Scraper Studio jobs 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 Required Studio collector ID pattern: "^c_[A-Za-z0-9]{8,80}$"
fromDate string Required format: "date"
toDate string Required format: "date"
offset integer Optional minimum: 0; maximum: 10000
limit integer Optional minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "collectorId": "c_fixturestudio1234",
  "fromDate": "2026-11-01",
  "toDate": "2026-11-15",
  "limit": 50
}

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

Read a Scraper Studio job — brightdata.studio-job-read

Run Read a Scraper Studio job 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
jobId string Required Original Studio collection ID pattern: "^j_[A-Za-z0-9]{8,72}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "jobId": "j_fixturestudio1234"
}

At most 1 provider requests per invocation; timeout: 30 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.

Type to search…

↑↓ navigate↵ selectEsc close