All Collections
Getting Started
How to start using SERP Scraper API
How to start using SERP Scraper API
Josh avatar
Written by Josh
Updated over a week ago

Create an API user

Begin by creating an account on the Oxylabs dashboard. Choose a subscription plan or get a free trial, and then create an API user.

Make a cURL request

You can use this cURL code for testing:

curl 'https://realtime.oxylabs.io/v1/queries' --user 'USERNAME:PASSWORD' -H 'Content-Type: application/json' -d '{"source": "google_search", "domain": "com", "query": "adidas", "geo_location": "California,United States", "parse": true}'

Replace the USERNAME and PASSWORD with the API credentials you’ve just created and run the request on Postman or any other setup. The output will contain scraped and parsed search results for the term “adidas” from the google.com domain. As the API connects through a proxy server connected in California, the results will also be localized for that specific region.

Check out this short video guide on how to use SERP Scraper API:

🔎 See this detailed guide to learn more.
Test our APIs for free in the Scraper APIs Playground, which is accessible via the dashboard.

Integration methods

There are three ways you can use SERP Scraper API for your projects:

  • Realtime – this is a synchronous method where you have to keep the connection open until the job is finished.

  • Push-Pull – this is an asynchronous method where you’ll have to make another request to the API to retrieve results once the job is finished.

  • Proxy Endpoint – this is a synchronous method where you can use our endpoint as a proxy.

🛠️ For more information, please refer to the respective integration pages on our documentation or this comprehensive blog post.

Sources and parameters

SERP Scraper API can retrieve results from these four search engines:

🧠 Visit the documentation to learn about each source and the parameters you can use. For global settings that work with all of our APIs, such as JavaScript rendering and user agents, see the Global Parameter Values page on our documentation.


🙌 Need assistance? Contact support via live chat or send a message to [email protected].

🎯 Want a custom solution or a free trial? Contact sales by booking a call. For any questions, such as custom pricing, advice, or a free trial, drop us a line at [email protected].

Did this answer your question?