Skip to main content

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.

​
Default response format

When you configure your SERP API you can select between different defualt response format:
  1. Raw HTML: no parsing at all. Get the HTML response as is.
  2. Full JSON: our full interpertation of Google’s SERP HTML to JSON.
  3. Light JSON: a subset of full JSON
  4. Parsed Bing: our full interpertation of Bing’s SERP HTML to JSON.
  5. Markdown: our full interpertation of Google’s and Bing’s SERP HTML to markdown *.md file.
  6. Screenshot: an image capture of the SERP HTML page as interperted by a browser.
To read more on our response options and advanced response formats see: https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/parsing-search-results

​
Enhanced Ads for Google

Bright Data provides a special setting which brings more google ads data. When this setting is switch on, API will respond with a larger more diverse range of search results and ads, mimicking an incognito browsing scenario without cookies. Default setting (OFF) fetches both organic search results and ads, encompassing a broad geographical scope.

​
Advanced settings

​
Custom Headers and Cookies

Bright Data enables you to send your custom headers and cookies. Once you do so, we will not override your settings and relay your requests to the search engine. You can choose from a pre-approved list of headers and cookies or request a new one, and go thru approval process. Once custom headers and cookies are selected Bright Data will charge you for all requests. When using the default setting without customized cookies, Bright Data charges for successful requests only.

​
Asynchronous Requests

You can work with Bright Data APIs using an asynchronous mode, where request is sent immediately, and you will be notified when response is ready. It usually takes few minutes for the response to be posted back. For non real time application we recommend with Async mode to assure higher success rate. When submitting asynchornic request, Bright Data handls it seamlessly in the background. You can either poll for the response or configure a webhook where we will notify on request complrtion. This allows you to collect responses at a later more convenient time via a designated endpoint, increasing stability, flexibility, and efficiency. Learn more

​
Webhook Configuration

Webhook has two configurable options:
  1. Webhoom address URL
  2. Webhook methos (get/post)
On your network you should add our Webhook agent origin IPs.

​
Allowlist our webhook IPs

Our asynchronous webhooks delivery sends notifications from a pair of stable IP addresses:
  1. 100.27.150.189
  2. 18.214.10.85
Customers may need to allowlist these IPs on their side.