Foursquare

 Foursquare  is a venue reviews, recommendations, and lists silo based on its previous location-based checkin support, a feature that was spunout to the separate Swarm application which still shares some data back & forth with Foursquare.

Features

 * review posts (known as "Tips")
 * lists of venues, either as recommendations or reminders
 * venue search, ratings, and recommendations

Feature details:

Lists
Foursquare supports creating and sharing lists of venues. By default, Foursquare starts you off with a "to-do" list. It is possible to create lists with any name, so there are many examples of lists of favorite places, collecting places to visit in another city, or lists of places that have something in common.


 * "Must-visit bars in Portland"
 * "Bars to work from in the Kerns neighborhood"
 * Berlin

Past Features
Note: most past Foursquare were included in the spin-off app Swarm. These details pertain the features available in Foursquare until they were removed.

Checkins

 * Checkins can optionally contain photos or notes.
 * Up to four photos and notes (as comments) can also be added to existing checkins.
 * Only the author of the checkin may add photos, but any of their friends may add comments.
 * Foursquare provides a web hook that can run every time a user checks in.

Nearby Notifications
Foursquare would notify you (opt-out) when some number of friends were at a venue near you, e.g.:

With notification text: "Stop by Internet Archive? Looks like 3 of your friends are there right now!"

Limitations

 * Checkin notes have a length limitation of 200 characters.
 * Only up to four photos can be added to a checkin

How To Export
Foursquare has feed files (e.g. .ics) and an API that can be used for export.

Feeds
Foursquare used to provide feed files of all your checkins in multiple formats: RSS, KML, and ICS.
 * https://foursquare.com/feeds/ when logged in will show customized feed URLs that use special tokens for access (do not share them)
 * These feed links do not appear to work anymore as of 2022-07-14. They return a "404 not found" error for.
 * Foursquare states: "Please note: The Check-in Feeds functionality has existed for a while now, and we've gone through lots of changes over the years. These unique URLs may or may not still work for you and, unfortunately, we no longer provide support for this feature. YMMV!" 2022-07-14

Data export
Under Settings → Privacy Settings, Foursquare has a button to "Export My Data". This used to send an email when an archive was available for your account that included all of your check-in history as JSON. The email appears to never be sent now, as of 2022-07-14.

API

 * 1) Set up a Foursquare Developer account at https://developer.foursquare.com/
 * 2) Write your own script or use an existing one to extract all of your Foursquare data to your local file system.
 * 3) * foursquare-to-file.js by
 * 4) ** The script works by connecting to Foursquare, counting how many checkins you have to determine the total number of pages of data it needs to download, and then it makes periodic calls to the Foursquare API to download the files to your local machine or server, staying within the Foursquare rate limits.
 * 5) * Swarm-Checkins-Import by
 * 6) Convert your Foursquare API JSON files into h-entry files by writing a second script to construct meaningful HTML representations of the checkins.
 * 7) * The script mko wrote will handle most of the conversion from a Foursquare JSON object to a h-entry JSON object. Since he uses Indie.js, the script has a decent amount of data relevant only to his purposes at this time, but it would not be difficult to convert the script into a generic converter if needed.
 * 8) * this script by aaronpk makes Micropub requests to publish your past checkins to your website

Examples:
 * has exported all his Foursquare checkins, and has also "imported all of my posted photos, likes, and comments, though the likes and comments haven't been converted into IndieWeb mentions yet."
 * exported all his checkins from before OwnYourSwarm had been automatically importing them since 2016
 * has exported most of his checkins using OwnYourSwarm and Micro.blog's import feature to his blog https://manton.coffee/.

Ben Werdmuller
has been POSSEing his checkins using idno (now Known) on werd.io to Foursquare since 2013(??). Examples:
 * ... first check-in on werd.io that POSSEd to Foursquare?

Michael Owens
has been POSSEing his checkins to Foursquare since 2014-??-??. "If I check in via my site, it'll check me in via Foursquare and ignore the push response for the checkin (so I don't get duplicate checkins)."

Michael also supports PESOS from Foursquare: "I've got a push endpoint on my site, so anytime I check-in on Foursquare through the app, it'll check me in via my site as well."

Aaron Parecki
has been POSSEing his Foursquare tips since 2019-10-06.

https://aaronparecki.com/2019/10/06/20/foursquare

This works in likely a somewhat controversial way. There are multiple ways to syndicate a tip to Foursquare:


 * I can reply to one of my checkins, and the text of the reply is added as a tip
 * I can reply to a Foursquare venue URL directly
 * I can send the text of a checkin itself as a tip

Manton Reece
has a separate site at https://manton.coffee/ for Foursquare/Swarm check-ins. It is hosted on Micro.blog with a custom theme to show a map for each post. Manton imports check-ins either from Foursquare's export or via Micro.blog's Micropub API with OwnYourSwarm.

PESOS
While not as good as POSSE, those who can support micropub can use OwnYourCheckin or OwnYourSwarm to PESOS their Foursquare posts (with photos) to their website.

Event support
Foursquare does some amount of tracking of what events are happening at venues in their venue database.

Thus part of their UI provides the user of optionally also checking into a specific event at a venue, e.g. a particular showing of a movie at a movie theater, or a concert at a music hall.

The result is that others seeing your checkin see that you also checked in at a specific event at the venue, e.g.:



API
Foursquare has an API and if you use venue information from it, you must provide attribution/linking.
 * https://developer.foursquare.com/overview/attribution

See also analysis of the Foursquare API by Social Web WG:
 * https://www.w3.org/wiki/Socialwg/Social_API/Foursquare_API

Venue claiming
Foursquare provides the ability for someone officially associated with a venue to "claim" that venue which then gives that person more authority over the venue, including the ability to associate events with the venue (as documented above)

See also:
 * http://www.slideshare.net/OkimoClinic/how-to-create-an-event-on-foursquare

In short:
 * someone from the venue has to go to https://foursquare.com/venue/claim
 * and claim it as a venue they manage
 * they make you give a phone number to "receive a call to verify your claim". The call asks you to record a sentence stating your name and relationship to the venue. The call appears to not be manually screened, but presumably is archived.
 * they'll either mail you a postcard, or you can pay $1-20 (depending on city) with a credit card to "verify" it

Launch
Foursquare was launched 2009-03-06 at the SXSW conference and festival where it quickly gained adoption.

Foursquare Badges
From launch until the Swarm split, Foursquare had badges you could earn all sorts of different way, some with levels of expertise (from 2x to 10x), some only available for brief periods of time (a particular day), some of which only at very specific venues.

Your old Foursquare Badges are accessible as an Easter Egg inside the Swarm app in "Memory Lane":



(These are likely only a subset of the many badges that were available; uploaded by undefined)

Split
On/Around 2014-05-01 Foursquare split much of its checkin functionality off into Swarm to focus more on locations, forseeably in an effort to better compete with Yelp. Checkins via the Swarm app created their own data, while much of it was also mirrored within the Foursquare site.

Prior Efforts
Before Foursquare, there was Dodgeball, which also offered a similar check-in service, and was co-founded by one of the same people that started Foursquare.

Criticism

 * "Digital platforms like Foursquare are producing "a harmonization of tastes.""

Downtime
Foursquare only occasionally suffers from outages. E.g.


 * 2012-06-29 (all day)?)  "Looks like there was an error connecting to #foursquare. Try developing an #indieweb solution instead."
 * Which inspired: http://opensourcebridge.org/wiki/2012/Foursquare_is_down!

Privacy

 * CEO Jeff Glueck discusses privacy on the Foursquare platform