Author: Derek Redfern
License: MIT
This script is a rudimentary search engine for Southwest Airlines flights. I created it because I love flying Southwest SO MUCH, but the search functionality on their website is incredibly painful when you have flexible airports or flexible dates. Flying anywhere with more than 1 or 2 variables is a nightmare - you have to open multiple browser windows to southwest.com for each possible combination.
Give southwest.py a list of airports you're able to fly out of and into, a list of dates you can fly, and what you want to optimize for (cost, time, number of stops). It'll return all possible flights sorted by your chosen criteria! Maybe you want to fly from any of the 3 SF-area airports to any of the 3 NYC-area airports anytime during the week of Thanksgiving, for example. And you want to do it cheaply. You can search for all of those parameters and get the results compiled into one list.
My goal here is to make it easier for you (and me) to fly Southwest without angering the Southwest Powers-That-Be. Southwest has previously taken down tools in this vein to protect their business model, which I respect and am trying not to disrupt. To that end:
- I will not host this to be run interactively on the web, now or at any point in the future - you must download and run it yourself.
- Be mindful that each variable you add increases the number of pages the script has to scrape on southwest.com. 3 departure airports, 3 arrival airports, and 3 dates is already a whopping 27 pages!
- The script is rate-limited (1 request every 2 seconds) to reduce the stress on the servers, so large queries may take a while to complete. Run it in the background and go do something else for a bit.
Any updates to the format of Southwest's API may cause very strange errors. Inputs are also not completely sanitized and may cause similar errors. If this is the case, open a Github issue and I'll try to bring it back to working order.
Contributions are always welcome and appreciated. I try to stick to PEP8 where I can, with max line length of 110. If you make a change, take out a PR and include testing transcripts and I'll try to merge it in ASAP.
You must have, at a minimum:
- Python 2.7
- Python modules from pip or another source:
- tabulate (0.7.7+)
Only tested on Linux, but there's no reason it shouldn't work on OS X or Windows (if you can manage to install the Python requirements on Windows)
git clone https://github.com/redfern314/southwest-search.git
cd southwest-search
sudo pip install tabulate
python southwest.py -a ARRIVAL_CITIES -d DEPARTURE_CITIES -t DATES
$ python southwest.py -d SFO -a LGA -t 2018-12-02 -s fares
Processed 1/1
flight date depart arrive fares route stops duration
--------- ---------- -------- -------- --------------------------------- -------------------------------- ------- ----------
4158/3971 2018-12-02 06:00 18:50 [u'139.80', u'586.58', u'614.58'] [u'SFO', u'DAL', u'LGA'] 1 9:50
4158/4604 2018-12-02 06:00 16:55 [u'161.80', u'586.58', u'614.58'] [u'SFO', u'DAL', u'LGA'] 1 7:55
4026/4503 2018-12-02 11:40 23:05 [u'196.80', u'586.58', u'614.58'] [u'SFO', u'STL', u'LGA'] 1 8:25
2803/4491 2018-12-02 12:55 23:25 [u'323.80', u'586.58', u'614.58'] [u'SFO', u'DEN', u'LGA'] 1 7:30
4324/3625 2018-12-02 09:15 22:25 [u'327.90', u'590.68', u'618.68'] [u'SFO', u'SAN', u'DAL', u'LGA'] 2 10:10