### Makefile: Setup Osintgram Credentials

Source: https://github.com/datalux/osintgram/blob/master/README.md

Initializes Osintgram by setting up necessary Instagram credentials. This command is part of the Makefile's simplified workflow and should be run from the repository's root.

```makefile
make setup
```

--------------------------------

### User Info JSON Structure Example

Source: https://context7.com/datalux/osintgram/llms.txt

An example of the JSON structure for user profile information obtained by Osintgram. It includes details like biography, follower/following counts, and contact information if available.

```json
{
  "id": 123456789,
  "full_name": "John Doe",
  "biography": "Photographer | Traveler",
  "edge_followed_by": 15420,
  "edge_follow": 892,
  "is_business_account": true,
  "is_verified": false,
  "profile_pic_url_hd": "https://...",
  "email": "john@example.com",
  "whatsapp_number": "+1234567890",
  "city_name": "New York",
  "contact_phone_number": "+1234567890"
}
```

--------------------------------

### Followers JSON Structure Example

Source: https://context7.com/datalux/osintgram/llms.txt

An example of the JSON structure for follower data returned by Osintgram. It includes basic user information for each follower.

```json
{
  "followers": [
    {
      "id": 111222333,
      "username": "user1",
      "full_name": "User One",
      "profile_pic_url": "https://...",
      "is_private": false,
      "is_verified": false
    }
  ]
}
```

--------------------------------

### Build Osintgram Docker Image

Source: https://github.com/datalux/osintgram/blob/master/README.md

Builds the Docker image for Osintgram. This command tags the image as 'osintgram' and prepares it for containerization. Ensure Docker is installed and you are in the root directory of the repository.

```bash
docker build -t osintgram .
```

--------------------------------

### Addresses JSON Structure Example

Source: https://context7.com/datalux/osintgram/llms.txt

An example of the JSON structure for location data (addresses) extracted by Osintgram. This shows the address string and the timestamp when it was recorded.

```json
{
  "address": [
    {
      "address": "350 5th Ave, New York, NY 10118, USA",
      "time": "2024-01-15 14:30:22"
    },
    {
      "address": "Eiffel Tower, Paris, France",
      "time": "2024-01-10 09:15:00"
    }
  ]
}
```

--------------------------------

### Get Users Tagging Target (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Retrieves a list of users who have tagged the target user in their photos. The results are sorted by the frequency of tagging. This command requires no specific input beyond the command itself.

```bash
Run a command: wtagged

# Output:
# Searching for users who tagged target...
# Woohoo! We found 45 photos
#
# +--------+------------+------------------+-------------------+
# | Photos | ID         | Username         | Full Name         |
# +--------+------------+------------------+-------------------+
# | 8      | 123123123  | best_friend      | Best Friend       |
# | 5      | 456456456  | colleague_work   | Work Colleague    |
# | 3      | 789789789  | event_photos     | Event Photography |
# +--------+------------+------------------+-------------------+
```

--------------------------------

### Get Users Commenting on Target's Posts (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Lists users who have commented on the target's photos, ordered by how frequently they comment. This command is useful for identifying engaged users. No additional input is required.

```bash
Run a command: wcommented

# Output:
# Searching for users who commented...
#
# +----------+------------+------------------+-------------------+
# | Comments | ID         | Username         | Full Name         |
# +----------+------------+------------------+-------------------+
# | 45       | 111222333  | super_fan        | Super Fan         |
# | 32       | 444555666  | loyal_follower   | Loyal Follower    |
# | 21       | 777888999  | friend_account   | Close Friend      |
# +----------+------------+------------------+-------------------+
```

--------------------------------

### Initialize Osintgram API Client (Python)

Source: https://context7.com/datalux/osintgram/llms.txt

Demonstrates how to initialize the Osintgram API client in Python. This involves specifying the target username and various options such as output format, file saving, and CLI mode.

```python
from src.Osintgram import Osintgram

# Initialize with target username and options
api = Osintgram(
    target="targetusername",    # Instagram username to analyze
    is_file=True,               # Save output to text files
    is_json=True,               # Export output as JSON
    is_cli=False,               # CLI mode (single command)
    output_dir="output",        # Custom output directory
    clear_cookies=False         # Clear cached session
)

# Available methods:
api.get_user_info()             # Get target profile info
api.get_followers()             # Get followers list
api.get_followings()            # Get following list
api.get_user_photo()            # Download photos
api.get_user_stories()          # Download stories
api.get_user_propic()           # Download profile picture
api.get_addrs()                 # Get tagged locations
api.get_hashtags()              # Get used hashtags
api.get_captions()              # Get post captions
api.get_total_comments()        # Get comment count
api.get_comment_data()          # Get detailed comments
api.get_total_likes()           # Get like count
api.get_media_type()            # Get media type breakdown
api.get_people_tagged_by_user() # Get users tagged by target
api.get_people_who_tagged()     # Get users who tagged target
api.get_people_who_commented()  # Get users who commented
api.get_fwersemail()            # Get follower emails
api.get_fwingsemail()           # Get following emails
api.get_fwersnumber()           # Get follower phone numbers
api.get_fwingsnumber()          # Get following phone numbers
api.change_target()             # Change target user
api.clear_cache()               # Clear session cache
```

--------------------------------

### Initialize HikerAPI Client (Python)

Source: https://context7.com/datalux/osintgram/llms.txt

Shows how to initialize the HikerCLI client, which uses the HikerAPI for potentially more reliable Instagram data retrieval with fewer rate limits. The initialization parameters are similar to the Osintgram class.

```python
from src.hikercli import HikerCLI

# Initialize with HikerAPI token
api = HikerCLI(
    target="targetusername",
    is_file=True,
    is_json=True,
    is_cli=False,
    output_dir="output",
    clear_cookies=False
)

# Same methods available as Osintgram class
# HikerAPI provides more reliable access with fewer rate limits
```

--------------------------------

### Makefile: Build and Run Osintgram

Source: https://github.com/datalux/osintgram/blob/master/README.md

Builds the Osintgram Docker image and runs it using Docker-compose. This command streamlines the deployment process and will prompt for the target Instagram account.

```makefile
make run
```

--------------------------------

### Makefile: Build and Run for Testing

Source: https://github.com/datalux/osintgram/blob/master/README.md

Builds and runs a container for development and testing purposes without invoking the main script. This is useful for interactive debugging within the Docker environment.

```makefile
make build-run-testing
```

--------------------------------

### Git: Checkout Development Branch

Source: https://github.com/datalux/osintgram/blob/master/README.md

Switches the local repository to the 'development' branch. This allows you to use the latest features and fixes that are under active development.

```bash
git checkout development
```

--------------------------------

### Run Osintgram Docker Container

Source: https://github.com/datalux/osintgram/blob/master/README.md

Runs the Osintgram Docker container interactively. It mounts the current directory's 'output' folder into the container for persistent results and requires a target Instagram account. The `--rm` flag cleans up the container after execution.

```bash
docker run --rm -it -v "$PWD/output:/home/osintgram/output" osintgram <target>
```

--------------------------------

### Git: Checkout Master Branch

Source: https://github.com/datalux/osintgram/blob/master/README.md

Ensures that your local repository is on the 'master' branch, which contains the stable release of the project.

```bash
git checkout master
```

--------------------------------

### Run Osintgram with Docker-compose

Source: https://github.com/datalux/osintgram/blob/master/README.md

Executes Osintgram using Docker-compose. This command simplifies the process of running the container defined in `docker-compose.yml`, requiring only the target Instagram account as an argument.

```bash
docker-compose run osintgram <target>
```

--------------------------------

### Configure File Output (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Controls whether command output is saved to text files. Setting `FILE=y` enables file output, while `FILE=n` disables it. Output files are typically saved in an `output/<target_username>/` directory.

```bash
# Enable file output
Run a command: FILE=y
# Output: Write to file: enabled

# Disable file output
Run a command: FILE=n
# Output: Write to file: disabled

# Output files are saved as:
# output/<target_username>/<target_username>_<command>.txt
```

--------------------------------

### Makefile: Cleanup Testing Container

Source: https://github.com/datalux/osintgram/blob/master/README.md

Removes the testing container created by the `build-run-testing` command. This helps in maintaining a clean development environment.

```makefile
make cleanup-testing
```

--------------------------------

### Git: Update to Latest Stable Release

Source: https://github.com/datalux/osintgram/blob/master/README.md

Downloads the latest stable version of Osintgram from the 'master' branch. Make sure you have checked out the 'master' branch before executing this command.

```bash
git pull origin master
```

--------------------------------

### Extract Emails from Followed Users (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Extracts publicly available email addresses from the profiles of users that the target is following. The command asks for confirmation to retrieve all emails. This process may require significant time.

```bash
Run a command: fwingsemail

# Output:
# Searching for emails of users followed by target... this can take a few minutes
#
# Do you want to get all emails? y/n: y
#
# +------------+------------------+-------------------+------------------------+
# | ID         | Username         | Full Name         | Email                  |
# +------------+------------------+-------------------+------------------------+
# | 123123123  | brand_official   | Brand Official    | info@brand.com         |
# | 456456456  | agency_account   | Marketing Agency  | contact@agency.com     |
# +------------+------------------+-------------------+------------------------+
```

--------------------------------

### Git: Update to Latest Development Version

Source: https://github.com/datalux/osintgram/blob/master/README.md

Pulls the latest changes from the 'development' branch of the remote repository. Ensure you are on the 'development' branch before running this command.

```bash
git pull origin development
```

--------------------------------

### Extract Emails from Followers (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Extracts publicly available email addresses from the profiles of the target's followers. The command prompts the user to specify whether to retrieve all emails or a limited number. It can take a few minutes to complete.

```bash
Run a command: fwersemail

# Output:
# Searching for emails of target followers... this can take a few minutes
# Catched 1500 followers email
#
# Do you want to get all emails? y/n: n
# How many emails do you want to get? 50
#
# +------------+------------------+-------------------+------------------------+
# | ID         | Username         | Full Name         | Email                  |
# +------------+------------------+-------------------+------------------------+
# | 111222333  | business_user1   | Business User     | contact@business.com   |
# | 444555666  | creator_account  | Content Creator   | hello@creator.io       |
# +------------+------------------+-------------------+------------------------+
```

--------------------------------

### Extract Phone Numbers from Followed Users (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Extracts publicly available phone numbers from the profiles of users followed by the target. The command prompts for confirmation to fetch all numbers. This process may take a considerable amount of time.

```bash
Run a command: fwingsnumber

# Output:
# Searching for phone numbers of users followed by target... this can take a few minutes
#
# Do you want to get all phone numbers? y/n: y
#
# +------------+------------------+-------------------+----------------+
# | ID         | Username         | Full Name         | Phone          |
# +------------+------------------+-------------------+----------------+
# | 123123123  | restaurant_nyc   | NYC Restaurant    | +1212555xxxx   |
# | 456456456  | service_provider | Service Pro       | +1718555xxxx   |
# +------------+------------------+-------------------+----------------+
```

--------------------------------

### Configure JSON Output (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Enables or disables the export of command output in JSON format. Setting `JSON=y` activates JSON export. This is useful for programmatic processing of results.

```bash
# Enable JSON export
Run a command: JSON=y
# Output: Export to JSON: enabled
```

--------------------------------

### Extract Phone Numbers from Followers (Bash)

Source: https://context7.com/datalux/osintgram/llms.txt

Extracts publicly available phone numbers from the profiles of the target's followers. Users can choose to retrieve all numbers or a specified quantity. This operation can be time-consuming.

```bash
Run a command: fwersnumber

# Output:
# Searching for phone numbers of users followers... this can take a few minutes
#
# Do you want to get all phone numbers? y/n: n
# How many phone numbers do you want to get? 25
#
# +------------+------------------+-------------------+----------------+
# | ID         | Username         | Full Name         | Phone          |
# +------------+------------------+-------------------+----------------+
# | 111222333  | business_acct    | Business Account  | +1234567890    |
# | 444555666  | shop_owner       | Shop Owner        | +0987654321    |
# +------------+------------------+-------------------+----------------+
```

--------------------------------

### Change Target User in Osintgram

Source: https://context7.com/datalux/osintgram/llms.txt

Allows changing the target Instagram username during an interactive Osintgram session without needing to restart the application. This is useful for analyzing multiple accounts sequentially.

```bash
Run a command: target

# Output:
# Insert new target username: newusername
# Logged as your_username. Target: newusername [987654321] [NOT FOLLOWING]
```

--------------------------------

### Clear Cache in Osintgram

Source: https://context7.com/datalux/osintgram/llms.txt

Clears cached session data and cookies used by Osintgram. This action forces the tool to re-authenticate with Instagram, which can resolve issues related to outdated session information.

```bash
Run a command: cache

# Output:
# Cache Cleared.
```

--------------------------------

### Disable JSON Export in Osintgram

Source: https://context7.com/datalux/osintgram/llms.txt

This command-line option disables JSON export for Osintgram, ensuring that output is not saved in JSON format. This is useful when only plain text or file-based output is desired.

```bash
Run a command: JSON=n

# Output: Export to JSON: disabled
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.