Nimble Fast SERP is a realtime API that returns live Google search results as structured data. Submit a query and get back organic listings, pagination, and related questions, parsed and typed at low latency with high success rates.Documentation Index
Fetch the complete documentation index at: https://docs.nimbleway.com/llms.txt
Use this file to discover all available pages before exploring further.
api.us.webit.live) only.
Native support through the Nimble SDK, CLI, and Python client is coming soon —
see sdk.nimbleway.com.Fast SERP SLA
Default SLA and limitations for Fast SERP API| Default | Description | |
|---|---|---|
| QPS | 10 (600 QPM) | Rate limiter - Query per Second |
| p50 | under 700ms | Latency |
| p90 | under 1000ms | Latency |
| Organic Results | 10 | Results per requets (google_search only) |
| Page rendering | Disabled | Not including rendered request |
| Country / Locale | US / en-US | Fixed — geo-targeting for other regions not supported |
Quick Start
Example Request
Example Response
Full response
Full response
How it works
Provide a query and search engine
google_search), and optional
geo-targetingNimble runs the search
Parameters
search_engine - Required
search_engine - Required
| Value | Description |
|---|---|
google_search | Standard Google web search |
google_news | Google News results |
google_images | Google Images results |
query
query
google_search, google_news, and google_images.Example: "NBA Allstars 2026"location
location
google_search and google_images.You can pass either:- A location string: Nimble resolves it to the corresponding UULE value (e.g.
"United States","New York, NY") - A raw UULE value: Google’s encoded location parameter (e.g.
"w+CAIQICIiChIJOwQ...")
"United States""London, England"
time
time
google_search and google_images.Options:| Value | Description |
|---|---|
hour | Past hour |
day | Past 24 hours |
week | Past week |
month | Past month |
year | Past year |
no_html
no_html
true, removes the html_content field from the response. Useful for reducing response size when raw HTML is not needed.Default: falsenum_results
num_results
google_search.| Engine | Range | Default |
|---|---|---|
google_search | 1–100 | 10 |
start
start
start: 20 skips the first 20 results and returns the next page.Example: 20include_pages_html
include_pages_html
true, returns raw HTML per individual result page instead of a single stitched HTML string. Only relevant when num_results exceeds 10. Supported on google_search and google_images.Default: falsedevice
device
google_search and google_images.| Value | Description |
|---|---|
mobile | Mobile user-agent and layout |
Search Engines
Google Search
Returns organic web results, pagination, related questions, top stories, answer boxes, and more. Supported parameters:query— search query string (required)num_results— number of results to return, 1–100, default 10start— result offset for fetching beyond the first batchlocation— physical location context (string or raw UULE value)time— filter results by recency (hour,day,week,month,year)include_pages_html— return per-page HTML instead of a single stitched stringdevice— emulate a specific device type (mobile)no_html— omithtml_contentfrom the response
Example Response
Example Response
Google News
Returns recent news articles matching the query, sourced from Google News. Supported parameters:Example Response
Example Response
Google Images
Returns image results for a query, including image URLs, titles, and source pages. Supported parameters:query— search query string (required)start— result offset for fetching beyond the first batchlocation— physical location context (string or raw UULE value)time— filter results by recency (hour,day,week,month,year)include_pages_html— return per-page HTML instead of a single stitched stringdevice— emulate a specific device type (mobile)no_html— omithtml_contentfrom the response
Example Response
Example Response
Response
All responses share the same top-level envelope:| Field | Description |
|---|---|
task_id | Unique request ID |
status | "success" or "error" |
query_time | ISO timestamp of when the query ran |
status_code | HTTP status code from the upstream source |
html_content | Raw HTML (omitted when no_html: true) |
parsing.entities | Object of typed arrays, keys vary by engine (see below) |
parsing.entities_count | Per-type entity counts |
nimble_payload | Next-page parameters as a structured object |
driver | Internal routing driver used for this request |
Entities by engine
google_search: OrganicResult, AnswerBox, Pagination & more
google_search: OrganicResult, AnswerBox, Pagination & more
| Field | Type | Description |
|---|---|---|
position | integer | Rank in the results (1-indexed) |
title | string | Page title as shown in search results |
url | string | Full destination URL |
snippet | string | Preview text shown under the result |
cleaned_domain | string | Root domain without protocol or path |
displayed_url | string | URL as displayed in Google results |
entity_type | string | Always "OrganicResult" |
| Field | Type | Description |
|---|---|---|
snippet | string | Answer text |
snippet_highlighted | array | Highlighted terms within the snippet |
display_link | string | Source URL displayed in the answer box |
| Field | Type | Description |
|---|---|---|
question | string | A “People also ask” question |
| Field | Type | Description |
|---|---|---|
position | string | Display position |
query | string | Related search term |
url | string | Google search URL for this term |
| Field | Type | Description |
|---|---|---|
current_page | integer | Current results page number |
next_page_url | string | Google URL for the next page |
other_page_urls | object | Map of page numbers to their Google URLs |
google_news: NewsResults
google_news: NewsResults
| Field | Type | Description |
|---|---|---|
head_title | string | Title of the news results section |
menu_items | array | Top-level navigation topics (U.S., World, Local, etc.) |
sub_menu_items | array | Secondary navigation tabs (Home, For you, Sports, etc.) |
news_results | array | Individual news articles (may be null for some queries) |
related_topics | array | Related topic suggestions |
google_images: ImageResult
google_images: ImageResult
| Field | Type | Description |
|---|---|---|
position | integer | Rank in the results (1-indexed) |
title | string | Image title or caption |
source_name | string | Name of the source website |
source_domain | string | Domain of the source website |
source_url | string | URL of the page containing the image |
image_url | string | Direct URL to the full-size image (may be null) |
thumbnail_url | string | URL of the thumbnail preview |
image_width | integer | Full-size image width in pixels |
image_height | integer | Full-size image height in pixels |
thumbnail_image_width | integer | Thumbnail width in pixels |
thumbnail_image_height | integer | Thumbnail height in pixels |
Async & Batch Requests
Parameters
storage_type
storage_type
s3 (Amazon S3), gs (Google Cloud Storage)storage_url
storage_url
{task_id}.json at the specified location.Format: s3://your-bucket/path/prefix/Example: s3://my-bucket/nimble-results/storage_compress
storage_compress
true, results are saved as {task_id}.json.gz.storage_object_name
storage_object_name
"my-custom-name" saves as my-custom-name.jsoncallback_url
callback_url
https://your-api.com/webhook/completeAsync API
Submit a request and receive atask_id immediately — results are delivered via polling, webhook callback, or directly to your cloud storage bucket.
task_id to poll for status or retrieve results.
Batch API
Submit multiple SERP requests in a single call using therequests array. Each item in requests becomes its own task. Parameters set outside requests apply as defaults to all tasks — values inside a request override the defaults.
Examples
Example 1: Multiple search terms
Example 1: Multiple search terms
Example 2: Different time filters per query
Example 2: Different time filters per query
time. Requests without a time filter return all-time results:Example 3: Same query across multiple engines
Example 3: Same query across multiple engines
search_engine per request:Batch response
Each task in the batch gets its ownid. Results are saved to storage_url and a callback fires per completed task.
Check batch progress
progress ranges from 0 to 1. When completed is true, all tasks are done.
List all batches
cursor until pagination.hasNext is false.
Retrieve batch summary
Once complete, fetch full task details for the entire batch:Pagination
google_news does not support pagination.- google_search
- google_images
Pull up to 100 results in one request
num_results: 100 to get up to 100 organic results in a single call. For most use cases, this eliminates pagination entirely."include_pages_html": true to your request.Limitations
| Engine | Limitation |
|---|---|
| All engines | Default QPS: 10 (600 QPM) — scales to 1,000. Contact Sales |
| All engines | Page rendering disabled by default |
| All engines | Country and locale fixed to US / en-US — other regions not supported |
google_search | num_results max 100 |
google_news | Pagination not supported |
google_news | location and time parameters not supported |