Happn.in API

Gives developers the opportunity to access current Happn.in trend lists.

http://api.happn.in/cities

Returns a list of cities for which Happn.in lists are available.

Each city contains the following elements:

• slug: Shortened name of city (unique identifier).
• username: Happn.in's Twitter account name for this city.
• city: Full city name.
• state: State (only for US cities).
• country: Country.
• lat: Latitude.
• lon: Longitude.

Sample output for /cities

[
    {
        "city": "Amsterdam",
        "state": "",
        "country": "Netherlands",
        "username": "happn_in_amst",
        "lat": 52.375548,
        "slug": "amsterdam",
        "lon": 4.892578
    },
    {
        "city": "Atlanta",
        "state": "GA",
        "country": "US",
        "username": "happn_in_atl",
        "lat": 33.756886,
        "slug": "atlanta",
        "lon": -84.392166
    }
]

http://api.happn.in/{city slug}/phrases

Returns the current list of trending phrases in the city specified.

• generated_at: Date/time this list was generated (lists change hourly).
• happn_url: Happn.in URL displaying this list.
• happn_user: Happn.in Twitter username for this list.
• sponsor_txt: Sponsor's text (25 characters max).
• sponsor_url: Sponsor's url.
• phrases: List of phrases (ordered from most popular to least).
• phrase: Name of phrase.
• tweets: Tweets for this phrase (ordered from newest to oldest).
• text: Text of tweet.
• user: Twitter username that sent tweet.

Sample output for /boston/phrases

[
    {
        "generated_at": "Fri Jun 12 13:00:00 UTC 2009",
        "happn_url": "http:\/\/www.happn.in\/boston\/12jun09-09am\/",
        "happn_user": "happn_in_boston",
        "sponsor_txt": null,
        "sponsor_url": null,
        "phrases": [
            {
                "phrase": "pouring out",
                "tweets": [
                    {
                        "text": "Man now it's pouring out.  What a sucky Friday!! Where's the sun?",
                        "user": "missy510"
                    },
                    {
                        "text": "The Jonas Brothers are on Good Morning America and it's pouring out.  Perhaps an electrocution could make these two things worthwhile.",
                        "user": "JTVincent"
                    }
                ]
            },
            {
                "phrase": "american idol auditions",
                "tweets": [
                    {
                        "text": "is going to talk to SFA live from the American Idol auditions.",
                        "user": "sandboxcharlie"
                    },
                    {
                        "text": "@johncmayer kicking off Pedamundo in line at American Idol auditions in Boston. http:\/\/mypict.me\/3w37",
                        "user": "MeganRabren"
                    }
                ]
            }
        ]
    }
]