βš™οΈ Configuration

August 20, 2026 Β· View on GitHub

πŸ•΅οΈβ€β™‚οΈ Meta Scan

Facebook OSINT Framework to extract public profile data, business details, about information, transparency data, and more from Facebook pages using the RapidAPI Facebook Pages Scraper.

Meta Scan

Meta Scan Demo

Python version RapidAPI License OSINT


πŸš€ Features

  • πŸ” Profile Reconnaissance: Extract full Facebook profile data (name, ID, gender, email, phone, website, followers, likes, categories, price range, description, profile/cover photos, etc.)
  • 🏒 Business Home: Retrieve business-specific homepage details.
  • πŸ“ About Section: Extract the complete "About" text of the page.
  • πŸ”’ Transparency Data: Get ad status and page creation date.
  • ⚑ Fast API-Based Checking: Powered by RapidAPI's Facebook Pages Scraper 3.
  • πŸ“„ JSON and TXT Report Generation: All results are saved locally with timestamps.
  • 🎨 Colored CLI Interface: Clean and professional terminal output.
  • πŸ” Secure API Key Handling: Credentials stored in .env.
  • πŸ“‚ Batch Processing: Supports single username or batch via file (planned).
  • πŸ•ΉοΈ Animated Progress: Live feedback during API calls.
  • πŸ’‘ Automatic API Setup: Interactive onboarding via --set-api.
  • πŸ’° Donation Support: Flag to show support links.

πŸ“‹ Prerequisites

  • Python 3.8+
  • Dependencies: requests, python-dotenv, colorama, urllib3

πŸ”‘ API Key (RapidAPI)

Meta Scan uses the following API:

NAMEKEY
Facebook Pages Scraper 3πŸ”‘ (Required)

Steps:

  1. Go to RapidAPI and create a free account.
  2. Subscribe to the Facebook Pages Scraper 3 API (select the free plan).
  3. Get your API Key from the RapidAPI dashboard.
  4. Copy your API Key.

Meta Scan

βš™οΈ Configuration

You can set your API key at any time with:

python3 meta_scan.py --set-api

Your key will be automatically saved in: .env

Meta Scan


πŸ’» Usage

πŸ”Ή Single target (basic profile)

python3 meta_scan.py -u riatadental

πŸ”Ή Save results to JSON (creates file in ./reports)

python3 meta_scan.py -u riatadental --out-json ./reports
python3 meta_scan.py --donate

Meta Scan


πŸ“ Reports

All results are saved in the directory specified with --out-json.

Example file: riatadental_20260820_143022_a1b2c3.json

Tip

Tip: Check the generated JSON report for advanced metadata not displayed in the terminal – for example, the full INTRO_CARDS object, photo lists, and all raw fields from the API.


πŸ“¦ Installation

git clone https://github.com/HackUnderway/meta_scan.git
cd meta_scan
pip install -r requirements.txt

Warning

Disclaimer

This tool is intended for educational and OSINT research purposes only.

  • Do not use for illegal activities.
  • The developer is not responsible for any misuse or damage caused by this tool.

πŸ“ Notes

  • The scraper extracts publicly available data from Facebook pages.

  • The free plan of the API has usage limits – check your RapidAPI dashboard for quota.

  • A 403 error may indicate that you are not subscribed to a specific endpoint (the script now uses only endpoints available in the free plan).

  • The --no-business flag helps avoid hitting endpoints that may require a paid subscription.

  • The JSON report contains all available metadata, including fields not displayed in the terminal (e.g., full photo URLs, intro cards, etc.).

  • If you encounter issues, verify your API key and subscription status.


The project is open to partners.

πŸ§ͺ Supported Systems

DistributionVerified versionSupportedStatus
Kali Linux2026.2βœ…Working
ParrotOS7.3βœ…Working
Windows11βœ…Working
BackBox9βœ…Working
Arch Linux2026.08.01βœ…Working

Support

For questions, bug reports, or suggestions, please contact: info@hackunderway.com

License

  • Instagram Detective is licensed.
  • See the LICENSE file for more information.

πŸ‘¨β€πŸ’» Author

Patreon Web site Facebook YouTube Twitter/X Instagram TryHackMe Ko-fi HackTheBox

πŸ’° Bitcoin Donations

Support the project with Bitcoin:

Address:

bc1qjd5pu8kmdqljun3qyw5e9mj4kdef9n8sutj7j4

Bitcoin QR

Thank you for your support! πŸ™

β˜•οΈ Support the project

If you like this tool, consider buying me a coffee:

Buy Me a Coffee

🌞 Subscriptions

Subscribe to: Jey Zeta

πŸ•΅οΈβ€β™‚οΈ OSINT Platform

OSINT Platform

Automate OSINT processes
New Enterprise Mode – Maltego-inspired interface with visual graphs and professional workflows.
πŸ“’ See what's new

Kali Linux

from Peru, made in with by: Victor Bancayan

Β© 2026