Manual · Documentation

Master the art of
TikTok Niche Analyser.

Welcome to the official documentation for Viral Ninja. This guide will walk you through how to install, use, and get the absolute most out of your TikTok SEO extraction tool.

01 / 04

Installation & Getting Started

Once you have installed the extension from the Chrome Web Store, follow these simple steps to access it easily and start your SEO workflow.

01

Pin the extension

Click the puzzle icon (Extensions) in the top right corner of your Chrome browser, find "Viral Ninja" in the list, and click the pushpin icon to pin it to your toolbar.

02

Open the panel

Click the Viral Ninja icon you just pinned. The tool will open neatly in your browser's side panel, allowing you to keep an eye on TikTok while using the extension.

02 / 04

How to Generate Your Data Matrix

Extracting powerful SEO data takes just a few clicks. Follow this sequence to capture your competitors' metrics.

01

Navigate to TikTok

Open a new tab and go to the official TikTok website.

02

Run a search

Type your keyword or niche into the TikTok search bar (e.g., "SEO tips", "3D design", etc.) and press Enter.

03

Load the videos

Scroll down the results page to load the number of videos you want to analyze. Viral Ninja will capture all the videos currently visible on your screen.

04

Export

In the Viral Ninja side panel, click the extraction button.

05

Download the CSV

A .csv file will automatically be generated and downloaded to your computer.

03 / 04

Understanding Your CSV Export

The generated file is formatted to be easily readable in Excel, Google Sheets, or Apple Numbers. It provides you with a comprehensive data matrix, including:

Column Description
Title / Description The full text of the video, perfect for spotting keywords used by your competitors.
Statistics The exact number of Views, Likes, and Comments to help you gauge virality at a glance.
Creator The username of the TikTok account that posted the video.
URL The direct link to find the video instantly.
04 / 04

Troubleshooting & FAQ

Encountering an issue? Here are the solutions to the most common problems.

Nothing happens when I click the button, why?

Make sure you are currently on a TikTok search page (tiktok.com/search/...). The extension is specifically designed to analyze search results pages, not your "For You" feed or personal profile.

My CSV file is empty, what should I do?

Ensure you have given the TikTok page enough time to fully load the search results before clicking the extraction button. If your internet connection is slow, just wait a few extra seconds.

My data is all in one column in Excel, how do I fix this?

CSV files use separators. If your data doesn't separate automatically, use the "Text to Columns" feature in Excel (found under the "Data" tab) and select the comma as your delimiter.

Need further assistance? Don't hesitate to reach out at madoxweb@gmail.com.