Skip to content
kossaiRedouPublic

About

IMR_Tool for Influencer-Market_research-Tool is a Django full-stack platform for influencer marketing research. Search YouTube for sponsored content and discover creators using YouTube Data API v3 and Claude AI. Built in python.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SponsorSpy

SponsorSpy

See the deals behind the content.
Detect sponsorships and discover high-value creators on YouTube.


What it does

SponsorSpy is a web tool for influencer marketing research. It connects to the YouTube Data API and uses AI analysis to give you two things:

Brand Radar scans YouTube videos in any niche and region, then detects brand partnerships and sponsorship mentions inside video descriptions.

Creator Finder discovers YouTube channels matching your criteria (subscribers, average views, country, language) and extracts their public business contact info.

Both modules export results to Excel in one click.


Screenshots

Brand Radar - search form
Brand Radar form
Creator Finder - results
Creator Finder results
Scan history
Finder scan history
Authentication

Register Login


Tech stack

Layer Tech
Backend Django 6, Python 3.13
Frontend Django Templates, Tailwind CSS
APIs YouTube Data API v3, Anthropic Claude API
Database SQLite
Export openpyxl (Excel .xlsx)

Setup

git clone <repo-url>
cd IMR_tool

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

pip install -r requirements.txt

Create a .env file at the project root:

SECRET_KEY=your-django-secret-key
YOUTUBE_API_KEY=your-youtube-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key

Then run:

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

Open http://127.0.0.1:8000 and create an account.


Project structure

IMR_tool/
├── CORE/                 # Base layout, landing page
├── ACCOUNTS/             # Auth, user profiles, API key management
├── BRAND_MONITOR/        # Brand Radar module
│   ├── services.py       # YouTube search + Claude AI analysis
│   ├── models.py         # Search & Result models
│   └── views.py          # Form, results, history, Excel export
├── CREATOR_DISCOVERY/    # Creator Finder module
│   ├── services.py       # YouTube channel discovery + email extraction
│   ├── models.py         # Search & Result models
│   └── views.py          # Form, results, history, Excel export
└── templates/            # All HTML templates (dark theme)

How it works

Brand Radar

  1. Searches YouTube videos by keywords, region, and time period
  2. Filters by minimum view count
  3. Sends each video description to Claude Haiku for brand/sponsor extraction
  4. Returns a table with channel name, video link, views, detected brands, and the relevant snippet
  5. One-click Excel export

Creator Finder

  1. Searches YouTube videos by keywords to discover channels (more reliable than channel search)
  2. Fetches channel details: subscribers, total views, country, description
  3. Filters by subscriber range, average views, and creator's declared country
  4. Extracts business emails from channel descriptions via regex
  5. One-click Excel export

License

MIT

About

IMR_Tool for Influencer-Market_research-Tool is a Django full-stack platform for influencer marketing research. Search YouTube for sponsored content and discover creators using YouTube Data API v3 and Claude AI. Built in python.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages