PHPackages                             jeancsil/flight-spy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. jeancsil/flight-spy

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

jeancsil/flight-spy
===================

Watch as much flights you want and get notified for YOUR budget. (E-mail and Slack).

1.5.0(9y ago)1802326[12 issues](https://github.com/jeancsil/flight-spy/issues)MITPHPPHP ^5.6.6|^7.0

Since Sep 22Pushed 9y ago9 watchersCompare

[ Source](https://github.com/jeancsil/flight-spy)[ Packagist](https://packagist.org/packages/jeancsil/flight-spy)[ RSS](/packages/jeancsil-flight-spy/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (17)Versions (14)Used By (0)

FlightSpy
=========

[](#flightspy)

[![Flight Spy](https://camo.githubusercontent.com/98d47c8c98782df2b2cca4fa3c96910951f3ecf34cc2d4af359a86bd0de00286/687474703a2f2f627573696e6573732e736b797363616e6e65722e6e65742f436f6e74656e742f696d616765732f6c6f676f2f7373662d77686974652d636f6c6f722e706e67)](http://www.skyscanner.net)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/ff3be6e112cf0382b469103b1b2192c477f449e510221266447a72b273537ad9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6a65616e6373696c2f666c696768742d7370792f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/jeancsil/flight-spy/?branch=master)[![Build Status](https://camo.githubusercontent.com/1539be2db98212a9b7ac6f68c2e64d1755361c116b234d975701163b36f69eeb/68747470733a2f2f7472617669732d63692e6f72672f6a65616e6373696c2f666c696768742d7370792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/jeancsil/flight-spy)[![Latest Stable Version](https://camo.githubusercontent.com/65853c1eaedc3cc0042721ca8f8fae315cd4d0d7ac6a9027a585129c38b990bc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d666c696768742d2d7370792d626c75652e737667)](https://packagist.org/packages/jeancsil/flight-spy)[![GitHub license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://raw.githubusercontent.com/jeancsil/flight-spy/master/LICENSE)[![Twitter](https://camo.githubusercontent.com/895dfbc93db7ee2376691a4f9263a8a9c2d76eceea240287b866811fb0ff6468/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f75726c2f68747470732f6769746875622e636f6d2f6a65616e6373696c2f666c696768742d7370792e7376673f7374796c653d736f6369616c)](https://twitter.com/intent/tweet?text=Watch+the+best+fare+for+your+next+trip!&url=http://github.com%2Fjeancsil%2Fflight-spy)

Looking for the cheapest flights and don't have enough time to track all the prices?
------------------------------------------------------------------------------------

[](#looking-for-the-cheapest-flights-and-dont-have-enough-time-to-track-all-the-prices)

#### Be notified whenever the budget you're looking for pops up by only declaring a **simple JSON file**!

[](#be-notified-whenever-the-budget-youre-looking-for-pops-up-by-only-declaring-a-simple-json-file)

```
[
  {
    "from": "FRA-sky",
    "to": "GRU-sky",
    "search-period-from": "2017-07-01",
    "search-period-to": "2017-07-31",
    "search-period-travel-days": 20,
    "max-price": "650",
    "currency": "EUR",
    "country": "DE",
    "locale": "de-DE",
    "adults": "1",
    "children": "1"
  }
]

```

Prerequisites
-------------

[](#prerequisites)

Create your account at Skyscanner to get your API access. Don't worry, it's for free! [http://en.business.skyscanner.net/](http://en.business.skyscanner.net/en-gb/products/travel-apis/)

To receive notifications by Slack you'll have to create one account here:

If you also want to receive e-mails create a free account at

Install with docker
-------------------

[](#install-with-docker)

Rename the `src/Resources/parameters.yml.dist` to `src/Resources/parameters.yml` and update the content with the data from the previous step.

Rename the `docker/volume/watch.json.dist` to `docker/volume/watch.json` and fill with your next trips!

```
$ git clone https://github.com/jeancsil/flight-spy.git
$ docker-compose up -d

```

Create your elasticsearch index to hold your history data
---------------------------------------------------------

[](#create-your-elasticsearch-index-to-hold-your-history-data)

```
PUT /flightspy
{
  "settings": {
    "number_of_replicas": 0,
    "number_of_shards": 1
  },
  "mappings": {
    "history": {
      "properties": {
        "Creation": {
          "type": "date"
        },
        "SessionKey": {
          "type": "keyword"
        }
    .......
    HERE GOES THE CONTENT OF THIS FILE:
    https://github.com/jeancsil/flight-spy/blob/master/src/Resources/elasticsearch/mappings.json
  }
}

```

Configure kibana index pattern
------------------------------

[](#configure-kibana-index-pattern)

Browse to this url:

In the first screen, kibana will ask you to create the index pattern to show you some data.

You can fill your index name: flightspy or flightstpy\*

Visualize your watched prices with Kibana
-----------------------------------------

[](#visualize-your-watched-prices-with-kibana)

[![alt text](https://raw.githubusercontent.com/jeancsil/flight-spy/master/src/Resources/KibanaDashboard.png "Kibana Dashboard")](https://raw.githubusercontent.com/jeancsil/flight-spy/master/src/Resources/KibanaDashboard.png)

Import the `src/Resources/kibana/Dashboard.json` file into your kibana dashboards panel:

Documentation
-------------

[](#documentation)

FlightSpy will look for the best deals for you every 15 minutes and will let you know by e-mail/Slack if there is a good price for you next trip!

Support
-------

[](#support)

For general support and questions, find me on Twitter as [@jeancsil](http://twitter.com./jeancsil).

Bugs and suggestions: [open a ticket](https://github.com/jeancsil/flight-spy/issues).

License
-------

[](#license)

This package is available under the [MIT license](LICENSE).

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 99.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Recently: every ~30 days

Total

13

Last Release

3444d ago

PHP version history (2 changes)1.1.0PHP &gt;= 5.5

1.5.0PHP ^5.6.6|^7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/514690?v=4)[Jean Silva](/maintainers/jeancsil)[@jeancsil](https://github.com/jeancsil)

---

Top Contributors

[![jeancsil](https://avatars.githubusercontent.com/u/514690?v=4)](https://github.com/jeancsil "jeancsil (180 commits)")[![tiagorbf](https://avatars.githubusercontent.com/u/14176376?v=4)](https://github.com/tiagorbf "tiagorbf (1 commits)")

---

Tags

dealsflightsskyscanner-apitravelflightsskyscannerTrip

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/jeancsil-flight-spy/health.svg)

```
[![Health](https://phpackages.com/badges/jeancsil-flight-spy/health.svg)](https://phpackages.com/packages/jeancsil-flight-spy)
```

###  Alternatives

[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9317.2k55](/packages/open-dxp-opendxp)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M521](/packages/shopware-core)[concrete5/core

Concrete – an open source content management system.

20163.8k49](/packages/concrete5-core)[aeliot/todo-registrar

Register TODOs from source code in issue tracker

153.0k](/packages/aeliot-todo-registrar)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1615.6k12](/packages/2lenet-crudit-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
