Prerequisites
- A Bright Data account (includes $2 free credit)
- cURL, Python 3 or Node.js 18+ installed
Get your API key
Go to the user settings page in your Bright Data account and copy your API key.If you don’t have an account yet, sign up at brightdata.com. New users get $2 free credit for testing.
Send a request
We’ll use the Google Maps — Collect by URL endpoint with a synchronous request. Replace You should see a
YOUR_API_KEY with your actual token:200 status code. This takes 10 to 30 seconds.Review the response
The Bright Data Google Scraper API returns a JSON array with structured place data:Each place object includes location details, ratings, hours, photos and contact info. See the full response schema.
Common questions
Can I scrape multiple places in one request?
Can I scrape multiple places in one request?
Yes. Add more objects to the input array. Synchronous requests support up to 20 inputs. For larger batches or for discovery by keyword, CID or location, use the async
/trigger endpoint.Can I scrape Google Shopping or SERP instead?
Can I scrape Google Shopping or SERP instead?
Yes. Swap the
dataset_id for the product you need. For example, Google Shopping Collect by URL uses gd_ltppk50q18kdw67omz, and Google SERP 100 uses gd_mfz5x93lmsjjjylob. See Send your first request for working examples of every endpoint.Getting a 401 or 403 error?
Getting a 401 or 403 error?
Verify your API key is correct and hasn’t expired. Generate a new token from Account settings. See the authentication guide for details.
Request is timing out?
Request is timing out?
Synchronous requests have a 1-minute timeout. If the request exceeds this limit, it automatically switches to async and returns a
snapshot_id. Use the async workflow for large batches.Empty or partial response data?
Empty or partial response data?
Verify the Google URL is publicly accessible and correctly formatted. For Google Maps, the URL should follow the pattern
https://www.google.com/maps/place/.... For Shopping and SERP, verify the URL works in an incognito browser window.Next steps
Send your first request
Explore every endpoint with full examples in cURL, Python and Node.js.
Async batch requests
Scrape thousands of places or run discovery in a single batch job.
API reference
Endpoint specs, parameters and response schemas.