Help Center

Learn how to use Sapuseo to track your keyword rankings and grow your SEO.

Getting Started

Sapuseo is a keyword rank tracking tool that helps you monitor how your website ranks on Google and other search engines. Here is a quick overview of the workflow:

Add a Domain

Add the website(s) you want to track.

Add Keywords

Enter the keywords you want to monitor for each domain.

Track Rankings

Sapuseo automatically scrapes search results and tracks your position over time.

Analyze & Improve

Use Insights, Discover, and Ideas tabs to find opportunities and grow your traffic.

Managing Domains

Domains are the websites you want to track. You can add multiple domains and manage them all from the sidebar.

Adding a Domain

Click the + Add Domain button on the Domains page or in the sidebar. In the modal that appears, enter your website URL (e.g., https://mysite.com/). You can add multiple domains at once by entering each URL on a new line.

You can also track specific subpaths like https://mysite.com/blog/ instead of the entire domain.

Domain Settings

Click on a domain in the sidebar, then click the Settings button in the domain header. Domain settings have two tabs:

Notification — Set up email addresses to receive ranking reports for this specific domain.
Search Console — Connect Google Search Console for this domain by providing a Service Account email and private key. Choose between Domain Property or URL-Prefix property type.

Removing a Domain

Open Domain Settings and click Remove Domain at the bottom. This will permanently delete the domain and all its tracked keywords.

⚠️Removing a domain is permanent and cannot be undone. All keyword history for that domain will be lost.

Tracking Keywords

The Tracking tab is the main view for each domain. It shows the current Google ranking position for each keyword you are tracking, along with historical data.

Adding Keywords

Click + Add Keyword in the domain header. In the modal:

Keywords — Type or paste keywords, one per line.
Country — Select the country to track rankings in (e.g., Malaysia, United States).
Device — Choose Desktop, Mobile, or both. Selecting both will create separate tracking entries for each device.
Tags — Optionally tag keywords for easier filtering later (e.g., "blog", "product").
City — Some scrapers support city-level targeting for local SEO tracking.

Understanding the Keywords Table

The keywords table shows your tracked keywords with the following columns:

Position — Your current Google ranking for this keyword. A green arrow means you moved up; red means you dropped.
Best — The highest (best) position ever recorded for this keyword.
History — A mini sparkline chart showing position changes over time.
Volume — Monthly search volume for this keyword (requires Google Ads integration).
Search Console — Clicks and impressions from Google Search Console (requires GSC integration).

Filtering & Sorting

Use the filter bar above the table to narrow down keywords by:

Search — Type to filter keywords by name.
Country — Filter by the country the keyword is tracked in.
Tags — Filter by tags you assigned when adding keywords.

Click on any column header to sort the table. You can also switch betweenDesktop and Mobile views using the device toggle.

Refreshing Keyword Data

Click the Refresh Data button in the domain header to manually trigger a fresh scrape of all keywords. You can also select individual keywords and refresh only those. Keyword positions are also scraped automatically based on your scraping frequency setting.

Exporting Data

Click the Export button to download all keyword data for the current domain as a CSV file.

Google Search Console (Discover)

The Discover tab (labeled "SC") shows keywords that your website is already ranking for in Google, pulled directly from Google Search Console. This helps you find keywords you may not be tracking yet.

What You See

Keyword — The search query people used to find your site.
Position — Your average ranking position for that query.
Clicks — How many times people clicked through to your site.
Impressions — How many times your site appeared in search results.
CTR — Click-through rate (clicks ÷ impressions).

Date Range Filter

Use the date dropdown in the top-right to switch between Last 3 Days, Last 7 Days, and Last 30 Days of Search Console data.

Setting Up Search Console

Search Console can be connected in two ways:

Global (App Settings) — Go to Settings → Integrations → Search Console. Enter your Service Account email and private key. This applies to all domains.
Per-Domain — Go to a domain's Settings → Search Console tab. Enter credentials specific to that domain. This overrides the global setting.

You need a Google Cloud Service Account with access to your Search Console property. Create one in the Google Cloud Console, download the JSON key, and use theclient_email and private_key fields.

Insights

The Insights tab provides a high-level overview of your domain's search performance over the last 30 days, powered by Google Search Console data.

Tabs Within Insights

Stats — A daily breakdown showing visits, impressions, average position, and CTR over time, displayed as both a chart and a table. The top cards show totals for visits, impressions, average position, average CTR, total keywords, and total pages.
Keywords — All keywords your site appeared for, sorted by clicks. See which queries drive the most traffic.
Countries — Traffic breakdown by country, showing which regions your visitors come from.
Pages — Performance per page on your site, showing which URLs get the most clicks and impressions.

Keyword Ideas

The Ideas tab helps you discover new keywords to target, powered by the Google Ads API. It suggests related keywords based on your website content or seed keywords.

Loading Keyword Ideas

Click Load Ideas in the domain header to open the keyword ideas loader. Choose how to generate ideas:

Automatically from Website Content — Analyzes your website and suggests relevant keywords.
Based on already ranking keywords (GSC) — Uses your Search Console data as seed keywords (requires GSC integration).
Based on currently tracked keywords — Uses your existing tracked keywords as seeds.
From Custom Keywords — Enter up to 20 seed keywords manually.

Select a target country and language, then click Load Keyword Ideas. The results show each keyword's monthly search volume, competition level, and CPC data.

Favorites

Star any keyword idea to save it as a favorite. Toggle the favorites view to see only your saved ideas. You can export both regular ideas and favorites as CSV.

Keyword Ideas requires a Google Ads integration. Set it up in Settings → Integrations → Google Ads.

Research

The Research page (accessible from the sidebar) is a standalone keyword research tool. Unlike the domain-specific Ideas tab, Research is not tied to any domain — it lets you explore keyword ideas freely.

How to Use

Enter up to 20 seed keywords (comma-separated) in the sidebar input.
Select a target country and language.
Click Load Ideas to fetch keyword suggestions from Google Ads.

Results include search volume, competition, and CPC for each keyword. You can star favorites and export the full list as CSV.

App Settings

Click Settings in the top navigation bar (visible to admin users only). Settings are organized into three tabs:

Scraper

Configure how Sapuseo scrapes Google search results to check your keyword rankings.

Scraping Method — Choose a scraping provider (e.g., ScrapingAnt, SerpApi, HasData, etc.) or use your own proxy.
API Key — Enter the API key for your chosen scraping provider.
Scraping Frequency — How often keywords are automatically scraped: Daily, Every Other Day, Weekly, Monthly, or Never.
Scrape Delay — Add a delay between each keyword scrape to avoid rate limits (0 seconds to 30 minutes).
Auto Retry — Automatically retry failed keyword scrapes.

⚠️Changes to Scraping Frequency and Scrape Delay require a server restart to take effect.

Notification

Set up email notifications to receive periodic ranking reports.

Frequency — Daily, Weekly, Monthly, or Never.
Notification Emails — Comma-separated list of email addresses.
SMTP Server & Port — Your email server details (e.g., smtp.gmail.com port 587).
SMTP Username & Password — Credentials for the SMTP server.
From Email & Name — The sender address and display name for notification emails.

Integrations

Connect external services to unlock additional features.

Google Search Console

Provides the Discover tab and Insights tab data. Enter your Google Cloud Service Account'sclient_email and private_key. Make sure the Service Account has been granted access to your Search Console property.

Google Ads

Powers the Keyword Ideas and Research features. You need:

Developer Token — From your Google Ads Manager account.
Account ID — Your Google Ads client account ID (not the Manager account ID).
OAuth Connection — Click the connect button to authorize via Google OAuth.

⚠️Use your Client Account ID (not the Manager Account ID) in the Account ID field. Using the Manager ID will cause API errors.

Email Notifications

Sapuseo can send you periodic email reports summarizing your keyword rankings. Notifications work at two levels:

Global (App Settings → Notification) — Sets the overall notification frequency and SMTP configuration.
Per-Domain (Domain Settings → Notification) — Set specific email addresses to receive reports for individual domains.

Both must be configured for notifications to work. The global settings provide the SMTP server, and the per-domain settings specify who receives the report for each domain.

Profile & Subscription

Click Profile in the top navigation to view your account details including your username, email, and role.

If subscriptions are enabled, you can upgrade your plan or manage your existing subscription from the Profile panel. This connects to Stripe for secure payment processing.

Frequently Asked Questions

Still need help?

If you have questions not covered here, reach out to us at support@sapuseo.com