---
title: "Analyze SERP"
method: POST
path: "/serp/analyze"
tags: ["SERP"]
---

# Analyze SERP

`POST /serp/analyze`

## Request

- Base URL: `https://next.frase.io/api/v1`
- URL: `https://next.frase.io/api/v1/serp/analyze`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Analyze search results for a keyword, including AI Overview and PAA.

## Request body

- object
  - `keyword` string, required
  - `location` string
  - `country_code` string
  - `language_code` string
  - `num` integer: Number of SERP results to fetch

## Response `200`

SERP analysis

- SERPAnalysis
  - `keyword` string
  - `search_parameters` object
    - `location` string
    - `country_code` string
    - `language_code` string
    - `num_results` integer
  - `search_info` object
    - `total_results` integer, nullable
    - `time_taken` number, nullable
  - `ai_overview` object, nullable
    - `text` string
    - `sources` object[]
      - `title` string
      - `url` string
      - `snippet` string, nullable
  - `organic_results` object[]
    - `position` integer
    - `title` string
    - `url` string
    - `snippet` string
  - `people_also_ask` object[]
    - `position` integer
    - `question` string
    - `snippet` string, nullable
    - `source_url` string, nullable
  - `related_searches` string[]

## Other responses

- `429`: Rate limit exceeded

---

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