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

# Fast SERP

`POST /v1/fast-serp`

## Request body

- SerpPayload — Request body model for the /serp endpoint
  - `country` string — ISO Alpha-2 country code used to access the target search engine (e.g. US, DE, GB).
  - `device` 'desktop' | 'mobile' — Device type used for the search request.
  - `domain` string — Top-level domain for the search engine (e.g. "com", "co.uk", "de").
  - `locale` string — Locale used for the search request.
  - `location` string — Geo-location for the search (canonical Google location name).
  - `num_results` integer — Number of results to return (1–100).
  - `page` integer — The result page number for pagination.
  - `parse` boolean — When true, the SERP response is parsed into structured JSON.
  - `query` string — The search keyword or phrase to query.
  - `render` boolean — Whether to render the page in a browser before extracting.
  - `search_engine` 'google_search' | 'google_sge' | 'google_aio' | 'google_maps_search' | 'google_maps_reviews' | 'google_maps_place' | 'google_news' | 'google_images' | 'bing_search' | 'yandex_search', required — The search engine to query.
  - `show_hidden_results` boolean — When true, disables Google result filtering (filter=0) so omitted/duplicate and highly similar pages are also returned. Applies to Google search engines.

## Other responses

- `200` — unresolved $ref

---

[API](https://skmtc.net/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.net/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/9bfe220b7a29/schema)