The project is in a healthy, maintained state
Foursquare connectors
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.63
~> 2.3
~> 3.10
~> 13.0

Runtime

 Project Readme

Chronicle::Foursquare

Gem Version

Extract your Foursquare/Swarm history using the command line with this plugin for chronicle-etl.

Usage

1. Install Chronicle-ETL and this plugin

# Install chronicle-etl and this plugin
$ gem install chronicle-etl
$ chronicle-etl plugins:install foursquare

2. Create a Foursquare App

To get access to the Foursquare API, you must first create an app. Press the "Create New Project" button in the Developer Home.

In the app's setting, in the Redirect URIs field, add http://localhost:4567/auth/foursquare/callback. After your app has been saved, grab the client_id and client_secret credentials and save them to chronicle-etl secrets:

$ chronicle-etl secrets:set foursquare client_id
$ chronicle-etl secrets:set foursquare client_secret

3. Authorize Foursquare

Next, we need an access token for accessing your data. We can use the authorization flow:

$ chronicle-etl authorizations:foursquare

This will open a browser window to authorize on foursquare.com. When the flow is complete, access/refresh tokens will be saved in the chronicle secret system under the "foursquare" namespace. It'll be available automatically whenever you use this plugin.

4. Use the the plugin

# Extract recent checkins
$ chronicle-etl --extractor foursquare --since 1w

# Transform as Chronicle Schema
$ chronicle-etl --extractor foursquare --since 1w --schema chronicle

# Get a table of dates and place name
$ chronicle-etl --extractor foursquare --since 1w --schema chronicle --fields end_time object.name --loader table

Available Connectors

Extractors

checkin

Extractor for your Foursquare (via the Swarm app) checkins

Settings
  • access_token: (required) API access token for foursquare. By default, it's loaded from secrets under the foursquare namespace. You can check if it's available with chronicle-etl secrets:list foursquare