/trigger endpoint to scrape more than 20 URLs in one job, run discovery collections or deliver results to a webhook or cloud storage. The workflow is the same for every Bright Data scraper: trigger, poll, download. Only the dataset_id changes.
Prerequisites
- A Bright Data account with an active API key
- The
dataset_idfor the scraper you want to run, from the table below - Familiarity with the synchronous request flow for your scraper, for example Send your first LinkedIn API request
Which dataset ID do I use?
Every scraper has its owndataset_id. The examples on this page use LinkedIn profiles. Substitute the ID for the platform you are scraping.
Each scraper exposes several endpoints, for example Amazon has separate IDs for products, reviews and sellers. The full list for each platform is on its introduction page, and every ID is browsable in the Scrapers library.
Step 1: Trigger the collection
Send aPOST request to the /trigger endpoint with your input URLs:
200 response with a snapshot_id:
Step 2: Monitor progress
Poll the snapshot status until it showsready. This takes 30 seconds to several minutes depending on the number of URLs.
Step 3: Download results
Once the status isready, download the scraped data:
Skip polling with webhooks
If you don’t want to poll for status, add anendpoint parameter to receive results automatically:
Limits and constraints
How to limit records per input
When running a discovery collection, you can cap the number of results returned per input. Set this in the scraper’s configuration in the Control Panel.

Troubleshooting
Getting a 429 Too Many Requests error?
Getting a 429 Too Many Requests error?
You’ve exceeded the concurrent request limit. Reduce the number of parallel requests or combine inputs into fewer, larger batches. Each batch can include up to 1 GB of input data.
Snapshot status shows 'failed'?
Snapshot status shows 'failed'?
Check that all input URLs are valid for the scraper you are calling. A LinkedIn URL sent to the Amazon
dataset_id fails. Review the error details in the snapshot response or in the Logs tab of your Bright Data dashboard.Results are incomplete or missing some URLs?
Results are incomplete or missing some URLs?
Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any
errors field. Retry failed URLs in a separate request.FAQ
How many URLs can I send in one async request?
Async requests accept up to 1 GB of input data per job, which is tens of thousands of URLs. Use the synchronous endpoint only when you have 20 URLs or fewer and want the results in the same response.Do I need a different dataset ID for each platform?
Yes. Thedataset_id query parameter selects both the platform and the endpoint, for example Amazon products versus Amazon reviews. The table above lists the primary ID per platform, and each platform’s introduction page lists the rest.