Southwest Price Drop Bot

by PetroccoCo


Southwest Price Drop Bot

This tool lets you monitor the price of Southwest flights that you've booked. It will notify you if the price drops below what you originally paid. Then you can re-book the same flight and get Southwest credit for the price difference. This tool also lets you monitor the price of all Southwest flights on a given day. It will notify you if any flight on that day drops below the previous cheapest flight.

Note that you need to have a Plivo account to send the text message notifications and a Mailgun account to send the email notifications. You can run this tool without these accounts, but you won't get the notifications.

You can log in with either:

  • The admin username/password combo, example: admin and the-admin-password-123
  • A username/password combo, example: mom and the-admin-password-123

The second option is nice when giving out access to friends and family since it will only display alerts for the given username. Note that the password is the same for all accounts, and the admin can see all alerts.

When creating alerts, note that the email and phone numbers are optional. If those are both left blank, the user will need to manually log in to view price drops.


  1. Click this button: deploy
  2. Fill out the config variables and click Deploy
  3. Open up the Heroku Scheduler from your app's dashboard
  4. Add an hourly task that runs npm run task:check

When updates become available, you will have to deploy them yourself using the Heroku CLI. This app follows SemVer in its versioning, so make sure to read the release notes when deploying a major version change.

Note: Deployed versions prior to 4/9/2018 using Mailgun will need to verify constants: MAILGUN_DOMAIN and MAILGUN_EMAIL.

Note: Deployed versions prior to 4/28/2018 (< 3.0.0) on Heroku will need to install the buildpack


Version history

[3.1.1] - 2018-5-4

  • Fix bug with crash when email or phone number is not set but respective service is enabled
  • Add semaphore to limit number of pages open at once - hopefully fixing the "Error: Page crashed" error. Limited to 5 pages. Defaults to 5 pages at once - set ENV.MAX_PAGES to change.

[3.1.0] - 2018-4-29

  • Add checks for invalid error
  • Add notification bars for invalid parameters

[3.0.1] - 2018-4-28

  • Avoid multiple browser instances during task:check - reduce memory usage
  • Add nodejs buildpack for Heroku deployment

[3.0.0] - 2018-4-28

  • Refactor to support updated Southwest site redesign, replace osmosis with puppeteer

[2.1.0] - 2018-4-14

  • Add support for checking for the cheapest flight on a day

[2.0.1] - 2018-4-9

  • Integrate upstream changes from PetroccoCo (email handling) and pmschartz (redesign)

[2.0.0] - 2017-12-2

  • Support Mailgun and Plivo (email and sms)

[1.9.5] - 2017-11-30

  • Support Mailgun

[< 1.9.5]

  • Prior work


This is a fork of minamhere's fork of maverick915's fork of scott113341's original project. Downstream changes were integrated from: