Google SERP

DataBlue Google SERP API returns live Google search results as structured JSON. It supports Lite organic mode, Advanced rich SERP mode, desktop/mobile rendering, country/domain/language targeting, location/uule targeting, safe search, time filters, multi-page pagination, clean public errors, and success-based page billing.

Execution Model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit Weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
query	string	REQUIRED	Search query (1-2048 characters).
country	string	optional	Google gl country / proxy geo. Examples: us, in, gb, ae, sa, sg, au, ca, de.
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. If omitted, DataBlue chooses the matching Google domain.
page	number	optional	Starting Google page, 1-indexed. Use page=2 with pages=1 to fetch only the second Google page.
pages	number	optional	Number of consecutive Google pages to fetch from page (1-5). Example: page=1&pages=3 fetches pages 1, 2, and 3. Billing follows the live catalog for each successful billable page.
results	number	optional	Requested Google results per page. Use 10 for normal SERP pages; combine with pages for 20 or 30 total results.
advanced	boolean	optional	false = Lite organic-focused SERP, true = Advanced rich SERP mode. The active credit weight is shown in the live catalog and pricing UI.
mobile	boolean	optional	false = desktop SERP, true = mobile-rendered SERP.
safe_search	boolean	optional	Enable Google safe search filtering.
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.
time_range	string	optional	Relative Google time filter. Use "hour", "day", "week", "month", or "year"; do not send a date string.
debug	boolean	optional	Developer diagnostics for this request. Hidden by default.

Response Fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
search_metadata	object	Request ID, status, source, and total time taken.
search_parameters	object	Normalized query, country, language, domain, page, pages, results, advanced, and mobile values used.
search_information	object	Organic result count and total results when Google exposes it.
ai_overview	object	AI overview content when present. Advanced mode is recommended for this block.
featured_snippet	object	Featured snippet when present. Advanced mode is recommended for this block.
organic_results	array	Ranked organic results with position, title, url, displayed_url, snippet, and sitelinks when Google shows them.
ads	array	Paid results when present. Advanced mode is recommended for this block.
people_also_ask	array	People Also Ask questions. Usually available in Advanced mode when Google shows the block.
related_searches	array	Related Google search suggestions with query and Google search url when present.
videos	array	Video carousel results when present. Advanced mode is recommended for this block.
pagination	object	Current page, next page URL, and page number URL map when Google exposes pagination links.
local_results	array	Local pack results when present. Advanced mode is recommended for this block.
knowledge_panel	object	Knowledge panel data when present. Advanced mode is recommended for this block.
error	object	Clean error object returned on failed requests. Failed pages are not charged.

cURL Example

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=best%20crm%20software&country=in&language=en&page=1&pages=1&results=10&advanced=false&mobile=false" \
  -H "Authorization: Bearer YOUR_API_KEY"

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,
  "search_metadata": {
    "id": "serp_01jz7p7z5x8q3w2y9n6c0v4r1a",
    "status": "success",
    "time_taken": 8.142,
    "source": "datablue_google_serp"
  },
  "search_parameters": {
    "query": "best crm software",
    "country": "in",
    "language": "en",
    "domain": "www.google.co.in",
    "page": 1,
    "pages": 1,
    "results": 10,
    "advanced": false,
    "mobile": false
  },
  "search_information": {
    "organic_results_count": 2,
    "total_results": "About 42,300,000 results"
  },
  "ai_overview": null,
  "featured_snippet": null,
  "organic_results": [
    {
      "position": 1,
      "title": "Best CRM Software in India",
      "url": "https://example.com/best-crm-software-india",
      "displayed_url": "example.com",
      "snippet": "Compare CRM platforms for sales, support, automation, and reporting.",
      "sitelinks": [
        {
          "title": "Pricing",
          "url": "https://example.com/best-crm-software-india/pricing"
        },
        {
          "title": "Features",
          "url": "https://example.com/best-crm-software-india/features"
        }
      ]
    },
    {
      "position": 2,
      "title": "Top CRM Tools for Growing Businesses",
      "url": "https://example.org/crm-tools",
      "displayed_url": "example.org",
      "snippet": "A practical guide to choosing CRM software for your team."
    }
  ],
  "ads": [],
  "people_also_ask": [],
  "related_searches": [
    {
      "query": "best crm software for small business",
      "url": "https://www.google.co.in/search?q=best+crm+software+for+small+business&hl=en&gl=in"
    },
    {
      "query": "crm software pricing",
      "url": "https://www.google.co.in/search?q=crm+software+pricing&hl=en&gl=in"
    }
  ],
  "videos": [],
  "pagination": {
    "current": "1",
    "next": "https://www.google.co.in/search?q=best+crm+software&hl=en&gl=in&start=10",
    "page_no": {
      "2": "https://www.google.co.in/search?q=best+crm+software&hl=en&gl=in&start=10"
    }
  },
  "local_results": [],
  "knowledge_panel": null
}