Skip to main content
POST
/
serp
/
req
cURL
curl --request POST \
  --url https://api.brightdata.com/serp/req \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": {
    "q": "pizza",
    "gl": "au",
    "hl": "en",
    "start": 20
  },
  "country": "US"
}
'
{
  "response_id": "s4t7w3619285042ra9dke1m8qx"
}

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.

Authorizations

​
Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd...

Learn how to get your Bright Data API key

Query Parameters

​
zone
string
required

The name of your Bright Data Unlocker zone.

​
customer
string

Your Bright Data account ID.

Body

application/json
​
query
object
required
​
country
string

Defines country to be used for request (2-letters code)

Example:

"US"

​
brd_json
enum<string>

Defines the response format

Available options:
json,
html

Response

200 - application/json

OK

​
response_id
string

Defines the job id.

Example:

"s4t7w3619285042ra9dke1m8qx"