v1

latestOpenAPI 3.1.02026-07-24490622.0 KB

SEO Research API

Get SERP Analysis for Keyword

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

get/v2/seo/getSerpAnalysisKeywords

Query parameters

keywordstring required

Example:electric car

Keyword to analyze for SERP ranking data.

pageSizeinteger

Number of ranking results to return (maximum 105 for top 100+ positions).

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'

Example:US

Country market to search. Specifically, this maps to the Google domain version to query against (e.g., google.com for US, google.de for Germany, etc.). <a href='https://developer.spyfu.com/reference/adhistoryapi_getdomainadhistory_get#/'>All Countries</a>

Response

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

resultCountinteger

Number of results returned

totalMatchingResultsinteger

Total number of keywords available that match the query criteria, including results not included in the current page.

Example response

{
  "resultCount": 100,
  "results": [
    {
      "keyword": "running shoes",
      "domain": "example.com",
      "url": "https://example.com/blog",
      "title": "Best Running Shoes for Athletes",
      "rank": 7,
      "rankChange": -3,
      "searchVolume": 700000,
      "rankingHomepages": 10,
      "keywordDifficulty": 69,
      "dateSearched": "2024-09-26T10:30:00Z"
    }
  ],
  "totalMatchingResults": 25000
}