# kinghacker0/whatsapp-osint architecture

> Architecture diagram of the GitHub repository kinghacker0/whatsapp-osint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kinghacker0/whatsapp-osint
- Repository: https://github.com/kinghacker0/whatsapp-osint

## Overview

WHATS OSINT is a single-script interactive CLI for querying WhatsApp-related information through RapidAPI. The user selects one of six lookups and supplies a phone number; the script dispatches to a lookup handler, which requests endpoint data and formats results. Profile-photo handling additionally decodes and saves returned image data. The source excerpt is partial, so some helper-to-handler relationships and input-validation wiring are not shown and are omitted.

Main entry points: [`whatsapp-osint.py`](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py) (CLI dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI orchestration"]
  node_main["CLI dispatcher<br/>[whatsapp-osint.py]"]
  node_validation["Phone sanitizer<br/>[whatsapp-osint.py]"]
end

subgraph group_lookups["Lookup workflows"]
  node_profile["Profile photo<br/>[whatsapp-osint.py]"]
  node_about["Status and info<br/>[whatsapp-osint.py]"]
  node_business["Business check<br/>[whatsapp-osint.py]"]
  node_devices["Linked devices<br/>[whatsapp-osint.py]"]
  node_osint["Full OSINT data<br/>[whatsapp-osint.py]"]
  node_privacy["Privacy settings<br/>[whatsapp-osint.py]"]
end

subgraph group_processing["Response processing"]
  node_request["Endpoint requester<br/>[whatsapp-osint.py]"]
  node_image["Image decoder<br/>[whatsapp-osint.py]"]
end

node_user(("Investigator"))
node_rapidapi["RapidAPI service"]

node_user -->|"uses menu"| node_main
node_main -->|"dispatches"| node_profile
node_main -->|"dispatches"| node_about
node_main -->|"dispatches"| node_business
node_main -->|"dispatches"| node_devices
node_main -->|"dispatches"| node_osint
node_main -->|"dispatches"| node_privacy
node_profile -->|"calls"| node_request
node_about -->|"calls"| node_request
node_devices -->|"calls"| node_request
node_osint -->|"calls"| node_request
node_privacy -->|"calls"| node_request
node_request -->|"sends HTTP request"| node_rapidapi
node_business -->|"posts verification"| node_rapidapi
node_profile -.->|"saves image data"| node_image

click node_main "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_validation "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_profile "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_about "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_business "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_devices "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_osint "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_privacy "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_request "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"
click node_image "https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_validation toneBlue
class node_profile,node_about,node_business,node_devices,node_osint,node_privacy toneAmber
class node_request,node_image,node_rapidapi toneMint
class node_user toneIndigo
```

## Components

### CLI orchestration

- [CLI dispatcher](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Phone sanitizer](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`

### Lookup workflows

- [Profile photo](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Status and info](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Business check](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Linked devices](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Full OSINT data](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Privacy settings](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`

### Response processing

- [Endpoint requester](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`
- [Image decoder](https://github.com/kinghacker0/whatsapp-osint/blob/main/whatsapp-osint.py): `whatsapp-osint.py`

### Other components

- **Investigator**
- **RapidAPI service**

## Connections

- Investigator → CLI dispatcher: uses menu (evidence: `README.md`)
- CLI dispatcher → Profile photo: dispatches (evidence: `whatsapp-osint.py`)
- CLI dispatcher → Status and info: dispatches (evidence: `whatsapp-osint.py`)
- CLI dispatcher → Business check: dispatches (evidence: `whatsapp-osint.py`)
- CLI dispatcher → Linked devices: dispatches (evidence: `whatsapp-osint.py`)
- CLI dispatcher → Full OSINT data: dispatches (evidence: `whatsapp-osint.py`)
- CLI dispatcher → Privacy settings: dispatches (evidence: `whatsapp-osint.py`)
- Profile photo → Endpoint requester: calls (evidence: `whatsapp-osint.py`)
- Status and info → Endpoint requester: calls (evidence: `whatsapp-osint.py`)
- Linked devices → Endpoint requester: calls (evidence: `whatsapp-osint.py`)
- Full OSINT data → Endpoint requester: calls (evidence: `whatsapp-osint.py`)
- Privacy settings → Endpoint requester: calls (evidence: `whatsapp-osint.py`)
- Endpoint requester → RapidAPI service: sends HTTP request (evidence: `whatsapp-osint.py`)
- Business check → RapidAPI service: posts verification (evidence: `whatsapp-osint.py`)
- Profile photo → Image decoder: saves image data (evidence: `whatsapp-osint.py`)
