GoWild Search

GoWild Flight Scraper Destination Finder

This program allows users with Frontier Airlines' GoWild all-you-can-fly pass to quickly check the availability of flights to all different destinations. By scraping Frontier Airlines' website, the program provides information on flights available for the current day or the next day from the specified origin airport. This program is designed for those with the GoWild pass who embrace the spontaneity of it and want to see all available adventures they can take within the 24-hour booking period.

Updates

Most recent update allows for roundtrips! It will automatically search for next-day return flights for today departures. Also should run faster by checking dates first and improved use for rate limiting.

Prerequisites

Before running gowild_scraper.py, make sure you have the following installed on your system:

• Python 3.6 or higher. If you don't have Python installed, follow the instructions here to download it.
• requests library
• beautifulsoup4 library
• browsercookie library

You can install the required libraries using pip with the following instructions:

1. Open the terminal/command prompt following the instructions mentioned above.
2. Navigate to the directory (folder) you want to download the program files to using the cd <path> command. For example, if you want to download the files to your desktop, you can use the following command:

   User> cd Desktop

   OR Navigate to the folder how you normally would and once inside right click and chose to 'Open in Terminal'
3. Download the program files using the following command:

   pip install -r requirements.txt

If you are confused by this jump to my broken down guide :) for set up.

Usage

To run the program, execute the following command in your terminal what's my terminal?:

python gowild_scraper.py -o [origin] -d [dates] -t [enable roundtrip=1] -c -r [resume]

The program accepts the following command-line arguments:

• -o or --origin: Specifies the origin airport IATA code.
• -d or --dates: Specifies the dates to show flights for. Use the following values:
  • 0: Today
  • 1: Tomorrow
  • any #: Date today + # of days after (if today is 01/01, input 4 would search dates 01/05)
• -t or --roundtrip: (Optional) Enable search for a roundtrip/return flights for tomorrow.
  • 1 for yes
  • defualt or nothing is no
• -c or --cjs: (Optional) Use browser cookies. If specified, the program will use cookies from your default web browser.
• -r or --resume: (Optional) Index of the airport to resume from. Use index 21 to only search for contiguous US destinations.

Note: The -t, -c and -r options are optional, and you can omit them if not needed.

Example input

To check the flight availability from the origin airport "PHX" (Phoenix) for tomorrow with next day return flights, run the following command:

python gowild_scraper.py -o PHX -d 1 -t 1

This will display the available flights for both today and tomorrow from Phoenix.

The program will display the available flights and their details, including departure dates, total flight time, and prices. If there are roundtrip flights available for the next day, they will be marked with **.

New! Next day return flights are only searched for if you plan on departing today. Do you want something different? Let me know!

After displaying the flight information, the program will list the available destinations

and ask for your input again. You can enter the index number of a destination to check for flights from your origin to that destination. Alternatively, you can enter exit to quit the program.

Limitations

• Frontier Airlines' website may have usage restrictions or rate limiting in place. Running the program too frequently or making too many requests in a short period could lead to IP blocking or other issues. It is recommended to use the program responsibly and respect the website's terms of service.

Disclaimer

This program is for educational purposes only. Use it responsibly and respect the website's terms of service found here. The developers are not responsible for any misuse or consequences caused by using this program.

If you encounter any issues or have suggestions for improvements, please feel free to contribute or open an issue in the project repository.

I would love further contributions from fellow lovers of travel and innovation.

This program was mainly an educational personal project for myself.

That being said there are many imperfections and areas of improvement to make this program more efficient and user friendly.

I'm making this repo public so I can learn more from other possible contributors.

Happy flying!!!

If any of you would like to help further this educational project for the community but don't code, I've created a form where you can leave feedback for update inspo! Or if you'd like to help fuel the work with a cup of coffee that'd be cool too. :)

Example output

CUN to BNA: Nashville available:
flight 1. 1 Stop MCO
        Date: 07-06
        Depart: 10:01 AM
        Total flight time: 23 hrs 53 min
Price: $100.18
CUN to BNA: 1 GoWild flights available for Thursday, 07-06-23

**Return flight available:
flight 1. 1 Stop MCO
        Date: 07-07
        Depart: 10:49 AM
        Total flight time: 22 hrs 31 min
Price: $84.74
flight 2. 1 Stop PHL
        Date: 07-07
        Depart: 2:45 PM
        Total flight time: 20 hrs 22 min
Price: $84.74
BNA to CUN: 2 GoWild return flights available for Friday, 07-07-23
No flights from CUN to AUS

45 destinations found from CUN:
**NAS: Bahamas
**BQN: Aguadilla, Puerto Rico
**SJU: San Juan, Puerto Rico
**PHX: Phoenix
**XNA: Arkansas
**LIT: Little Rock, AR
**ONT: Ontario
**SAN: San Diego
....
** = next day return flight available

Easy Guide

• Downloading Python
• Opening your terminal
• Downloading additional libraries
• Downloading the flight search program
• Running the flight search program
• Example output

Opening your terminal

Windows

Press Win + R to open the Run dialog, type cmd, and press Enter.

macOS

Press Command + Space to open Spotlight Search, type Terminal, and press Enter.

Linux

Press Ctrl + Alt + T to open the terminal.

Downloading Libraries

Next step is downloading the additional python libraries, like extension packs, that I have utilized in the program. If you have installed and set up Python correctly, you should be able to download the packages through your terminal. Instructions for opening your terminal for Windows, Mac, Linux

1. Open the terminal/command prompt following the instructions mentioned above.
2. Navigate to the directory (folder) you want to download the program files to using the cd <path> command. For example, if you want to download the files to your desktop, you can use the following command:

   User> cd Desktop

   OR Navigate to the folder how you normally would and once inside right click and chose to 'Open in Terminal'
3. Download the program files using the following command:

   pip install -r requirements.txt

Downloading this program

Alright we're almost there!

To use the gowild_scraper.py program, you need to download the actual program files from the GitHub repository.

1. Open the terminal/command prompt following the instructions mentioned above.
2. Navigate to the directory (folder) you want to download the program files to using the cd <path> command. For example, if you want to download the files to your desktop, you can use the following command:

   User> cd Desktop

   OR Navigate to the folder how you normally would and once inside right click and chose to 'Open in Terminal'
3. Download the program files using the following command:

   git clone https://github.com/fly-metothemoon/GWsearch.git

If you do not have git installed, you can download the files manually by following these steps:

1. Go to my GitHub repository, if you're reading this you're probably already there! https://github.com/fly-metothemoon/GWsearch.
2. Click on the green "Code" button and select "Download ZIP" to download the repository as a ZIP file.
3. Once the ZIP file is downloaded, locate it on your computer and unzip it in to a findable location on your computer.

Running the flight search program

1. Open the terminal/command prompt following the instructions mentioned above.

2. Navigate to the directory (folder) you unzipped where you have saved the gowild_scraper.py file using the cd <path> command. For example, if the file is on your desktop, you can use the following command:

• 'dir' for windows or 'ls' for mac will list all files in current directory.

  User> cd Desktop
  User>Desktop> cd Frontier

  OR Navigate to the folder how you normally would and once inside right click and chose to 'Open in Terminal'

1. Run the program using the following command:

   python gowild_scraper.py -o ORIGIN -d DATES

   Replace ORIGIN with the IATA airport code of your origin airport (e.g., JFK for John F. Kennedy International Airport) and replace DATES with one of the following options:

   • 0 - Show flights for today.
   • 1 - Show flights for tomorrow.
   • any # - Show flights for todays date + inputted number

If you'd like to enable it to search for roudtrips/return flights for the next day, include -t or --roundtrip followed by 1 for yes

• defualt or nothing is no

For example, to check flights for today from JFK Airport, you would use the following command:

python gowild_scraper.py -o JFK -d 0 -t 1

1. The program will display the available flights and their details, including departure dates, total flight time, and prices. If there are roundtrip flights available for the next day, they will be marked with **. Next day return flights are only searched for if you plan on departing today. Do you want something different? Let me know!

2. After displaying the flight information, the program will list the available destinations

and ask for your input again. You can enter the index number of a destination to check for flights from your origin to that destination. Alternatively, you can enter exit to quit the program.

Return back to Usage for most information and customization. Go here to see the example output!

Happy flying and thanks for the support!