Advanced Web Ranking

Get the People Also Ask (PAA) headline figures for a project over a date range: how many questions were shown, how much of the tracked keyword set showed a PAA box, how many domains answered those questions and who owns them. An empty result means no People Also Ask data for this scope or a failed read - it is not proof the project has none.

peopleAlsoAskGetSummary

Get a project's PAA questions broken down by topic over a date range, with the answered-by-you / not-answered-by-you split, competitor-owned counts and the top answering competitors per topic. Capped at the 40 largest topics. Two extra rows are NOT topics: 'Branded' is a cross-cut whose questions are also counted inside their own topic rows, and 'Uncategorized' holds the questions with no active topic - the 'Topic Type' column tells them apart. An empty result means no People Also Ask data for this scope or a failed read - it is not proof the project has none.

peopleAlsoAskGetTopicBreakdown

Per-URL difficulty breakdown of one keyword's SERP: Domain Difficulty, URL Difficulty, Content Score, Trust Flow, Citation Flow, referring domains and backlinks for each ranking URL. Use it to judge how reachable a position is. currentDate must be a date returned by getDifficultyUpdates.

getSerpDifficulty

Keywords where a SERP feature appeared or disappeared between the two dates, with whether the website ranks inside it and the Keyword Ranking columns. Use after rankGetLosers to check whether a feature took the clicks.

serpFeaturesGetChanges

SERP feature breakdown for a website and engine at two dates: for each feature, how many tracked keywords show it and in how many the website ranks inside it.

serpFeaturesGetSummary

Stored SERPs for a keyword and engine across a date range, one snapshot per update. Use it to see which URLs entered, left or moved and when a feature appeared.

serpGetHistory

SERP volatility for a keyword and engine over a date range: how much the top results reshuffled between updates. High volatility points to a SERP-wide change rather than a page problem.

serpGetVolatility

Search Intent breakdown of a project's tracked keywords on one engine: how many are Navigational, Informational, Commercial and Transactional, how many have mixed intent, and how many changed intent since the previous check. A mixed-intent keyword counts under both of its intents. To list the keywords behind a count, use getRankings with an intent filter.

keywordGetIntentSummary

One domain's URLs in one keyword's stored SERP on one engine: position, previous position and change, title, the SERP feature the URL appears in, pixel position and height on Google, AIO Citation Rank and Top AIO Source. Use it after topSitesGetDomains to see which pages a domain ranks with.

topSitesGetUrls

Every domain in one keyword's stored SERP on one engine, as the Top Sites report shows it: best position and previous best position, number of URLs, whether it is your website, a tracked competitor or not tracked, Pixel Height on Google, best AIO Citation Rank and whether it is a Top AIO Source. Your website's row carries the keyword's Brand Ownership (share of SERP pixel height). Use it to find competitors nobody added; topSitesGetUrls lists one domain's URLs.

topSitesGetDomains

Title and meta description of one or more URLs as captured in the SERP for a keyword and engine at one date. Use it to compare the snippets of competing pages with the website's own.

urlsGetTitleAndMetaDescription

Account overview: plan name, keyword units included, used and remaining in the current cycle, add-ons (AI credits, Keyword Research) and renewal date. Use it for plan and budget questions and before estimating how many more keywords can be tracked (1 unit = 1 keyword, weekly, on 1 engine). Account-level; needs no project.

getAccountDetails

Best position a URL reached for a keyword on an engine within the date range, and on which update. Use it to show how far a keyword has fallen from its peak or to set a realistic target.

rankGetBestHistoricalPosition

What changed between two updates, in one call: how many keywords improved, declined, started ranking and stopped ranking for a website on one engine, how many SERP features it won and lost, and how many alerts fired for the project in that period. The keyword counts match rankGetGainers, rankGetLosers, rankGetNewRankings and rankGetLostRankings; use those to list the keywords behind a count.

getChangesSummary

List the keywords of one keyword cluster at one snapshot, with each keyword's volume, CPC, intent and the position and URL it ranks with. 'Primary' marks the keyword the cluster is named after. Omit the cluster to list the Unclustered keywords instead - the tracked keywords that joined no cluster.

keywordClustersGetKeywords

Keyword overlap between one website and selected competitors on one engine: shared keywords and each side's Estimated Visits. Use for head-to-head and gap questions; for the full Keyword Gap classification use the report.

visibilityGetCompetitors

Tracked competitors of a project (up to 50): domains, subdomains or URLs. Any of them can be passed as website to the ranking and visibility tools to see the project from the competitor's side.

getCompetitors

The SERP stored for a keyword on an engine at one update date: every result in order with URL, title and the SERP features present, as AWR captured it in a real geo-located browser search. Use it to show who ranks around the website and which features take space; compare dates with serpGetHistory.

serpGetCurrent

Dates on which Keyword Difficulty was recomputed for a keyword on an engine. Difficulty runs on its own schedule, so call this before getKeywordsDifficulty or getSerpDifficulty when the latest ranking date returns no difficulty data.

getDifficultyUpdates

Estimated Visits per update for one or more websites on one engine across a date range. Chart-ready; one row per update.

trafficGetVisitsTrend

List the dates a project's keyword clusters were measured on (stored snapshots), newest first. Call this before the other keywordClusters tools and pick startDate / stopDate out of it: the clusters are re-computed after each ranking update, and only these dates hold data.

keywordClustersGetDates

Get one keyword cluster in detail at one snapshot: its figures, intent mix and cluster page, every page of yours that ranks for it, the URLs most common across its SERPs (marked [You] or [Competitor] when they belong to a tracked website) and the SERP features its keywords show.

keywordClustersGetClusterDetails

List a project's topic groups at one snapshot - the groups of related keyword clusters - largest first by keyword count, with each group's demand, its share of the tracked keywords, its ranking band and its pillar page (the page of yours covering most of it). The clusters that belong to no group share one 'No topic group' row. Every page ends with an 'Unclustered' row holding the tracked keywords that joined no cluster; it is NOT a group, and the 'Row Type' column tells it apart.

keywordClustersGetTopicGroups

List a project's keyword clusters at one snapshot - the report's main table. A cluster is a set of tracked keywords Google answers with the same pages, so one page can target them all. Each row carries the cluster's demand, intent mix, average position, ranking band and cluster page (the page of yours ranking for most of its keywords). Sorted by opportunity by default: uncovered clusters first, then the ones on page 2, each by search volume. Use keywordClustersGetSummary for the total cluster count.

keywordClustersGetClusters

Get the Keyword Clusters headline figures for a project at one snapshot, each beside its value at the comparison snapshot: how many clusters the tracked keywords form, how many keywords were clustered, the average position of the cluster pages, and how many clusters rank in the top 10, on page 2 (11-20) or not at all (uncovered). '-' marks a value that does not exist, e.g. no comparison on a project's first snapshot.

keywordClustersGetSummary

Keyword Difficulty per tracked keyword on one engine: Global, Domain and URL Difficulty, Content Score, Search Intent and the position at the difficulty date. Dates come from getDifficultyUpdates, not getUpdates.

getKeywordsDifficulty

Keyword groups of a project (static and dynamic) with keyword counts. Group names are accepted by the keywordGroup parameters of the other tools; -1 means all tracked keywords.

getKeywordsGroups

Tracked keywords with search volume, Keyword Difficulty, CPC, competition and Search Intent for one website, engine and date, with the same filters and columns as getRankings. Use it when the question is about demand or difficulty rather than movement.

keywordGetMetrics

Position and ranking URL of one keyword for one website on one engine at one date. The quickest answer to "where do we rank for X"; use rankGetHistory for the trend and getRankings for many keywords at once.

rankGetPosition

The Keyword Ranking table for one website, engine and date pair: position and previous position, ranking URL, page, search volume, difficulty, intent, Click Share, Estimated Visits, Pixel Position, SERP features, Search Console metrics and, on AI engines, Citation Rank, AI Brand Mentions and Citations. Scope by keyword group, filter by numeric ranges, sort by any column, paginate. For change lists use rankGetGainers / rankGetLosers; for one keyword over time use rankGetHistory.

getRankings

Landing pages of a website on one engine with keywords ranking, highest rank, average rank, Visibility Score and %, Click Share and Estimated Visits at two dates. Average rank exists only here, per page; Keyword Ranking has no keyword-level average.

getLandingPagesPerformance

Keywords that ranked at previousDate and do not rank at currentDate. "Not ranked" means beyond the project's search depth (top 10, 20, 30, 50 or 100 by project setting), not necessarily out of Google.

rankGetLostRankings

Market Share (share of the estimated organic traffic of the keyword set) for one or more tracked websites on one engine over a date range. Covers tracked websites only; the untracked SERP domains of the Market Share report are not included.

visibilityGetMarketShare

Keywords that were not ranked at previousDate and rank at currentDate, within the project's search depth. Use with rankGetLostRankings for the "added / dropped" part of a report.

rankGetNewRankings

Movement summary for every project in the account over the last 2 updates, last month, 3 months or year: keywords moved up and down, added and dropped, and the visibility change. The right first call for portfolio questions ("how are all my clients doing"). One row per project; drill into one with getRankings.

getProjectsPerformance

One project's setup: main website, update frequency, latest and previous update dates, counts of keywords, search engines and competitors. Use it to pick default dates and to describe or audit a project. For the lists themselves use getSearchEngines, getKeywords and getCompetitors.

getProjectDetails

Search engines tracked in a project, named with device and location (e.g. "Google US Mobile"). Every ranking, SERP and visibility tool needs one of these names. Desktop and Mobile are separate engines; AI engines are listed here too.

getSearchEngines

How a website's keywords spread across position bands (1, 2-5, 6-10, 11-20, 21-50, 51-100, not ranked) on one engine at the current and previous date. Use for page-1 share and the positions 11-20 count. getDomainsDistribution gives the same for every competitor at once.

rankGetDistribution

Position-band distribution for the main website and every tracked competitor on one engine and date pair: ranked keywords, 1st place, 2-5, 6-10, 11-20, 21-50, 51-100, not ranked. Use for "who owns page 1" across the competitor set.

getDomainsDistribution

Keywords whose position improved between previousDate and currentDate for a website on one engine, with both positions, the change and the ranking URL. Sorted by largest gain; paginate for the full list.

rankGetGainers