---
title: "Fast Google SERP"
method: POST
path: "/v1/realtime/serp"
tags: ["Fast SERP"]
---

# Fast Google SERP

`POST /v1/realtime/serp`

## Request

- Base URL: `https://api.us.webit.live/api`
- URL: `https://api.us.webit.live/api/v1/realtime/serp`
- Auth: HTTP bearer

## Request body

- FastSerpPayload: Request body model for the fast serp endpoint
  - `search_engine` 'google_search' | 'google_news' | 'google_images' | 'google_maps_search' | 'google_maps_place' | 'google_maps_reviews', required: The search engine to query
  - `query` string: The search query string. Required for google_search, google_news, google_images, and google_maps_search
  - `place_id` string: Google Maps place identifier. Required for google_maps_place and google_maps_reviews
  - `coordinates` object
    - `latitude` string: Google Maps place identifier. Required for google_maps_place and google_maps_reviews
    - `longitude` string
  - `time` string: Filter results by time range. Only supported for google_search, google_news, and google_images
  - `country` string: Run the search as if from a specific country. Returns geo-localized results (optimized for US)
  - `locale` string: Language preference for the search results. Use LCID standard
  - `location` string: Location context for the search. Accepted for google_search, google_news, and google_images — not supported for Maps engines. Pass a location string (e.g. "United States", "New York, NY") or a raw Google UULE value.
  - `no_html` boolean: When set to true, removes the html_content field from the response
  - `resolve_url` boolean: Resolves redirect or broken URLs to their real destination. Adds a small increase in latency. If an individual result can't be resolved, that result falls back to the raw URL instead of failing the whole request.

## Response `200`

Successful Response

- SerpResponse: Response from the Fast SERP realtime API. All engines share the same top-level envelope; entity types under parsing.entities vary by search_engine.
  - `task_id` string, required: Unique identifier for this request
  - `status` 'success' | 'error', required: Request status
  - `query_time` string, date-time: ISO timestamp of when the query ran
  - `status_code` integer, required: HTTP status code from the upstream source
  - `url` string: The upstream URL that was queried
  - `input_url` string: The original input URL before any redirects
  - `html_content` string, nullable: Raw HTML of the response page. Omitted when no_html is true.
  - `driver` string: Internal routing driver used for this request
  - `parsing` object, required: Structured parsing output. Entity types under entities vary by search_engine.
  - `nimble_links` object, nullable: Pagination links as ready-to-use Nimble API URLs (Maps engines)
    - `next_page` string: URL to fetch the next page of results
  - `nimble_payload` object, nullable: Next-page parameters as a structured object (web search engines)

## Other responses

- `400`: Unprocessable Entity - Validation Error
- `402`: Payment Required
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

## Changes

- **2026-11-03** `75720b84c9d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nimbleway/apis/nimble-sdk/changes/v1/realtime/serp/post.md)

---

[API](https://skmtc.dev/nimbleway/apis/nimble-sdk.md) - [All operations](https://skmtc.dev/nimbleway/apis/nimble-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/nimbleway/apis/nimble-sdk/revisions/75720b84c9d7?raw)