βοΈ 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.
π 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:
| NAME | KEY |
|---|---|
| Facebook Pages Scraper 3 | π (Required) |
Steps:
- Go to RapidAPI and create a free account.
- Subscribe to the Facebook Pages Scraper 3 API (select the free plan).
- Get your API Key from the RapidAPI dashboard.
- Copy your API Key.
βοΈ 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
π» 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
πΉ Donate
python3 meta_scan.py --donate
π 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-businessflag 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
| Distribution | Verified version | Supported | Status |
|---|---|---|---|
| Kali Linux | 2026.2 | β | Working |
| ParrotOS | 7.3 | β | Working |
| Windows | 11 | β | Working |
| BackBox | 9 | β | Working |
| Arch Linux | 2026.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
- Victor Bancayan - (CEO at Hack Underway)
π Links
π° Bitcoin Donations
Support the project with Bitcoin:
Address:
bc1qjd5pu8kmdqljun3qyw5e9mj4kdef9n8sutj7j4
βοΈ Support the project
If you like this tool, consider buying me a coffee:
π Subscriptions
Subscribe to: Jey Zeta
π΅οΈββοΈ OSINT Platform
Automate OSINT processes
New Enterprise Mode β Maltego-inspired interface with visual graphs and professional workflows.
π’ See what's new
from
Peru, made in
with
by: Victor Bancayan
Β© 2026