Prerequisites
- A Bright Data account
- cURL, Python 3 or Node.js 18+ installed
1
Get your API key
Go to the user settings page in your Bright Data account and create an API key, or use one you already have.If you don’t have an account yet, sign up at brightdata.com. New accounts get 5,000 free credits every month, no credit card required. See the free tier.
2
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 API key:200 status code and a JSON array. A 202 means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.A synchronous request waits up to 1 minute. If the Bright Data Google Scraper API needs longer, the response is HTTP
202 with a snapshot_id instead of result data, and collection continues asynchronously. Fetch the result with the async workflow or have it pushed to you with webhook delivery.3
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?
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?
Yes. Swap thedataset_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?
Verify your API key is correct and hasn’t expired. Create a new API key in Account settings. See the authentication guide for details.Request is timing out?
Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP202 with a snapshot_id and finishes the job asynchronously. Use the async workflow for large batches.
Empty or partial response data?
Verify the Google URL is publicly accessible and correctly formatted. For Google Maps, the URL should follow the patternhttps://www.google.com/maps/place/.... For Shopping and SERP, verify the URL works in an incognito browser window.
Do I have to call the API directly?
No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.Next steps
Endpoints
One request per endpoint, each with a captured response.
Async batch requests
Scrape thousands of places or run discovery in a single batch job.
API reference
Endpoint specs, parameters and response schemas.