Bright Data Docs home pagelight logodark logo
  • Support
  • Sign up
  • Sign up
Welcome
Proxy Infrastructure
Web Access APIs
Data Feeds
API Reference
General
Integrations
Introduction
  • Overview
Product Guides
  • Unlocker API
  • SERP API
    • Introduction
    • Quick Start
    • Configuration
    • Send Your First Request
    • Get started with Google SERP API
    • Get started with Bing SERP API
    • Query Parameters
    • Parsed JSON Results
    • Asynchronous Requests
    • FAQs
  • Browser API
  • Crawl API
  • Easy Scraper
  • Browser Extension
  • Bright Shield
  • FAQs
On this page
  • Types of Date Filter Queries
  • Determining the Sequence String for “Exact Match” Query
  • Example:
  • Example:
  • Example: For February 4, 2024, to February 20, 2024:
SERP API

SERP API FAQs

Discover how to effectively use Bright Data’s SERP API with detailed FAQs on setup, troubleshooting, and advanced search techniques, including Google Image and hotel data scraping.

Why should I use Bright Data's SERP API?

The Bright Data SERP API solution allows you to focus on what matters most, the data. It provides you with a 3-in-1 proxy unlocking solution that autonomously takes care of the proxy management (which proxy to use and when), unlocking logic (captcha solving, fingerprinting, retries, best headers, etc), and scraping functionality. 
In your code its as easy as swapping out the 1 line of your regular proxy network request with this 1 line SERP API request
You only pay for successful requests.
Because pricing is done according to number of pages (price per 1k requests), the bandwidth of your request doesn’t matter.
Use real user devices with laser-focused geotargeting (including city-level) to collect accurate Search Engine Result Pages (SERPs) from major search engines as a real user.
Bright Data can support your growing traffic needs and peak periods with high success rates and exceptional response time (under 5 seconds), regardless of your request volume.
Save money on data extraction engineers and IT professionals, without worrying about server maintenance.
Each request is sent from a different IP ensuring no IP is flagged or banned.
Get parsed or unparsed responses in JSON or HTML format for easy integration with any system.
Bright Data supports a wide variety of tailored parameters to answer your search requirements including different search types, different devices, results per page, etc.
Access 72 million+ real user IPs in all geolocations.

How to use SERP API for "Google Search By Image"?

With Bright Data’s SERP API, it’s easy to collect Google Search by Image data.Google reverse image search (officially “Google Search by Image”), is a service provided by Google that allows users to search for images using an image as the starting point, rather than a written or spoken search query.
The JSON response includes the image in base64 encoding.
Copy
curl -v --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/searchbyimage?image_url={TARGET_IMAGE_URL}"
See the rest of our Google Image SERP features.

How to collect hotel data with SERP API?

Bright Data’s SERP API makes it easy to collect hotel data, like prices, availability, reviews, and more.There are two ways to collect hotel data:
Provides limited info per specific hotel on pricing and datesWhen you search for a specific hotel using Google Search, its details and reviews appear in the knowledge graph/widget that you can see on the right side below:hotels-html.pngYou can set arrival and departure dates, the number of guests, and compare pricing..With SERP API, you can set these fields to collect different price combinations using dedicated parameters. See the full set of hotel parameters and features within our API documentation.hotels-availability.png

How to send SERP API HTTPS requests without SSL Certificate?

When targeting HTTPS, URL data is encrypted. Therefore, for SERP API to decrypt the data and return the result, you will need to download and install the Bright Data Certificate.Here are sample code on how to send HTTPS requests:
Copy
curl "https://www.google.com/search?q=pizza&lum_json=1" -v --insecure --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

How to sending HTTPS requests with SSL validation?

Use the cacert flag followed by the certificate file path:
Shell
Copy
curl -v --compressed "https://www.google.com/search?q=pizza&lum_json=1" --cacert “{cert file path}“ --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

How to parse JSON with SERP API?

Please refer to this article: Parsing Search Results

How to send multiple queries in an identical API request?

SERP API supports sending 2 parallel query requests with one API request using the multi parameter.These parallel requests use the same peer IP and session and can be used for collecting additional data, comparison tests, etc. - e.g., making a pair of requests with different parameters/values. They use the same IP and session.
Conditions:
  • Supported only for a zone with asynchronous requests enabled
  • Supported only for Google Search
  • Limited to 2 requests
  • Billed as 2 requests
Use Case:
Copy
multi:[
  {
    "keyword": "pizza",
    "num": 20
  },
  {
    "keyword": "pizza",
    "num": 100
  }
]
Sample Code:
Copy
curl -v --compressed "https://api.brightdata.com/serp/req" -H "Content-Type: application/json" -H "Authorization: Bearer $API_KEY" -d "{\"zone\":\"$ZONE\",\"country\":\"us\",\"multi\":[{\"keyword\":\"pizza\",\"num\":20},{\"keyword\":\"pizza\",\"num\":100}]}"

I saw that Google is making some changes to SERP results. Are you going to continue to support the SERP 'num' parameter?

Absolutely!Bright Data has developed a backup feature for the ‘num’ parameter which will kick in, in the event that Google stops supporting the ‘num’ parameter in the future.Our new feature will seamlessly compensate for any ‘num’ parameter limitations found in the initial SERP response data and send 9 additional requests (10 results each), combine them together, and return the full 100 results to you as a consolidated and comprehensive response. This new response will have the identical appearance and functionality of a response with the ‘ num=100’ parameter working flawlessly.

So, will there be any change to pricing due to this new feature?

Nope! Despite the additional requests involved in this new feature and providing the combined responses, there will be no change in pricing and this request will count for you as a single regular request for billing purposes. We understand the importance of maintaining costs and will absorb any additional costs here without passing them on to our customers.
If you having issues with the ‘num’ parameter please reach out to your Bright Data account manager, and we will activate the feature for you.

What are common use cases for SERP API?

Mapping a company’s ranking for various keywords in different locations
Track top results for company brands and trademarks
Search for products on online shopping websites and compare prices between different vendors
Collect information about companies, contacts, locations, and more
Search for images or other copyright-protected content
See which ads are showing for keywords in different countries, including double-click & Google ad services

How to query Microsoft Bing with dates filter?

In the following article, we will analyze the different options for date-specific search queries on Bing and how to use them effectively

​
Types of Date Filter Queries

No date filter applied
  • URL: https://www.bing.com/search?q=YOUR\\\_QUERY

​
Determining the Sequence String for “Exact Match” Query

To perform an Exact match date search, you need to calculate the sequence string for your desired date range. Follow these steps to determine the sequence string.
1

Use known sequence as a “Starting Point”

Use January 1, 2024 as the starting point with known sequence: 19723
2

Calculate StartDateSequence

  • Count the days from January 1 to your desired starting date.
  • Add the number of days counted to the sequence number of January 1 to get the StartDateSequence.
    Counting starts from “0”. e.g. 0, 1, 2, 3 …

​
Example:

To calculate the sequence number for February 4, 2024:
  • Total days from January 1 to February 4: 35 days
  • 35 - 1 (counting starts at “0”) = 34
  • February 4, 2024: 19723 (Jan1) + 34 = 19757 (StartDateSequence)
3

Calculate EndDateSequence

Add the number of days in your date range to the StartDateSequence to get the EndDateSequence.

​
Example:

To calculate the sequence number for February 20, 2024:
  • February 4, 2024: 19757
  • Days from February 4 to February 20: 17 days
  • 17 - 1 (counting starts at “0”) = 16
  • February 20, 2024: 19757 + 16 = 19773 (EndDateSequence)
4

Form the Sequence String

  • Use the format ez5_StartDateSequence_EndDateSequence
  • Replace StartDateSequence with the sequence number calculated above for the starting date.
  • Replace EndDateSequence with the sequence number calculated above for the ending date.

​
Example: For February 4, 2024, to February 20, 2024:

  • Calculated StartDateSequence: 19757
  • Calculated EndDateSequence: 19773
  • Sequence string: ez5_19757_19773
  • URL for query pizza:
    https://www.bing.com/search?q=pizza\\&filters=ex1:“ez5\\\_19757\\\_19773”
bing-exact-date-filter.png
With the above, you can construct URLs to query Bing for any specific date range.

Why am I getting the error: "400 this endpoint is not supported"?

SERP API supports a select number of generic domains/endpoints related to search engines, some specific subdomains or endpoints, may not be supported - example: https://trends.google.com/trends Is not supported while https://trends.google.com/trends/explore Is supported.To see a list of working examples of domains and paths that are supported, we highly recommend that you check the SERP Playground and the SERP Documentation.

How can I see more ads in Google search results using the SERP API?

If you’re monitoring ads in Google search results and want to maximize visibility, consider using our Enhanced Ads feature for Google.com SERP API requests.Default SERP Behavior:
  • Retrieves both organic search results and ads across a broad geographical scope. With Enhanced Ads Enabled:
  • Expands the range of search results and ads, simulating an incognito browsing experience without cookies.
To activate this feature, navigate to your SERP API zone in the control panel and enable it from the configuration tab.Learn More

Was this page helpful?

Asynchronous RequestsIntroduction
linkedinyoutubegithub
Powered by Mintlify
Assistant
Responses are generated using AI and may contain mistakes.