---
name: tiktok-intel
description: "TikTok & Instagram deep intelligence — trending content, influencer research, audience demographics, TikTok Shop products, popular songs/hashtags, Instagram Reels & Stories. Uses a 3rd-party scraping API. Trigger: тикток тренды, инфлюенсеры, TikTok Shop, популярные рилсы, тикток аналитика, инстаграм рилсы, trending TikTok, influencer search, TikTok analytics, Instagram highlights."
allowed-tools: Bash, Read, Write, WebSearch
---

# TikTok & Instagram Intelligence

> Deep platform analytics via a 3rd-party scraping API.
> Key: `SCRAPER_API_KEY` from `~/.claude/.credentials.master.env`

## When to Use

- "тикток тренды" — что сейчас viral
- "инфлюенсеры в [нише]" — поиск и анализ блогеров
- "TikTok Shop [товар]" — товары и отзывы на маркетплейсе
- "популярные рилсы" — тренды Instagram Reels
- "аудитория [блогер]" — демография подписчиков
- "популярные хештеги/песни" — для контент-планирования
- Поиск блогеров для your project (your niche)
- Контент-идеи для YourChannel YouTube канала

## API Endpoints

```
BASE = https://api.your-scraper.example
AUTH: x-api-key: $SCRAPER_API_KEY
```

### TikTok — Profiles & Content

| Endpoint | Path | Input | Returns |
|----------|------|-------|---------|
| Profile | `/v1/tiktok/profile` | `?username=handle` | Bio, followers, likes, videos count |
| Audience Demographics | `/v1/tiktok/user/audience` | `?username=handle` | Age, gender, country distribution |
| Videos | `/v3/tiktok/profile/videos` | `?username=handle` | All videos with engagement |
| Video Info | `/v2/tiktok/video` | `?url=video_url` | Full video data + engagement |
| Transcript | `/v1/tiktok/video/transcript` | `?url=video_url` | Speech-to-text |
| Comments | `/v1/tiktok/video/comments` | `?url=video_url` | Comment tree |
| Live | `/v1/tiktok/user/live` | `?username=handle` | Current live stream |
| Following | `/v1/tiktok/user/following` | `?username=handle` | Who they follow |
| Followers | `/v1/tiktok/user/followers` | `?username=handle` | Their followers |

### TikTok — Discovery & Trends

| Endpoint | Path | Input | Returns |
|----------|------|-------|---------|
| Search Users | `/v1/tiktok/search/users` | `?query=keyword` | Find creators by keyword |
| Search Keyword | `/v1/tiktok/search/keyword` | `?query=keyword` | Videos by keyword |
| Search Hashtag | `/v1/tiktok/search/hashtag` | `?query=hashtag` | Hashtag pages |
| Top Search | `/v1/tiktok/search/top` | `?query=keyword` | Top results (mixed) |
| Trending Feed | `/v1/tiktok/get-trending-feed` | — | Current trending videos |
| Popular Songs | `/v1/tiktok/songs/popular` | — | Trending audio tracks |
| Popular Creators | `/v1/tiktok/creators/popular` | — | Rising creators |
| Popular Videos | `/v1/tiktok/videos/popular` | — | Viral videos right now |
| Popular Hashtags | `/v1/tiktok/hashtags/popular` | — | Trending hashtags |
| Song Details | `/v1/tiktok/song` | `?id=song_id` | Song metadata |
| Videos Using Song | `/v1/tiktok/song/videos` | `?id=song_id` | All videos with this audio |

### TikTok Shop

| Endpoint | Path | Input | Returns |
|----------|------|-------|---------|
| Shop Search | `/v1/tiktok/shop/search` | `?query=product` | Товары на маркетплейсе |
| Shop Products | `/v1/tiktok/shop/products` | `?shop_id=ID` | Все товары магазина |
| Product Details | `/v1/tiktok/product` | `?url=product_url` | Цена, рейтинг, описание |
| Product Reviews | `/v1/tiktok/shop/product/reviews` | `?product_id=ID` | Отзывы покупателей |
| User Showcase | `/v1/tiktok/user/showcase` | `?username=handle` | Витрина блогера |

### Instagram — Profiles & Content

| Endpoint | Path | Input | Returns |
|----------|------|-------|---------|
| Profile | `/v1/instagram/profile` | `?username=handle` | Full profile data |
| Basic Profile | `/v1/instagram/basic-profile` | `?username=handle` | Lightweight lookup |
| Posts | `/v2/instagram/user/posts` | `?username=handle` | Feed posts |
| Reels | `/v1/instagram/user/reels` | `?username=handle` | Reels only |
| Post/Reel Info | `/v1/instagram/post` | `?url=post_url` | Full post data |
| Transcript | `/v2/instagram/media/transcript` | `?url=reel_url` | Speech-to-text for Reels |
| Comments | `/v2/instagram/post/comments` | `?url=post_url` | Comments |
| Story Highlights | `/v1/instagram/user/highlights` | `?username=handle` | Highlight covers |
| Highlight Detail | `/v1/instagram/user/highlight/detail` | `?highlight_id=ID` | Stories in highlight |
| Search Reels | `/v2/instagram/reels/search` | `?query=keyword` | Search Reels by keyword |

## Workflows

### 1. Influencer Research (найти блогеров в нише)

```bash
source ~/.claude/.credentials.master.env
API="https://api.your-scraper.example"
H="x-api-key: $SCRAPER_API_KEY"

# Step 1: Search creators by keyword
curl -s "$API/v1/tiktok/search/users?query=строительство ремонт" -H "$H" > /tmp/tt_creators.json

# Step 2: Get top creator profiles + demographics (parallel)
# Extract usernames from step 1, then:
curl -s "$API/v1/tiktok/profile?username=CREATOR1" -H "$H" > /tmp/tt_p1.json &
curl -s "$API/v1/tiktok/user/audience?username=CREATOR1" -H "$H" > /tmp/tt_d1.json &
curl -s "$API/v1/tiktok/profile?username=CREATOR2" -H "$H" > /tmp/tt_p2.json &
curl -s "$API/v1/tiktok/user/audience?username=CREATOR2" -H "$H" > /tmp/tt_d2.json &
wait
```

Output format:
```markdown
# Influencer Report: [Niche]

| Creator | Followers | Avg Views | Engagement | Audience (top country) | Age Group |
|---------|-----------|-----------|------------|----------------------|-----------|
| @xxx | 500K | 50K | 10% | your-region 65% | 25-34 |
```

### 2. Trend Monitor (что сейчас в тренде)

```bash
source ~/.claude/.credentials.master.env
API="https://api.your-scraper.example"
H="x-api-key: $SCRAPER_API_KEY"

# All trending data in parallel
curl -s "$API/v1/tiktok/get-trending-feed" -H "$H" > /tmp/tt_trending.json &
curl -s "$API/v1/tiktok/songs/popular" -H "$H" > /tmp/tt_songs.json &
curl -s "$API/v1/tiktok/hashtags/popular" -H "$H" > /tmp/tt_hashtags.json &
curl -s "$API/v1/tiktok/creators/popular" -H "$H" > /tmp/tt_rising.json &
wait
```

### 3. Competitor Content Analysis

```bash
# Analyze what a competitor posts on both platforms
curl -s "$API/v3/tiktok/profile/videos?username=COMPETITOR" -H "$H" > /tmp/tt_vids.json &
curl -s "$API/v2/instagram/user/posts?username=COMPETITOR" -H "$H" > /tmp/ig_posts.json &
curl -s "$API/v1/instagram/user/reels?username=COMPETITOR" -H "$H" > /tmp/ig_reels.json &
wait
```

### 4. TikTok Shop Product Research

```bash
# Search products
curl -s "$API/v1/tiktok/shop/search?query=example+query" -H "$H" > /tmp/shop_results.json

# Get reviews for top product
curl -s "$API/v1/tiktok/shop/product/reviews?product_id=PRODUCT_ID" -H "$H" > /tmp/shop_reviews.json
```

### 5. Audio/Song Trend Analysis

```bash
# Find trending songs, then see who uses them
curl -s "$API/v1/tiktok/songs/popular" -H "$H" > /tmp/songs.json

# Get videos using a specific trending song
curl -s "$API/v1/tiktok/song/videos?id=SONG_ID" -H "$H" > /tmp/song_vids.json
```

## Credit Budget

| Operation | Credits |
|-----------|---------|
| Single profile lookup | 1 |
| Profile + demographics | 2 |
| Full creator audit (profile + demos + videos + top video comments) | 4-5 |
| Trend snapshot (feed + songs + hashtags + creators) | 4 |
| 10 influencers with demographics | ~20 |
| TikTok Shop search + 5 product reviews | ~6 |
| Instagram competitor (profile + posts + reels) | 3 |

## Integration

| Next Step | Skill |
|-----------|-------|
| 30-day topic research | `last30days` |
| Full social dossier | `social-intel` |
| Ad analysis | `ad-spy` |
| YouTube content ideas | `youtube-analytics` |
| Create content brief | `content-creation` |
| Your-Brand blogger monitoring | your project (your cron) |