POST/v1/data/google/search-advanced

Google Search Advanced API

Advanced live Google SERP API backed by DataBlue's rendered browser fleet. Send one query per request and receive clean organic results, SERP features, and billing metadata. Use pages for deeper SERP collection, country/domain/language for localization, and location or uule for city-level targeting.

Target Latency

1.2s - 4.5s

Credits

1 cr/req

Parameters

Name	Type	Requirement	Description
query	string	REQUIRED	Search query (1-2048 characters).
country	string	optional	Google gl country / proxy geo. Supported: ae, au, bh, ca, de, es, fr, gb, in, it, kw, nl, om, qa, sa, sg, us. Aliases like uk, usa, india, saudi arabia, uae are normalized.
language	string	optional	Google hl language code, e.g. en, ar, hi.
domain	string	optional	Optional Google domain, e.g. www.google.co.in or www.google.com.sa. If omitted, DataBlue chooses the matching Google domain.
location	string	optional	Optional canonical Google location used to generate uule, e.g. Chennai,Tamil Nadu,India.
uule	string	optional	Optional pre-encoded Google uule location parameter. If both location and uule are provided, uule is used.
page	number	optional	Starting Google page, 1-indexed. Use page=2 to start from Google's second result page.
pages	number	optional	Number of Google pages to fetch for this query (1-5). Each page returns up to 10 organic results; pages=3 returns about 30 organic results when all pages succeed.
platform	string	optional	Rendered device profile: "desktop" or "mobile".
safe_search	boolean	optional	Enable Google safe search filtering.
time_range	string	optional	Relative Google time filter. Use "hour", "day", "week", "month", or "year"; do not send a date string.

Response Fields

Field	Type	Description
organic_results	array	Standard Google organic results. Each item includes position, title, url, displayed_url, and snippet when Google shows one.
featured_snippet	object	Featured answer, table, list, or AI Overview surfaced above the organic results when present.
people_also_ask	array	Questions from Google's People Also Ask block when present.
related_searches	array	Related Google search suggestions when present.
search_information	object	Google URL, requested page range, results per page, country, domain, language, and platform used for the request.
billing	object	Billing settlement. billable_pages equals successfully served pages; failed pages are not charged.

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/google/search-advanced" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best running shoes india",
  "pages": 3,
  "language": "en",
  "country": "in",
  "platform": "desktop"
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "complete": true,
  "partial": false,
  "job_id": "b29bdd8e-4dbd-4d94-a9ca-09187a137c6d",
  "query": "best running shoes india",
  "source": "google_rendered",
  "country": "in",
  "domain": "www.google.co.in",
  "language": "en",
  "platform": "desktop",
  "requested_pages": 3,
  "successful_pages": 3,
  "failed_pages": 0,
  "time_taken": 10.309,
  "organic_results": [
    {
      "position": 1,
      "title": "Best Running Shoes Online in India",
      "displayed_url": "https://www.nike.com/in/w/running-shoes",
      "snippet": "Explore running shoes designed for road, trail, and everyday training.",
      "url": "https://www.nike.com/in/w/running-shoes"
    },
    {
      "position": 2,
      "title": "Running Shoes for Men and Women",
      "displayed_url": "https://www.adidas.co.in/running-shoes",
      "snippet": "Shop lightweight running shoes for training, racing, and daily wear.",
      "url": "https://www.adidas.co.in/running-shoes"
    }
  ],
  "billing": {
    "billable_pages": 3,
    "billable_keywords": 1,
    "failed_pages_charged": 0
  },
  "search_information": {
    "query_displayed": "best running shoes india",
    "organic_results_state": "Results for exact spelling",
    "url": "https://www.google.co.in/search?q=best+running+shoes+india&num=10&start=0&hl=en&gl=in",
    "page": 1,
    "pages_requested": 3,
    "requested_pages": 3,
    "successful_pages": 3,
    "failed_pages": 0,
    "results_per_page": 10,
    "organic_results_count": 30,
    "country": "in",
    "domain": "www.google.co.in",
    "language": "en",
    "platform": "desktop"
  },
  "people_also_ask": [
    {
      "question": "Which brand is best for running shoes in India?"
    },
    {
      "question": "Which shoes are best for daily running?"
    }
  ],
  "related_searches": [
    {
      "query": "best running shoes for men india"
    },
    {
      "query": "best running shoes under 5000"
    }
  ]
}