> ## Documentation Index
> Fetch the complete documentation index at: https://spyro.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitor Research

> Compare your website with up to 5 competitors in one scan: see the keywords they win, the topics you're missing, the pages to beat, and turn gaps into articles.

**Competitor research** compares your website with up to 5 competitors in one country. Spyro AI pulls each site's Google rankings, finds the keywords they rank for and you don't, groups them into topics, and shows the competitor pages you could outrank. Every finding can go straight to your content calendar or the rank tracker.

## Where to find it

Open **Competitor research** in the sidebar, under **Search (SEO)**.

## Run a scan

**1. Set up the scan**

Choose **New scan** (or **Set up scan** on your first visit). Add up to **5 competitors**: pick from your tracked competitors or type a domain. Your own site is added automatically and can't be added as a competitor.

**2. Pick the country**

Choose the country to compare rankings in. The language follows the country.

**3. Start the scan**

Choose **Start scan**. It takes a minute or two, and you can leave the page: results appear when it's done.

> [!NOTE]
>
> Filters such as search volume, keyword difficulty and intent aren't scan settings. You apply them afterwards on the **Keyword gaps** tab, as often as you like, at no extra cost.

### What a scan costs

Each competitor costs **100 credits**. If a competitor was already scanned in the last 30 days, Spyro AI reuses that data and doesn't charge for it. Your own site is always free.

Before the scan starts, Spyro AI checks you have enough credits. If you don't, it shows how many credits the scan needs and how many you have left. See [Plans & billing](https://spyro.app/docs/product/billing-and-usage.md).

## Read the results

The results have six tabs.

| Tab | What it shows |
| - | - |
| **Overview** | An AI-written verdict on where you stand, headline numbers for each site (estimated monthly traffic, ranking keywords and top-10 keywords), a traffic leaderboard, and **Start here: top quick wins** |
| **Keyword gaps** | Every keyword in the scan, split into four groups (below), with search and filters for intent, competitor and topic |
| **Topics** | Gap keywords grouped into topics, with total searches and average difficulty. Choose **Plan this topic** to plan content around one |
| **Competitors** | Each competitor's estimated traffic, keywords, top-10 keywords, the keywords you lack and the keywords where they beat you. Open a competitor to see its profile, including 12 months of history |
| **Pages to beat** | Competitor pages that rank in your market, with their top keyword and estimated visits. **Beatable** marks pages you have a realistic chance of outranking, based on their position and their keyword's difficulty |
| **Scan history** | Every scan with its date, competitors, market, credits used and how the number of gaps changed. Choose **Re-run this scan** to repeat one |

### The four keyword groups

* **Gaps:** keywords a competitor ranks for and you don't.
* **Quick wins:** gaps worth going after first, with real search demand, moderate difficulty and no competitor firmly holding the top 3.
* **Behind:** keywords you rank for, but a competitor ranks higher.
* **Shared:** keywords you and your competitors both rank for.

## Act on what you find

* **Write article** (or **Write a better one** on a competitor page) adds the keyword, with related long-tail variations, to the next open day on your [content calendar](https://spyro.app/docs/product/calendar.md). It's written there on its scheduled day, or straight away if you choose **Generate Article**.
* **Track** adds the keyword to your [rank tracker](https://spyro.app/docs/product/rank-tracker.md).
* **Export CSV**, at the top of the page, downloads the scan's keywords.

## Keep the data fresh

* **Refresh data** re-scans the competitors you tick. Each one costs 100 credits; refreshing only your own site is free.
* **Delete competitor** removes a competitor from this scan and every earlier scan and erases its saved data. Spyro AI asks you to confirm first.

## Limits

| Limit | Value |
| - | - |
| Competitors per scan | Up to **5** |
| Keyword rows saved per scan | Up to **2,000** |

## Related

> [card] [Your competitor list](https://spyro.app/docs/product/settings.md#the-competitors-you-track)
>
> Add or remove the competitors Spyro AI tracks for this workspace.

> [card] [Plans & billing](https://spyro.app/docs/product/billing-and-usage.md)
>
> Credit costs, plans and when credits reset.

> [card] [AI writer](https://spyro.app/docs/product/writer.md)
>
> Turn gap keywords into articles.

> [card] [AI visibility](https://spyro.app/docs/product/ai-visibility.md)
>
> See which competitors AI engines recommend.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.