Send your first SERP API request

Make your first request in minutes

Test the SERP API in minutes with this ready-to-use code example.

Node.js Example

Python Example

Bright Data offers two methods for accessing SERP API, both delivering identical results while catering to different customer workflows:

Direct API access (recommended)

A pure REST API method for easy access and straightforward integration.

Native proxy-based access

For workflows that rely on proxy-based routing.

Direct API access (recommended)

A simple and RESTful way to interact with Bright Data’s SERP API. Direct API access abstracts proxy management and allows you to send requests via a central endpoint, ensuring ease of use and straightforward REST API integration.

When to use direct API access

Centralized endpoint: Access SERP API via a single, RESTful endpoint.
Streamlined direct integration: Eliminating the complexity of managing proxies or routing.
Single API key authentication: Secure and easy to use, replacing the need for username-password management.

Sending your first request

After setting up your SERP API zone, you’ll find a working SERP API request example and your API key within your zone’s Overview tab:

The following is an example of a simple SERP API cURL request:

Direct API access - cURL

curl -H "Content-Type: application/json" -H "Authorization: Bearer [INSERT_YOUR_API_KEY]" -d '{"zone": "[INSERT_YOUR_SERP_API_ZONE_NAME]","url": "[INSERT_YOUR_TARGET_URL]", "format": "raw"}' https://api.brightdata.com/request

Request breakdown

API Endpoint: https://api.brightdata.com/request
Authorization Header: Authorization: Bearer [INSERT YOUR API key]
- Your API key is found within your SERP API zone.
Payload:
- zone: Your specific SERP API zone name.
- url: The full SERP target URL (including SERP query params) that you wish to access via SERP API.
- format: Defines the response format. Use raw to receive the raw response from the target site.

Generating your Bright Data API key

A Bright Data API key is your secure authentication token for accessing SERP API via Direct API access. When adding a new SERP API zone in the control panel, an API key will be generated automatically and can be found within the Overview tab of your zone.

To generate a new API key:

Navigate to Account settings.
Scroll down and click the Add API key button.
Follow the on-screen instructions to complete the process.

We strongly recommend to have an expiration date set on your API key for increased security.

The API key will be shown to you on the screen only so make sure you copy and store it in a safe location per your organization’s policies

Native proxy-based access

In order to access SERP API, you will need to provide credentials which are comprised of:

Your customer ID
Your SERP API zone name
Your SERP API password
Bright Data SSL certificate

Where to find your customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: Account settings .

Zone name and password

Your zone name and password can be found in the overview tab of your SERP API zone in the control panel.

Bright Data SSL Certificate

Prevent SSL errors by setting up Bright Data SSL certificate

SSL Certificate can be found by clicking “SSL certificate” wizard on your zone’s overview top menu. See further instructions here: SSL certificate. Alternatively, you can ignore SSL errors.

SERP API: HTTPS Proxy code examples

Once you have your API credentials, use the following code to send your first request:

curl "https://www.google.com/search?q=pizza" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k

#!/usr/bin/env node

const { ProxyAgent, setGlobalDispatcher } = require('undici');

setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

(async () => {
  const response = await fetch('https://www.google.com/search?q=pizza');
  console.log(await response.text());
})();

import pprint
import requests


host = 'brd.superproxy.io'
port = 44445

username = 'brd-customer-<customer_id>-zone-<zone_name>'
password = '<zone_password>'

proxy_url = f'http://{username}:{password}@{host}:{port}'

proxies = {
    'http': proxy_url,
    'https': proxy_url
}


url = "https://www.google.com/search?q=pizza&brd_json=1"
response = requests.get(url, proxies=proxies, verify=False)
pprint.pprint(response.json())

<?php
echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
    .'YOURPASS, please contact sales@brightdata.com';
$curl = curl_init('https://www.google.com/search?q=pizza');
curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
curl_exec($curl);
?>

#!/usr/bin/ruby

require 'uri'
require 'net/http'
require 'net/https'

puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

uri = URI.parse('https://www.google.com/search?q=pizza')
proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

req = Net::HTTP::Get.new(uri)

result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(req)
end

puts result.body

using System;
using System.Net;

class Example {
  static void Main() {
    var client = new WebClient();
    client.Proxy = new WebProxy("brd.superproxy.io:44445");
    client.Proxy.Credentials = new NetworkCredential(
      "brd-customer-<customer_id>-zone-<zone_name>",
      "<zone_password>"
    );
    Console.WriteLine(client.DownloadString("https://www.google.com/search?q=pizza"));
  }

package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        System.out.println("To enable your free eval account and get "
            +"CUSTOMER, YOURZONE and YOURPASS, please contact "
            +"sales@brightdata.com");
        HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
        String res = Executor.newInstance()
            .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
            .execute(Request.Get("https://www.google.com/search?q=pizza").viaProxy(proxy))
            .returnContent().asString();
        System.out.println(res);
    }
}

#!/usr/bin/perl

print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
    .'YOURPASS, please contact sales@brightdata.com';
use LWP::UserAgent;
my $agent = LWP::UserAgent->new();
$agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
print $agent->get('https://www.google.com/search?q=pizza')->content();

Imports System.Net

Module Module1
    Sub Main()
        Console.WriteLine("To enable your free eval account and get " & 
            "CUSTOMER, YOURZONE and YOURPASS, please contact " &
            "sales@brightdata.com")
        Dim Client As New WebClient
        Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
        Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
        Console.WriteLine(Client.DownloadString("https://www.google.com/search?q=pizza"))
    End Sub
End Module

Send your first async request

Asynchronous requests submit a job, return a response_id immediately, and let you collect results later. Use async when you do not need the result in the same HTTP response.

Enable asynchronous requests

In your SERP API zone, open Advanced settings and turn on Asynchronous requests.

Submit the job

curl --request POST \
  --url 'https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "query": {"q": "pizza"},
      "brd_json": "json"
    }'

import requests

url = "https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME"

payload = {
    "query": {"q": "pizza"},
    "brd_json": "json",
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json()["response_id"])

const response = await fetch(
  "https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: { q: "pizza" }, brd_json: "json" }),
  }
);

const data = await response.json();
console.log(data.response_id);

You should see a response_id:

{
  "response_id": "s4t7w3619285042ra9dke1m8qx"
}

Save it. You need it to collect the result.

Check status and collect the result

While the job is still running, the API returns HTTP 202 with "Request is pending". Once it completes, fetch the result:

curl --silent --compressed \
  "https://api.brightdata.com/unblocker/get_result?response_id=YOUR_RESPONSE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.json

results.json holds the structured SERP response. For the full field-by-field schema, see Parsed JSON results.

Detail	Value
Typical processing time	Up to 5 minutes, extending to 8 hours at peak
Result retention	48 hours from submission

Can Bright Data push the response to my endpoint?

Not with the SERP API async endpoint. Collect results by polling with the response_id. If you need Bright Data to deliver a payload to an endpoint you control, use the Google Scraper API, which supports webhook delivery. For webhook setup, the async-versus-sync comparison and the full parameter list, see Asynchronous requests.

Get started

Data extraction

Web access

AI training data

Proxy networks

Send your first SERP API request

Make your first request in minutes

Node.js Example

Python Example

Direct API access (recommended)

Native proxy-based access

Direct API access (recommended)

When to use direct API access

Sending your first request

Request breakdown

Generating your Bright Data API key

Native proxy-based access

Where to find your customer ID

Zone name and password

Bright Data SSL Certificate

SERP API: HTTPS Proxy code examples

Send your first async request

Enable asynchronous requests

Submit the job

Check status and collect the result

Can Bright Data push the response to my endpoint?

​Make your first request in minutes

Node.js Example

Python Example

Direct API access (recommended)

Native proxy-based access

​Direct API access (recommended)

​When to use direct API access

​Sending your first request

​Request breakdown

​Generating your Bright Data API key

​Native proxy-based access

​Where to find your customer ID

​Zone name and password

​Bright Data SSL Certificate

​SERP API: HTTPS Proxy code examples

​Send your first async request

​Enable asynchronous requests

​Submit the job

​Check status and collect the result

​Can Bright Data push the response to my endpoint?

Make your first request in minutes

Direct API access (recommended)

When to use direct API access

Sending your first request

Request breakdown

Generating your Bright Data API key

Native proxy-based access

Where to find your customer ID

Zone name and password

Bright Data SSL Certificate

SERP API: HTTPS Proxy code examples

Send your first async request

Enable asynchronous requests

Submit the job

Check status and collect the result

Can Bright Data push the response to my endpoint?