Skip to content
Reportkey
Topvisor
Topvisor rankings via API

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.

14 days free · no card required · all integrations
Sign up, add your Topvisor API key and User ID, and pick a project. Your first report in 5 minutes.
  • 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.
Sample Reportkey report with search rankings
Sample Reportkey report with search rankings
TopvisorTopvisor projects and ranking groups
30+
integrations
5 min
setup
14 days
trial

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.

Metrics

What goes into the Topvisor report

These are the metrics that the Topvisor integration already brings into Reportkey reports.

Topvisor keyword positions by group
Topvisor top-10 share by search engine and region
Topvisor change since the first and previous check
What this integration adds to the report
Topvisor projects and ranking groups
Pricing

Topvisor reporting: plans and free trial

14 days free, no card required. Prices and plan limits are on the pricing page.

Use cases

Why teams connect Topvisor to Reportkey

Real reporting jobs, typical pain points, and the outcomes teams get from Topvisor in client reports.

Pain points
  • 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.
Topvisor
SEO agency with regional clients

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.

Topvisor
Freelancer with a focused keyword set

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.

Report preview

How Topvisor appears inside the report

The report keeps the familiar Reportkey layout: source sections and period comparison.

Sample Reportkey report with search rankings
Sample Reportkey report with search rankings
Topvisor rankings table for one group

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.

How to connect

Three steps to the first report

Connect the account once, choose the reporting scope, and save the setup for recurring client reports.

01
Connect the account
Save the Topvisor connection once so the same datasource can be reused across recurring client reports.
02
Choose the reporting scope
Choose the Topvisor project whose rankings, keyword groups, and top-10 share go into the report.
03
Save the setup and generate the report
Keep the selected scope in the project and reuse the same report setup next time instead of connecting the source again.
FAQ

Frequently asked questions

Short answers about how the integration works in Reportkey today.

What do I need to connect Topvisor to Reportkey?
You need the API key and the User ID from your Topvisor account. According to Topvisor documentation, the API key becomes available after you top up the balance. You enter both once on the integrations page and reuse the connection in every project.
Does the report include Topvisor search volume?
No. Topvisor itself can check search volume, but the Reportkey report does not show it: tables contain keywords, positions by check date and changes. Real search demand comes from search engine data; in Reportkey, connect Yandex Webmaster and Google Search Console for it.
Why does a Google position show a dash while Yandex has a number?
A dash means Topvisor returned no position for that keyword on that date, for example because the site was not found within the check depth. Yandex and Google are checked separately, so the same keyword can have a number in Yandex and a dash in Google. When a keyword enters or drops out of the results, the change is counted from a nominal depth of 50 places for Google and 100 for other engines; the cell then shows the number with a plus, meaning a move of more than N places.
How many Topvisor keywords fit into one report?
Up to 10,000 keywords. If the project is larger, the setup screen shows a warning; narrow the report with search engine, region or group filters so the important keywords are not cut off.
Do AI insights cover Topvisor rankings?
No. The Topvisor block consists of a chart and tables without an AI summary, so the comment on ranking changes is written by the specialist.
What happens if the Topvisor key stops working?
The connection is flagged for re-authorisation, and you refresh it on the integrations page. A temporary API failure does not reset the selected project or filters, and a project deleted in Topvisor is marked as a missing resource.

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.

Start free