Skip to main content

​
Debugging SERP API

Use the x-brd-debug response header to extract detailed debug information about your requests. Activate by appending -debug-full to your proxy username: 
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:33335 \
  "https://www.google.com/search?q=bright+data"
The x-brd-debug response header will look like this: 
req_id=hl_d09913c7_a1lw123bkcg; bytes_up=2842; bytes_down=562418; billed=false; destination_ip=162.219.225.118; used_req_headers=accept-language,accept; peer_ip=r868133f79d0c3fa9d7c7ccca0151af2e; peer_country=us; render=false
FieldDescription
req_idInternal request ID - include in bug reports
bytes_upOutgoing traffic recorded while processing the request
bytes_downIncoming traffic recorded while processing the request
billedWhether the request is considered billable
destination_ipIP of the remote server used to fetch the data
used_req_headersCustom headers relayed in the initial request
peer_ipUnique identifier for the IP used - useful for validating IP rotation
peer_countryCountry of the peer used for the request
renderWhether the result is browser-rendered HTML or a raw HTTP response

​
Common Error Codes

ErrorDescription
404Invalid URL - likely broken or dead
403URL is valid but access is forbidden
502Most common SERP API error - see detail in x-brd-error-code
407Incorrect credentials (password or zone name)
429Rate limit / auto-throttle - contact support
401 411 444Bad request - missing headers or cookies
503Service unavailable - browser check failed
Example 429 response
HTTP/1.1 429 The request was auto-throttled due to low success rate
x-brd-error-code: sr_rate_limit
x-brd-error: The request was auto-throttled due to low success rate
date: Tue, 23 Jan 2024 17:07:19 GMT
connection: keep-alive

​
Get Success Rate Statistics Per Domain

Retrieve SERP API success rate stats from the past 7 days. Supports single domain or wildcard.
Single domain
curl "https://api.brightdata.com/unblocker/success_rate/google.com" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
All monitored TLDs
curl "https://api.brightdata.com/unblocker/success_rate/google.*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
Once you provide your API key, replace all $API_KEY, $CUSTOMER_ID, $ZONE, and $PASSWORD placeholders accordingly.