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
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-searchRead one public LinkedIn job posting —
brightdata.linkedin-jobsDiscover LinkedIn jobs by company and keyword —
brightdata.linkedin-jobs-discoverCollect commerce product records —
brightdata.commerce-datasetDiscover Reddit posts by subreddit or keyword —
brightdata.reddit-posts-discoverCollect comments on Reddit posts —
brightdata.reddit-commentsCollect one public X post —
brightdata.x-posts-collectCollect public Threads posts or discover a bounded profile batch —
brightdata.threads-posts-collectCollect YouTube videos —
brightdata.youtube-videosDiscover YouTube videos —
brightdata.youtube-videos-discoverCollect YouTube comments —
brightdata.youtube-commentsFetch a page as Markdown text —
brightdata.web-unlockerRead Product Hunt page —
brightdata.product-hunt-collectBusiness Search company (ludicrous) —
brightdata.business-search.company.ludicrousBusiness Search company (instant) —
brightdata.business-search.company.instantBusiness Search company (smart) —
brightdata.business-search.company.smartBusiness Search people (ludicrous) —
brightdata.business-search.people.ludicrousBusiness Search people (instant) —
brightdata.business-search.people.instantBusiness Search people (smart) —
brightdata.business-search.people.smartRead 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.
- 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.
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 Google or Bing search results — brightdata.serp-search
Run Read Google or Bing search results 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.
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 | Google or Bing search URL | minLength: 1; maxLength: 4096; format: "uri" |
postDetails |
string | Optional | Read verified post dates (up to 7 unique details) | enum: ["x","threads"] |
responseFormat |
string | Optional | Google original HTML or explicit JSON transport | enum: ["raw","json"] |
Full JSON Schema
Example input
{
"targetUrl": "https://www.google.com/search?q=Kestra&num=5&hl=en"
}
At most 244 provider requests per invocation; timeout: 660 seconds.
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
Example input
{
"targetUrl": "https://www.linkedin.com/in/example-professional/"
}
At most 242 provider requests per invocation; timeout: 660 seconds.
Find public Instagram or TikTok profiles — brightdata.creator-search
Run Find public Instagram or TikTok 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.
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 |
|---|---|---|---|---|
platform |
string | Required | enum: ["Instagram","TikTok"] |
|
query |
string | Required | minLength: 1; maxLength: 200 |
|
limit |
integer | Optional | minimum: 1; maximum: 10 |
|
country |
string | Optional | pattern: "^[A-Z]{2}$" |
|
delivery |
string | Optional | enum: ["snapshot","tiktok-profiles","tiktok-fast-posts","instagram-works"] |
Full JSON Schema
Example input
{
"platform": "Instagram",
"query": "ceramics",
"limit": 10,
"delivery": "instagram-works"
}
At most 3 provider requests per invocation; timeout: 30 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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.