Docs / API reference

GET/v1/data/google/serp

Google SERP

Return live Google results as structured JSON in Lite or Advanced mode.

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.

Google SERP Endpoint

Lite returns organic and available non-AI rich blocks; Advanced also returns AI Overview content.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run a Lite Search

Return ranked organic results with the smallest request.

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

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Result Modes

Lite Results

Use advanced=false for organic results plus available ads, featured snippets, People Also Ask, related searches, videos, local results, and knowledge panels.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=best%20crm%20software&advanced=false" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Advanced Results

Use advanced=true when you also need AI Overview extraction.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=best%20crm%20software&advanced=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Pagination

Fetch Consecutive Pages

Start at page, fetch up to 10 pages, and request up to 100 results per page.

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

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Targeting

Country and Language

Set the Google country, language, domain, and optional canonical location.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=coffee%20shops&country=in&language=en&domain=www.google.co.in&location=Chennai%2CTamil%20Nadu%2CIndia" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Encoded Location

Send uule when your application already has an encoded Google location.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=coffee%20shops&uule=w%2BCAIQICImQ2hlbm5haSxUYW1pbCBOYWR1LEluZGlh" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Search Controls

Device and Filters

Choose mobile rendering, SafeSearch, and a relative time window.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=AI%20regulation&mobile=true&safe_search=true&time_range=week" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Cache and Debug

Bypass cache for a fresh run; request diagnostics only while developing.

curl -X GET "https://api.datablue.dev/v1/data/google/serp?query=AI%20regulation&no_cache=true&debug=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

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"
        }
      ]
    }
  ],
  "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"
    }
  ],
  "videos": [],
  "local_results": []
}

Response

Read organic_results in both modes. Advanced mode may also return ads, questions, videos, and other rich blocks.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

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	Consecutive Google pages to fetch from page (1-10). Example: page=1&pages=3 fetches pages 1, 2, and 3.
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 with organic and available non-AI rich blocks; true = Advanced with AI Overview extraction. 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.
no_cache	boolean	Optional	Bypass the rendered SERP cache for this request.
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. Returned only in Advanced mode.
featured_snippet	object	Featured snippet when present. Available in Lite and Advanced modes.
organic_results	array	Ranked organic results with position, title, url, displayed_url, snippet, and sitelinks when Google shows them.
ads	array	Paid results when Google includes them. Available in Lite and Advanced modes.
people_also_ask	array	People Also Ask questions when Google includes the block. Available in Lite and Advanced modes.
related_searches	array	Related Google search suggestions with query and Google search url when present.
videos	array	Video carousel results when Google includes them. Available in Lite and Advanced modes.
local_results	array	Local pack results when Google includes them. Available in Lite and Advanced modes.
knowledge_panel	object	Knowledge panel data when Google includes it. Available in Lite and Advanced modes.
error	object	Clean error object returned on failed requests. Failed pages are not charged.

Request and response

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"

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": [],
  "local_results": [],
  "knowledge_panel": null
}