Documentation Index Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
Use this file to discover all available pages before exploring further.
This tutorial walks you through sending a synchronous request to each Bright Data LinkedIn Scraper API endpoint. By the end, you’ll have working examples for profiles, companies, jobs, and posts.
Prerequisites
Request structure
Every synchronous request follows the same pattern:
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
[{"url": "https://www.linkedin.com/..."}]
The only thing that changes between endpoints is the dataset_id and the input URL format.
Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a snapshot_id instead. See async requests .
Profiles
Dataset ID: gd_l1viktl72bvl7bjuj0
curl -X POST \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
You should see a 200 response. This takes 10-30 seconds.
[
{
"name" : "Satya Nadella" ,
"city" : "Redmond" ,
"country_code" : "US" ,
"position" : "Chairman and CEO at Microsoft" ,
"current_company" : {
"name" : "Microsoft" ,
"company_id" : "microsoft" ,
"link" : "https://www.linkedin.com/company/microsoft"
},
"about" : "Chairman and CEO at Microsoft..." ,
"followers" : 10842560 ,
"connections" : 500
}
]
Full Profiles response schema
Companies
Dataset ID: gd_l1vikfnt1wgvvqz95w
curl -X POST \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfnt1wgvvqz95w&format=json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '[{"url": "https://www.linkedin.com/company/microsoft"}]'
[
{
"name" : "Microsoft" ,
"followers" : 23000000 ,
"employees_in_linkedin" : 290000 ,
"about" : "Every company has a mission..." ,
"industries" : [ "Software Development" ],
"company_size" : "10,001+ employees" ,
"headquarters" : "Redmond, Washington" ,
"website" : "https://www.microsoft.com" ,
"founded" : "1975"
}
]
Full Companies response schema
Jobs
Dataset ID: gd_lpfll7v5hcqtkxl6l
curl -X POST \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lpfll7v5hcqtkxl6l&format=json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '[{"url": "https://www.linkedin.com/jobs/view/3986111804"}]'
[
{
"job_title" : "Software Engineer" ,
"company_name" : "Epic" ,
"job_location" : "Verona, WI" ,
"job_seniority_level" : "Entry level" ,
"job_employment_type" : "Full-time" ,
"job_industries" : [ "Software Development" ],
"job_summary" : "Work on healthcare software that impacts millions..." ,
"apply_link" : "https://www.linkedin.com/jobs/view/3986111804/apply" ,
"is_easy_apply" : true
}
]
Full Jobs response schema
Posts
Dataset ID: gd_lyy3tktm25m4avu764
curl -X POST \
"https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&format=json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '[{"url": "https://www.linkedin.com/posts/satyanadella_activity-7180537307521769472"}]'
[
{
"post_text" : "Excited to share our latest AI innovations..." ,
"num_likes" : 45230 ,
"num_comments" : 1250 ,
"date_posted" : "2024-04-03T14:30:00.000Z" ,
"hashtags" : [ "AI" , "Innovation" ],
"user_followers" : 10842560 ,
"post_type" : "original"
}
]
Full Posts response schema
Quick reference: dataset IDs
Endpoint Dataset ID URL pattern Profiles gd_l1viktl72bvl7bjuj0linkedin.com/in/{username}Companies gd_l1vikfnt1wgvvqz95wlinkedin.com/company/{slug}Jobs gd_lpfll7v5hcqtkxl6llinkedin.com/jobs/view/{id}Posts gd_lyy3tktm25m4avu764linkedin.com/posts/{slug}
Control the response format with the format query parameter:
Value Description jsonJSON array (default) ndjsonNewline-delimited JSON, one record per line csvComma-separated values
Next steps
Async batch requests Scrape hundreds of URLs in a single batch job.
API reference Full parameter and response field reference.