Sign in

v1

latestOpenAPI 3.1.02026-07-24490622.0 KB
SEO Research API

Get Top Performing Pages

Returns top organic pages for a domain, subdomain, path, or full URL. Use searchType to choose: MostTraffic (highest estimated SEO clicks) or New (newly gaining traffic). Results include page URL and monthly SEO clicks; optional keywordFilter narrows by ranked keywords.

get/v2/seo/getTopPages

Query parameters

querystring required
Example:example.com

Domain or URL to analyze. Accepts full domains (example.com), complete URLs (https://example.com/blog), subdomains (blog.example.com), or specific paths (example.com/products/).

searchType'MostTraffic' | 'New' required
Example:MostTraffic

Required. Selects page analysis type: MostTraffic=pages generating most organic traffic overall, New=pages recently discovered with significant traffic. Determines whether to return established top performers or emerging high-traffic pages.

keywordFilterstring
Example:hosting

Filter to pages that rank for keywords containing this term. Helps narrow results to specific topics or content themes.

seoClicks.minnumber float

Filter to pages where estimated monthly organic clicks are ≥ this value.

seoClicks.maxnumber float
Example:10000

Filter to pages where estimated monthly organic clicks are ≤ this value.

pageSizeinteger
Example:5

The maximum number of rows returned.

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>

sortBy'SeoClicks'
Example:SeoClicks

Column to sort by.

sortOrder'Ascending' | 'Descending'
Example:Descending

Order to sort the results.

startingRowinteger
Example:1

Row number to start the results with.

Response

OK

resultCountinteger

Number of results returned

Example response

{
  "resultCount": 100,
  "results": [
    {
      "title": "Best Running Shoes 2024 - Complete Buyer's Guide",
      "url": "https://example.com/best-running-shoes-2024",
      "keywordCount": 247,
      "estMonthlySeoClicks": 15420,
      "topKeyword": "best running shoes",
      "topKeywordPosition": 3,
      "topKeywordSearchVolume": 74000,
      "topKeywordClicks": 8950
    }
  ]
}