# YouTube Rank Checker - Keyword Positions for Videos & Channels (`tenfoldfleet/youtube-rank-checker`) Actor

Check where a YouTube video or channel ranks in YouTube search for your keywords, by country and language. Get the rank, all positions, the matched video, the change since your last run and the top 10. $3 per 1,000 keyword checks; failed searches and invalid targets are free.

- **URL**: https://apify.com/tenfoldfleet/youtube-rank-checker.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Videos, SEO tools, For creators
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 keyword checks

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does YouTube Rank Checker do?

**YouTube Rank Checker** tells you **where your video or channel shows up in YouTube search** for each keyword you care about. Give it a list of keywords and a list of targets (video links, video IDs, channel IDs, @handles or channel URLs) and it returns one row per keyword and target with the **rank**, **every position the target holds**, the **matched video**, the **change since your last run** and the **top 10 videos** that beat you or sit next to you.

YouTube is a trademark of Google LLC. Not affiliated with YouTube or Google.

It works like a **YouTube keyword ranking API**: no API key, no quota, no login. You pick the **country (gl)**, the **language (hl)**, how deep to look (**top 20, 50 or 100**) and whether to rank among all results, long videos only or Shorts only. Schedule it daily or weekly and it becomes a **YouTube rank tracker** that reports which keywords moved up, moved down, entered or dropped out.

Need the full list of videos for a keyword instead of positions for your own? Our [YouTube Search Scraper](https://apify.com/tenfoldfleet/youtube-search-scraper) returns every result with views, duration and upload date. This actor is for a different buyer: **creators, agencies and marketers who track their own positions** and want one compact row per keyword, not hundreds of result rows.

### Why use a YouTube rank checker?

- 📈 **YouTube SEO tracking**: see if a new title, thumbnail or description moved your video up for its target keywords.
- 🏢 **Agency reporting**: track every client channel across its keyword set and country, and export a weekly table of rank changes.
- 🥊 **Competitor checks**: add a competitor's channel as a second target and compare positions keyword by keyword; the top 10 list shows who holds the slots above you.
- 🌍 **Market comparison**: run the same keywords for US, GB, DE or IN and see where a video travels well.
- 🤖 **AI agents and automations**: one call returns a clean JSON answer to "what position is this video for this keyword?", ready for Make, Zapier, n8n, Google Sheets or the [Apify MCP server](https://mcp.apify.com).

### What data can it extract?

![Sample output of YouTube Rank Checker, rows from a real run: Keyword, Target, Rank, All positions, Matched video, Video URL](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/youtube-rank-checker-output.png)

| Field | What it holds |
|---|---|
| `keyword`, `target` | the search phrase and the video or channel you gave |
| `targetType`, `targetVideoId`, `targetChannelId` | `video` or `channel`, and the resolved ID (handles and custom URLs are looked up to a channel ID) |
| `rank`, `isRanked` | the best position of the target, or `null` when it is not in the scanned results |
| `allPositions` | every position the target holds, e.g. `[3, 11, 27]` for a channel with three videos ranking |
| `matchedVideoId`, `matchedVideoUrl`, `matchedVideoTitle`, `matchedChannelName`, `matchedViewCount` | the best-ranked video of the target |
| `shelfAppearances` | the target's videos found in Shorts shelves or other shelves, which do not count for the rank |
| `previousRank`, `rankChange`, `movement`, `previousCheckedAt` | comparison with the previous run: `up`, `down`, `same`, `new`, `lost`, `not-ranked` or `first-check` |
| `top10` | the first 10 results: position, video, title, channel, views, Short flag |
| `totalResultsScanned`, `depth` | how many results were read, and how many you asked for |
| `country`, `language`, `resultType`, `checkedAt` | the market and the time of the check |

### How to check YouTube rankings for your keywords

1. Open the actor and click **Try for free**.
2. Paste your **keywords**, one per line (up to 100 per run).
3. Paste your **targets**: a video link, a video ID, a channel ID, an @handle (a channel name without the @ works too) or a channel URL (up to 20).
4. Set the **country**, **language**, **depth** and **result type**.
5. Leave **Compare with the previous run** on and pick a **history store name** for this project.
6. Click **Start**, then download the table as JSON, CSV or Excel, or schedule the actor to run every day or week.

### How much does it cost to check YouTube ranks?

You pay per **keyword check**: one keyword checked for one target, at **$3 per 1,000 checks** ($0.003 each), plus a tiny start fee of $0.00005 per run. 10 keywords x 3 targets = 30 checks = $0.09. The price is the same at depth 20, 50 or 100.

A target that is not in the top N is a real answer ("not ranked") and is charged. These are **free**: searches YouTube blocked or answered with no results, targets that are not a valid video or channel (video IDs are checked before the run), a country or language code YouTube does not know, and checks that stopped early before the target was found. The same keyword typed twice with different capitals is checked once.

On the **Apify free plan**, the monthly free credit covers about 1,500 keyword checks.

### Input

```json
{
    "keywords": ["home workout", "full body workout no equipment"],
    "targets": ["@growingannanas", "cbKkB3POqaY"],
    "country": "US",
    "language": "en",
    "depth": 50,
    "resultType": "all",
    "compareWithPreviousRun": true,
    "historyStoreName": "youtube-rank-history"
}
```

### Output

One row per keyword and target. Download the dataset as **JSON, CSV, Excel, XML or HTML**, or read it through the Apify API.

```json
{
    "keyword": "home workout",
    "target": "@growingannanas",
    "targetType": "channel",
    "targetChannelId": "UCsLF0qPTpkYKq81HsjgzhwQ",
    "rank": 1,
    "isRanked": true,
    "allPositions": [1, 2, 15],
    "matchedVideoId": "cbKkB3POqaY",
    "matchedVideoTitle": "25 MIN FULL BODY HIIT for Beginners - No Equipment - No Repeat Home Workout",
    "matchedChannelName": "growingannanas",
    "matchedViewCount": 34816042,
    "shelfAppearances": [],
    "previousRank": 2,
    "rankChange": 1,
    "movement": "up",
    "top10": [
        { "position": 1, "videoId": "cbKkB3POqaY", "title": "25 MIN FULL BODY HIIT for Beginners - No Equipment - No Repeat Home Workout", "channelName": "growingannanas", "viewCount": 34816042, "isShort": false }
    ],
    "totalResultsScanned": 50,
    "depth": 50,
    "country": "US",
    "language": "en",
    "resultType": "all",
    "checkedAt": "2026-11-09T10:00:00.000Z"
}
```

### How positions are counted

- The rank is the position among the **standalone results** of the search, the list a viewer scrolls through.
- **Ads are skipped** and never take a position.
- **Shelves are skipped**: the horizontal Shorts shelf, "People also watched" and similar rows do not take positions. If your video only appears inside a shelf, `rank` is `null` and the shelf is listed in `shelfAppearances` with the rank it sits after.
- **Channel cards, playlists and mixes** do not take positions.
- With result type **Shorts only**, the Shorts grid is the result list, so each Short counts.
- A video that YouTube repeats on a later page is counted once.
- Some searches end early for logged-out viewers: YouTube serves only 15-50 videos for them and then shows "No more results". The actor reads everything YouTube serves, up to your depth, and `totalResultsScanned` tells you how far it got. A target that is not in those results gets `rank: null`.

### Tips

- Use **one history store per project or client** so rank changes compare like with like.
- Keep the same **country, language and result type** between runs; the history is saved per keyword, target and market.
- YouTube search is not identical for every viewer, so expect small moves of 1-3 places between checks. Look at the trend over several runs.
- A **channel target** answers "where is my best video for this keyword?"; a **video target** answers it for one video.

### FAQ

#### Is there a YouTube API for search rankings?

The YouTube Data API has a search endpoint with a daily quota and results that often differ from what viewers see. This actor reads the public search results page the way a logged-out viewer gets it, for the country and language you set.

#### Does it need my YouTube login or an API key?

No. It reads public search results only, with no login, no cookies and no API key.

#### Why is my rank different from what I see in my browser?

Your own YouTube search is personalised by your watch history, subscriptions and location. The actor sees logged-out results for the country you choose, which is closer to what a new viewer sees.

#### Can I track Shorts?

Yes. Set the result type to **Shorts only** to rank among Shorts, or keep **All results** to rank among standalone results and see Shorts shelf appearances separately.

#### Why is totalResultsScanned lower than my depth?

For some keywords YouTube gives logged-out viewers a short result list, sometimes only 15-50 videos, and then stops loading more. The actor scans everything YouTube serves up to your depth and reports the count in `totalResultsScanned`, so a rank of `null` means "not in the results YouTube shows", not "position 101 or lower".

#### How many keywords can I check?

Up to 100 keywords and 20 targets per run. For bigger lists, start several runs or use separate schedules.

### Disclaimer

This actor reads publicly available YouTube search results. It does not log in and does not collect private data. You are responsible for using the data in line with YouTube's terms and the laws that apply to you. YouTube is a trademark of Google LLC; this actor is not affiliated with, endorsed by or sponsored by YouTube or Google.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [YouTube Livestream & Channel Scraper - Videos, Likes & Stats](https://apify.com/tenfoldfleet/youtube-channel-scraper) | video |
| [YouTube Comments API & Scraper - Replies, Likes & Newest First](https://apify.com/tenfoldfleet/youtube-comments-scraper) | comment |
| [YouTube Search Scraper: Keyword Video & Shorts Monitor](https://apify.com/tenfoldfleet/youtube-search-scraper) | search result |
| [YouTube Shorts Analytics Scraper - Views, Likes & Hashtags](https://apify.com/tenfoldfleet/youtube-shorts-scraper) | short |
| [YouTube Shorts Transcript Scraper by Channel - Text per Short](https://apify.com/tenfoldfleet/youtube-shorts-transcript-by-channel) | shorts transcript |
| [YouTube Transcript Downloader - Captions, Subtitles & Timing](https://apify.com/tenfoldfleet/youtube-transcript-scraper) | transcript |
| [YouTube Video Details Lookup: Views, Likes & Tags by URL](https://apify.com/tenfoldfleet/youtube-video-details-lookup) | video details |
| [YouTube Channel Email Scraper - Creator Contact Extractor](https://apify.com/tenfoldfleet/youtube-channel-email-scraper) | channel with email |
| [ASO Keyword Rank Tracker: iOS & Android App Positions](https://apify.com/tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play) | keyword check |
| [Google Maps Rank Tracker - Geo-Grid Rank Changes & Competitors](https://apify.com/tenfoldfleet/google-maps-rank-tracker) | grid point checked |
| [Bilibili Transcript - Video to Text with SRT & Translation](https://apify.com/tenfoldfleet/bilibili-transcript-video-to-text) | video transcript |
| [Stock Photos & Videos Scraper for Pexels](https://apify.com/tenfoldfleet/stock-photos-scraper) | media item |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/youtube-rank-checker/changelog.md

# Actor input Schema

## `keywords` (type: `array`):

Search phrases to check, one per line, exactly as a viewer would type them into YouTube search. Up to 100 keywords per run (split bigger lists into several runs or a schedule). Works on the Apify free plan; the free plan's monthly credit covers about 1,500 keyword checks.

## `targets` (type: `array`):

What to look for in the results: video URLs or 11-character video IDs (watch, youtu.be and /shorts/ links all work), channel IDs (UC...), @handles (a channel name without the @ is looked up as a handle) or channel URLs (/@name, /channel/UC..., /c/name, /user/name). Video IDs are checked first, so a typo is a free error item, not a charged row. A channel target ranks at the position of its best video. Up to 20 targets. Every keyword is checked for every target: 10 keywords x 3 targets = 30 checks.

## `country` (type: `string`):

Two-letter country code of the YouTube results, e.g. US, GB, DE, IN, BR. Rankings differ by country. An unknown code stops the run with a free error item.

## `language` (type: `string`):

Interface language of the results, e.g. en, de, es, pt-BR, zh-TW. A code YouTube does not accept stops the run with a free error item.

## `depth` (type: `integer`):

How many search results to scan per keyword, from 10 to 100 (20, 50 and 100 are the usual choices). A target that is not in that many results comes back with rank null (not in the top N). The price is the same at every depth.

## `resultType` (type: `string`):

Rank among all results (long videos and standalone Shorts), long videos only, or Shorts only (the Shorts filter of YouTube search).

## `compareWithPreviousRun` (type: `boolean`):

Save every rank in a named key-value store and report previousRank, rankChange and movement (up, down, same, new, lost) on the next run. Turn it on and schedule the actor daily or weekly to track positions over time.

## `historyStoreName` (type: `string`):

Name of the key-value store in your account that keeps the rank history. Use a different name for each project or client so their histories stay separate.

## `proxyConfiguration` (type: `object`):

The Apify datacenter proxy is used by default and is enough for YouTube search. A residential group is replaced by datacenter.

## Actor input object example

```json
{
  "keywords": [
    "home workout",
    "full body workout no equipment"
  ],
  "targets": [
    "@growingannanas",
    "@MadFit"
  ],
  "country": "US",
  "language": "en",
  "depth": 50,
  "resultType": "all",
  "compareWithPreviousRun": true,
  "historyStoreName": "youtube-rank-history",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "home workout",
        "full body workout no equipment"
    ],
    "targets": [
        "@growingannanas",
        "@MadFit"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/youtube-rank-checker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "home workout",
        "full body workout no equipment",
    ],
    "targets": [
        "@growingannanas",
        "@MadFit",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/youtube-rank-checker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "home workout",
    "full body workout no equipment"
  ],
  "targets": [
    "@growingannanas",
    "@MadFit"
  ]
}' |
apify call tenfoldfleet/youtube-rank-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/youtube-rank-checker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ja8KskX3EqnbvhKMv/builds/KowWRIUyLUY2E8lgj/openapi.json
