Skip to main content
GET
/
google
/
search
Google Search
curl --request GET \
  --url https://api.example.com/google/search

​
Overview

The /google/search endpoint executes a Google search query and returns parsed, structured results. This API handles anti-bot measures and provides clean data extraction from Google’s search results.

​
Parameters

​
Query Parameters

​
q
string
required
The search query
​
hl
string
default:"en"
Language code for the interface (e.g., en, es, fr, de)
​
gl
string
default:"us"
Country code for geo-targeted results (e.g., us, uk, de, jp)
​
num
number
default:"10"
Number of results to return (1-100)
​
start
number
default:"0"
Start offset for pagination (e.g., 0 for first page, 10 for second)
​
device
string
default:"desktop"
Device type to emulate. Options: desktop, mobile, tablet
​
location
string
Location for geo-targeted results (e.g., New York, USA, London, UK)
​
safe
string
Safe search mode. Options: off, medium, high
​
tbs
string
Time-based filter for results:
  • qdr:d - Past 24 hours
  • qdr:w - Past week
  • qdr:m - Past month
  • qdr:y - Past year
​
tbm
string
default:"search"
Search type. Options: search, images, news, videos
​
filter
number
Duplicate content filter. 0 = show all, 1 = filter duplicates
​
nfpr
number
Auto-correct toggle. 0 = allow corrections, 1 = disable auto-correct
​
uule
string
Encoded location in UULE format for precise geo-targeting
​
googleDomain
string
default:"www.google.com"
Google domain to use (e.g., www.google.co.uk, www.google.de)
​
rawHtml
boolean
default:"false"
Return raw HTML instead of parsed results
​
async
boolean
default:"false"
Async mode - returns job ID immediately for later retrieval

​
Example Requests

curl -X GET "https://api.scrapengine.io/api/v1/google/search?q=best%20coffee%20shops&gl=us&num=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.scrapengine.io/api/v1/google/search?q=restaurants&location=New%20York%2C%20USA&device=mobile" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
News Search with Time Filter

curl -X GET "https://api.scrapengine.io/api/v1/google/search?q=technology&tbm=news&tbs=qdr:d" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

Returns parsed search results with organic listings, ads, and other components: 
{
  "searchInformation": {
    "totalResults": "1250000000",
    "searchTime": 0.45
  },
  "organicResults": [
    {
      "position": 1,
      "title": "Best Coffee Shops in NYC - Top 10 List",
      "link": "https://example.com/best-coffee-nyc",
      "displayLink": "example.com",
      "snippet": "Discover the best coffee shops in New York City with our curated list of local favorites and hidden gems...",
      "date": "2024-01-10"
    },
    {
      "position": 2,
      "title": "Coffee Shop Guide 2024",
      "link": "https://coffeeguide.com/nyc",
      "displayLink": "coffeeguide.com",
      "snippet": "Your complete guide to finding the perfect coffee shop..."
    }
  ],
  "ads": [
    {
      "position": 1,
      "title": "Premium Coffee Shop Equipment",
      "link": "https://ads.example.com/coffee-equipment",
      "displayLink": "ads.example.com",
      "description": "Shop professional coffee equipment at competitive prices"
    }
  ],
  "relatedSearches": [
    "best coffee shops near me",
    "coffee shops with wifi",
    "specialty coffee shops"
  ],
  "pagination": {
    "current": 1,
    "next": "https://api.scrapengine.io/api/v1/google/search?q=best+coffee+shops&start=10"
  }
}

​
Response Headers

HeaderDescription
x-remaining-creditsNumber of API credits remaining
x-trace-idUnique identifier for the request

​
Error Responses

StatusDescription
400Bad Request - Invalid query parameters
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Use Cases

  • SEO monitoring: Track keyword rankings and SERP positions
  • Competitor analysis: Monitor competitor visibility in search results
  • Market research: Analyze search trends and popular content
  • Lead generation: Find businesses and contact information
  • Content research: Discover trending topics and content gaps
  • Ad monitoring: Track competitor advertising strategies