---
title: "Get SERP Analysis for Keyword"
method: GET
path: "/v2/seo/getSerpAnalysisKeywords"
tags: ["SEO Research API"]
---

# Get SERP Analysis for Keyword

`GET /v2/seo/getSerpAnalysisKeywords`

Returns detailed search engine results page (SERP) analysis for a specific keyword, showing all domains ranking in positions 1-100. This endpoint provides comprehensive ranking data updated monthly to reveal the competitive landscape for any keyword.

[Visualize this API live on SpyFu](https://www.spyfu.com/keyword/serp-analysis?query=example%20keyword)

## Query parameters

- `keyword` string, required
- `pageSize` integer
- `countryCode` 'AR' | 'AT' | 'AU' | 'BE' | 'BR' | 'CA' | 'CH' | 'DE' | 'DK' | 'ES' | 'FR' | 'IE' | 'IN' | 'IT' | 'JP' | 'MX' | 'NL' | 'NO' | 'NZ' | 'PL' | 'PT' | 'SE' | 'SG' | 'TR' | 'UA' | 'UK' | 'US' | 'ZA'

## Response `200`

Successfully retrieved SERP analysis data for the keyword. Returns ranking positions 1-100+ with domain URLs, titles, and competitive metrics.

- object — Response wrapper containing SERP analysis keyword results with detailed ranking data and competitive landscape insights.
  - `resultCount` integer — Number of results returned
  - `results` object[], nullable — Array of keywords with detailed SERP analysis including ranking data, search volume metrics, and competitive landscape insights.
    - `keyword` string, nullable — The keyword for which this domain ranks organically in the top 100 search results.
    - `domain` string, nullable — The domain name that ranks for this keyword in organic search results.
    - `url` string, nullable — The specific URL from this domain that ranks for this keyword.
    - `title` string, nullable — The page title of the ranking URL as it appears in search results.
    - `rank` integer — Current organic search position for this keyword (1 = top position).
    - `rankChange` integer, nullable — Change in ranking position since the previous measurement period (positive values indicate ranking improvement; negative values indicate moving further down the SERP).
    - `searchVolume` integer, nullable — Monthly search volume for this keyword based on Google search data across the selected country/region.
    - `rankingHomepages` integer, nullable — Number of domain homepages (vs. deeper pages) ranking in the top 100 organic results for this keyword.
    - `keywordDifficulty` integer — SEO difficulty score (1-100) indicating how challenging it would be to rank organically for this keyword, with 100 being most difficult.
    - `dateSearched` string, date-time — Date when this keyword was first discovered and added to SpyFu's database.
  - `totalMatchingResults` integer — Total number of keywords available that match the query criteria, including results not included in the current page.

## Other responses

- `400` — Bad Request - Invalid parameters provided (e.g., missing keyword, invalid pageSize, or invalid country code)
- `401` — Unauthorized - Invalid API credentials or insufficient permissions to access SERP analysis data
- `500` — Internal Server Error - A server-side error occurred while processing the request

---

[API](https://skmtc.net/spyfu/apis/domain-stats-api.md) · [All operations](https://skmtc.net/spyfu/apis/domain-stats-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spyfu/domain-stats-api/versions/44f0aff08ed0/schema)