SPspyfu
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

Request

  • Base URL
    https://api.spyfu.com/apis/serp_api
  • URL
    https://api.spyfu.com/apis/serp_api/v2/seo/getSerpAnalysisKeywords
  • Auth
    • HTTP basic
    • or API key in query parameter api_key
    • or API key in header Authentication

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
}

Changes

No recorded changes to this operation across all 1 revision of this API.