---
title: "Serp Search"
method: POST
path: "/v1/serp"
tags: ["serp"]
---

# Serp Search

`POST /v1/serp`

## Request

- Base URL: `https://api.snoopscan.com`
- URL: `https://api.snoopscan.com/v1/serp`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- SerpRequest
  - `keyword` string, required: The search to look up, as it would be typed into Google.
  - `country` string: Two-letter code of the country whose results you want, e.g. `gb`.
  - `locationCode` integer, nullable: Google's own geographic target ID, for somewhere finer than a country. Overrides `country`.
  - `language` string: The language code of the results, e.g. `en`.
  - `device` 'desktop' | 'mobile': `desktop` or `mobile`.
  - `depth` integer: How many results to read, 1 to 100.
  - `aiOverview` boolean: Include Google's AI Overview and the pages it cites. On by default.
  - `domain` string, nullable: Your site. When given, the answer says where it ranks and whether the AI Overview cites it.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/snoopscan/apis/snoopscan-api.md) · [All operations](https://skmtc.dev/snoopscan/apis/snoopscan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snoopscan/apis/snoopscan-api/revisions/c278cdbcaf7b?raw)