Tinder Account Creator

This project provides a script to create Tinder accounts using the Tinder API. It supports generating accounts with randomized geolocation data and saving account details in multiple formats such as JSON, Excel, and XML. The project also includes functionality to fetch Snapchat user data such as name and images using the Snapchat API. The project is modular and designed for scalability, including token refreshing functionality and external location management.

Features

• Create Tinder accounts using the API.
• Fetch Snapchat user data, including name and profile images, using the Snapchat API.
• Randomized geolocation selection for diverse user profiles.
• Supports saving account details in:
  • JSON
  • Excel
  • XML
• Modular design for easy maintenance and scalability.
• Automatic token refreshing for seamless API interactions.
• Unit tests to ensure code reliability.

Requirements

• Python 3.8 or higher

• Required libraries (install via pip):

  • requests
  • pandas
  • openpyxl
  • unittest (built-in with Python)

• A valid Snapchat API token saved in data/snapchat_token.json.

Setup Instructions

Clone the Repository

git clone https://github.com/ProjectEzenity/TAC.git
cd TAC

Install Dependencies

pip install -r requirements.txt

Project Structure

TAC/
├── data/
│   ├── output/
│   │   ├── accounts.json        # JSON output file
│   │   ├── accounts.xlsx        # Excel output file
│   │   ├── accounts.xml         # XML output file
│   ├── input_data.xlsx          # Input data template
│   ├── snapchat_token.json      # Snapchat token file
│   ├── tinder_token.json        # Tinder token file
├── src/
│   ├── config.py                # Configuration file for constants
│   ├── create_account.py        # Main script to create accounts
│   ├── data_providers.py        # Load data from files
│   ├── locations.py             # List of geolocations
│   ├── output_manager.py        # Functions to save data in various formats
│   ├── snapchat_data_fetcher.py # Script to fetch Snapchat user data
│   ├── token_manager.py         # Token handling logic
│   ├── utils.py                 # Utility functions
├── tests/
│   ├── test_create_account.py   # Unit tests for the project
├── LICENSE                      # GNU General Public License v3.0
├── README.md                    # Project documentation

Configuration

1. Tinder Token:

   • Obtain a valid Tinder API token and save it in data/tinder_token.json:

     {
         "access_token": "your_tinder_access_token",
         "refresh_token": "your_refresh_token",
         "token_type": "Bearer",
         "expires_in": 3600
     }

2. Snapchat Token:

   • Obtain a valid Snapchat API token and save it in data/snapchat_token.json:

     {
         "access_token": "your_snapchat_access_token",
         "refresh_token": "your_refresh_token",
         "token_type": "Bearer",
         "expires_in": 3600
     }

3. Geolocations:

   • Geolocations are managed in src/locations.py (Python) or data/locations.json (JSON).
   • To add more locations, edit the respective file.

4. Input Data:

   • Populate data/input_data.xlsx with account information (name, birth_date, gender).

5. Dynamic Headers:

   • The headers used for Tinder API requests are dynamically updated with session-specific data, including:
     • persistent-device-id: Generated at runtime.
     • install-id: Generated at runtime.
     • app-session-id: Generated at runtime.
     • funnel-session-id: Generated at runtime.
     • app-session-time-elapsed: Updated with the elapsed session time.
   • This ensures compliance with Tinder API requirements.

Example Headers

{
    "user-agent": "Tinder Android Version 12.6.0",
    "os-version": "25",
    "app-version": "4023",
    "platform": "android",
    "platform-variant": "Google-Play",
    "x-supported-image-formats": "webp",
    "accept-language": "en-US",
    "tinder-version": "12.6.0",
    "store-Variant": "Play-Store",
    "persistent-device-id": "123e4567-e89b-12d3-a456-426614174000",
    "content-type": "application/x-protobuf",
    "host": "api.gotinder.com",
    "connection": "close",
    "accept-encoding": "gzip,deflate, br",
    "install-id": "123e4567-e89b-12d3-a456-426614174001",
    "app-session-id": "123e4567-e89b-12d3-a456-426614174002",
    "funnel-session-id": "123e4567-e89b-12d3-a456-426614174003",
    "app-session-time-elapsed": "0.123"
}

Example Header Initialization

from config import update_headers
from utils import generate_device_id, generate_install_id, generate_session_id, SessionTimer

device_id = generate_device_id()
install_id = generate_install_id()
app_session_id = generate_session_id()
funnel_id = generate_session_id()
session_timer = SessionTimer()

update_headers(
    device_id=device_id,
    install_id=install_id,
    app_session_id=app_session_id,
    funnel_id=funnel_id,
    elapsed_time=session_timer.get_elapsed_time()
)

How It Works

1. Header Initialization:
   • At the start of the script, unique session identifiers are generated and headers are dynamically updated.
2. Input Data Loading:
   • User data is loaded from data/input_data.xlsx or other supported formats (JSON, XML).
3. Account Creation:
   • For each account, the script validates the input, assigns a random geolocation, and sends the request to Tinder API.
4. Snapchat Data Fetching:
   • Fetches user data, including name and profile images, using the Snapchat API.
5. Token Management:
   • If the token expires, it is refreshed automatically using the refresh token.
6. Output Generation:
   • Results are saved in JSON, Excel, and XML formats for easy reference.
7. Unit Tests:
   • Tests validate the functionality of key components to ensure reliability.

Usage

Run the Script to Create Accounts

To create accounts, run the main script:

python src/create_account.py

Run the Script to Fetch Snapchat User Data

To fetch Snapchat user data, run the script:

python src/snapchat_data_fetcher.py

The script will:

• Use the authentication details from data/snapchat_token.json.
• Fetch the user’s name and images from Snapchat API.
• Save the data to data/snapchat_user_data.json.

Run Unit Tests

To ensure everything works as expected, run the unit tests:

python -m unittest discover tests

This will:

• Validate the create_tinder_account function.
• Test the validate_account_data and random_location utilities.

Example Output (data/snapchat_user_data.json)

{
    "name": "John Doe",
    "images": [
        "https://snapchat-profile-image-url-1.com",
        "https://snapchat-profile-image-url-2.com"
    ]
}

Output Files

• JSON: data/output/accounts.json
• Excel: data/output/accounts.xlsx
• XML: data/output/accounts.xml

Randomized Locations

Locations are randomized for each account using the random_location() function. The list of locations can be extended in locations.py or locations.json.

Key Functions

src/create_account.py

• Main script for creating accounts.
• Handles:
  • Input validation.
  • Token refreshing.
  • Saving results in multiple formats.

src/snapchat_data_fetcher.py

• Fetches Snapchat user data, including:
  • Name.
  • Profile images.
  • Saves results to JSON.

src/token_manager.py

• Manages API token lifecycle, including:
  • Loading tokens.
  • Saving tokens.
  • Refreshing tokens if expired.

src/output_manager.py

• Saves account details in:
  • JSON
  • Excel
  • XML

src/locations.py

• Contains a list of geolocations for randomization.

tests/test_create_account.py

• Unit tests for the project:
  • Tests create_tinder_account for successful account creation.
  • Validates error handling for missing account fields.
  • Tests the functionality of random_location.

Examples

Example Input Data (data/input_data.xlsx)

Name	Birth Date	Gender
John Doe	1990-01-01	0
Jane Smith	1992-05-15	1

Example JSON Output

[
    {
        "name": "John Doe",
        "birth_date": "1990-01-01",
        "gender": 0,
        "location": {"lat": 40.7128, "lon": -74.0060},
        "status": "success"
    },
    {
        "name": "Jane Smith",
        "birth_date": "1992-05-15",
        "gender": 1,
        "location": {"lat": 51.5074, "lon": -0.1278},
        "status": "success"
    }
]

Example Command

Run the script and view the outputs:

python src/create_account.py

Extending the Project

• Adding Locations:
  • Edit src/locations.py or data/locations.json to include more geolocations.
• Additional Formats:
  • Extend output_manager.py to support other formats like CSV or database integration.
• Input Sources:
  • Modify create_account.py to load input data from APIs or other sources.

Troubleshooting

• Token Expired:
  • Ensure the refresh_token is valid and the refresh URL in token_manager.py is correct.
  • If you encounter a 401 Unauthorized error, ensure your refresh_token is valid.
  • Check the logs/app.log file for detailed error messages.
• Snapchat API Errors:
  • Ensure the access token in snapchat_token.json is valid and has not expired.
  • If you encounter a 401 Unauthorized error, generate a new token and update the file.
  • Check the logs/snapchat_fetch.log file for detailed error messages.
• HTTP Errors:
  • Ensure that your internet connection is stable.
  • Refer to the error logs to identify specific issues with the API response.
• Missing Dependencies:
  • Install missing libraries with pip install -r requirements.txt.

License

This project is licensed under the GNU General Public License v3.0.

Contributions

Contributions are welcome! Feel free to open an issue or submit a pull request.