Influencer Finder Tool

A Node.js CLI tool that runs Apify actors to discover influencers across YouTube, Instagram, TikTok, and Facebook. Results are exported as CSV or JSON for outreach.

Location

• Source: apify-tools/run_actor.js
• Config: apify-tools/.env (contains APIFY_TOKEN)
• Past results: apify-tools/ directory and influencer-results-2026-02-19.csv
• Dashboard: hypnoelp.com/share (with ?code= parameter) (dev only)

How It Works

The tool wraps the Apify REST API. You specify an actor (scraper) and input parameters, it starts the actor run, polls until complete, then downloads results from the dataset.

node --env-file=.env run_actor.js --actor ACTOR_ID --input '{}' [--output file.csv]

Flow

1. Parse CLI arguments (actor, input JSON, output path, format, timeout)
2. Start actor run via POST /v2/acts/{actorId}/runs
3. Poll run status via GET /v2/actor-runs/{runId} until SUCCEEDED/FAILED
4. Download dataset items via GET /v2/datasets/{datasetId}/items
5. Export to CSV or JSON (or display top 5 in terminal)

Supported Actors

CLI Options

Example Usage

# YouTube search, export to CSV
node --env-file=.env run_actor.js \
  --actor "streamers/youtube-scraper" \
  --input '{"searchQueries": ["hypnotherapy"], "maxResults": 50}' \
  --output leads.csv --format csv

# Quick preview (no file saved)
node --env-file=.env run_actor.js \
  --actor "apify/instagram-hashtag-scraper" \
  --input '{"hashtags": ["hypnotherapy"], "resultsLimit": 20}'

Past Results

• Feb 19, 2026: 55 influencers found via YouTube scraper
• Exported to influencer-results-2026-02-19.csv
• Fields: channel name, URL, subscriber count, video count, description, etc.

Dependencies

• Node.js (ES modules, uses node:util parseArgs)
• Apify API token (free tier available)
• No npm dependencies (uses native fetch)

Status

Working. Last used Feb 19, 2026. Ready to run again when needed for new influencer outreach campaigns.