


Topvisor client report: groups, regions and top 10
Reportkey reads Topvisor ranking history through the API and turns it into tables per search engine, region and keyword group, so clients follow the trend without logging in to Topvisor.
- The Topvisor API key and User ID are entered once and reused across projects.
- Each search engine, region and keyword group gets a separate table.
- Topvisor rankings sit in the same client report as ads and web analytics.


Export Topvisor positions without spreadsheets
Topvisor is a solid rank tracker, but its interface is built for the SEO specialist. An agency client does not need check schedules or hundreds of history rows; they want to know what improved, what slipped and in which areas. The usual workaround is a monthly export and manual formatting. Reportkey handles that step: it reads ranking history from the Topvisor API and builds a section of a recurring report that the client receives as a link or PDF.
Each table covers one keyword group in one search engine and one region: a heading such as “Yandex (Moscow)” or “Google (Kazan)” plus the group name. Tables run by search engine, then by group within the engine, then by region within the group. A row holds a keyword and its positions on each check date in the reporting period. The colour of a position tells which top band it falls into, and a dash means Topvisor returned no position for that date.
Connecting Topvisor with an API key and User ID
Topvisor API access needs two values: the key and the user identifier. Both live in the Topvisor account, and Topvisor documentation says the key appears after the balance is topped up. In Reportkey you enter them once on the integrations page. The key is validated right away and stored as a shared account connection, so any project can use it without typing it again.
Next, the project settings ask you to choose the Topvisor project. You can keep all project data or switch on filters for search engines, regions and keyword groups. Large projects are worth narrowing straight away: one report holds up to 10,000 keywords, and the settings warn you when the project is bigger. History is read page by page, so big projects take longer to collect than small ones.
If Topvisor stops accepting the key, the connection is flagged for re-authorisation. You fix it on the integrations page, and the chosen project and groups stay in place.
Rankings by keyword group
Keyword groups are what make a Topvisor report more than a long list of positions. Agencies often split keywords by service, catalogue section or sales region, and clients think in the same terms. In the report each group is a separate table under a “Group” heading, and every date column header shows the share of that group’s keywords in the top 10 on that date. You can see which cluster gains or loses visibility before reading individual rows.
The group filter keeps the document short: an owner’s monthly report can keep three or four commercial groups while the full project stays for internal use.
Search engines and regions
Topvisor returns the engines and regions configured in the project, and the report keeps that structure. If the site is promoted in Yandex and Google across several cities, the client sees separate tables for each combination and never mixes up local and national results. A missing position on a date is a dash. For keywords that appear or disappear, the change is counted from a nominal depth of 50 positions for Google and 100 for other engines.
Top-10 share and change since the previous check
The report gives several ways to read the data quickly:
- Position on each check date: where the keyword stood at every check in the period.
- Change versus the first period: how far the keyword moved since the start of the window, with an arrow and colour for direction.
- Change versus the previous period: the move since the last check, useful for spotting a fresh drop.
- Group top-10 percentage: the share of the group’s keywords on the first page for each date.
- “Top 10” chart: the same share across the whole period for each engine and region pair.
Comparison columns appear once the period has enough check dates. The chart is built by engine and region, not by group; groups are visible in the tables.
What the Topvisor report does not include
It helps to set expectations with the client early. There is no search volume or demand column, even though Topvisor can check volume on its side. The Topvisor positions block has no AI summary, so the explanation of ranking moves comes from the specialist. When a client needs real search queries and clicks, the options are the Yandex Webmaster integration and Google Search Console with Google clicks and impressions.
Topvisor next to Yandex Metrica and other sources
Rankings explain only part of the result. In the same report you can add organic visits and goals from Yandex Metrica, so the client sees whether a better top-10 share turns into traffic and leads. A Reportkey project uses one rank tracking service at a time; if some clients are tracked elsewhere, consider SE Ranking as an alternative rank tracker. All position trackers are compared on the SEO integrations and rank trackers page.
The SEO agency demo report shows a finished document. Set up in 5 minutes; plans and the free trial are listed on the pricing page.
What goes into the Topvisor report
These are the metrics that the Topvisor integration already brings into Reportkey reports.
Topvisor reporting: plans and free trial
14 days free, no card required. Prices and plan limits are on the pricing page.
Why teams connect Topvisor to Reportkey
Real reporting jobs, typical pain points, and the outcomes teams get from Topvisor in client reports.
- Every month someone exports Topvisor positions to a spreadsheet, deletes columns and labels which tab is Yandex and which is Google.
- A Topvisor project with dozens of groups is hard for a client to read; they want a short view of which clusters moved.
- Rankings sit apart from ads and traffic, so a drop in search results is hard to connect with the rest of the marketing picture.
One Topvisor project checks Yandex and Google in several cities. The report builds a separate table for every keyword group in each engine and region pair, so the client reviews familiar groups city by city.
Only the priority groups, search engines and regions go into the report. The client gets a compact document with up and down arrows and a top-10 share chart.
How Topvisor appears inside the report
The report keeps the familiar Reportkey layout: source sections and period comparison.

A Yandex section for one region with a keyword group heading: keywords, positions by check date with the group's top-10 share in each date header, and change arrows versus the first and previous check.
Three steps to the first report
Connect the account once, choose the reporting scope, and save the setup for recurring client reports.
Frequently asked questions
Short answers about how the integration works in Reportkey today.
What do I need to connect Topvisor to Reportkey?
Does the report include Topvisor search volume?
Why does a Google position show a dash while Yandex has a number?
How many Topvisor keywords fit into one report?
Do AI insights cover Topvisor rankings?
What happens if the Topvisor key stops working?
Often connected together
Working sources that teams usually add to the same report.
Topvisor client report: groups, regions and top 10
Sign up, add your Topvisor API key and User ID, and pick a project. Your first report in 5 minutes.


