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 let you manage per-domain notifications:

Notification — Set up email addresses to receive ranking reports for this specific domain.

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 a configured keyword data provider).

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.

Keyword Ideas

The Ideas tab helps you discover new keywords to target using the configured keyword data provider. 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 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 configured keyword data provider. Set it up in App Settings before loading ideas.

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 your configured keyword data provider.

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

Configure your rank tracking scraper and keyword data provider from App Settings.

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