TrendPilot — TikTok Scraper & Creator Leads

TrendPilot is a premium, outcome-oriented TikTok scraper and B2B intelligence engine designed for marketing agencies, outbound sales teams, e-commerce operators, and brand managers.

Unlike generic scrapers that output simple, unstructured text and numbers, TrendPilot packages extraction, B2B data cleaning, and algorithmic scoring to deliver ready-to-use business outcomes.

---

⚙️ How It Works

TrendPilot extracts and processes creator leads using a robust 4-step execution pipeline:

1. Target Ingestion: The Actor enqueues target search terms, hashtags, or profile URLs based on the selected runMode.
2. Browser-Based Crawling (Playwright & Cheerio): In native mode, the crawler opens headless browser instances using Playwright and Crawlee to navigate TikTok pages, bypassing bot detection, and fetches profile bios, hashtag pages, video feeds, and comments.
3. Data Cleaning & Scrapers Integration:
   • It extracts contact details (like emails and websites) directly from bio text.
   • If a native request is blocked, TrendPilot automatically queries external fallback actors via the Apify API (Actor.call) to guarantee uninterrupted uptime.
4. Algorithmic Scoring & Storage: It runs internal scoring models (Virality Score, Lead Score, Creator Score), saves video/cover assets to the Key-Value Store, and outputs cleaned, structured B2B lead objects to the default dataset.

---

🚀 Features

• Guided Run Templates (runMode):
  • Creator Lead List: Isolates profile bios, contact emails, and computes a Lead Score.
  • Viral Video Report: Identifies breakout viral content ideas using view-to-follower ratios.
  • Competitor Monitoring: Audits brand profile performance and interaction density.
  • Content Calendar Planner: Analyzes captions/comments to draft content angles.
• Proprietary Scoring Models (0-100): Virality Score, Creator Score, Brand Fit Score, Lead Score, and Music Momentum.
• Asset Downloads & Archiving: Saves MP4 videos, cover JPGs, and avatars natively into the Key-Value Store.
• Legacy Compatibility Mode: Auto-maps fields to preserve integrations for migration-safe legacy schemas.

---

📝 Input Parameters

• runMode (Select, default: "creatorLeadList"): Select the target report preset.
• searchTerms (Array): Keywords, hashtags, or creator usernames to prospect.
• maxResults (Integer, default: 20): Maximum videos or profiles to scrape.
• legacyCompatibilityMode (Boolean, default: false): Output fields matching legacy Apify TikTok scraper schemas.
• saveVideos (Boolean, default: false): Save extracted MP4 video streams to the Key-Value Store.

---

📦 Output Format

TrendPilot delivers output structured according to the selected run template:

Creator Lead List Preset Output Example

{
  "creatorUsername": "scale_with_growth",
  "creatorNickname": "Growth Consultant",
  "bio": "Scale your agency. Contact: hello@agency.com",
  "followers": 142000,
  "engagementRate": 6.84,
  "email": "hello@agency.com",
  "profileUrl": "https://www.tiktok.com/@scale_with_growth",
  "leadScore": 95
}

---

🛠 How to Integrate

You can trigger TrendPilot programmatically using the official Apify client libraries:

JavaScript/TypeScript Client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

const input = {
    "runMode": "creatorLeadList",
    "searchTerms": ["#marketingagency"],
    "maxResults": 10
};

const run = await client.actor("orbitai/trend-pilot-tiktok-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python Client

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "runMode": "creatorLeadList",
    "searchTerms": ["#marketingagency"],
    "maxResults": 10
}

run = client.actor("orbitai/trend-pilot-tiktok-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

---

⚖️ Legal & Compliance

This tool utilizes web scrapers to access publicly available TikTok data. Users are responsible for complying with TikTok's Terms of Service and ensuring that outbound pitches or lead lists compiled using this Actor adhere to local data collection laws and anti-spam regulations (GDPR, CAN-SPAM, CCPA).