Get Lists

On this Page

Snap type:

Read

Description:

This Snap obtains the lists information from Foursquare.

  • Expected upstream Snaps: No upstream Snap is expected.
  • Expected downstream Snaps: Any file formatter followed by File Writer.
  • Expected input: No input required.
  • Expected output: User information from Foursquare.
Prerequisites:

[None]

Support and limitations:Works in Ultra Task Pipelines.
Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Foursquare Accounts for information on setting up this type of account.

Views:
InputThis Snap has no input views.
OutputThis Snap has exactly one document output view.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

List ID

Required. ID for a user-created list (for example, /v2/lists/12381902N), or a followed list, or one of either USER_ID/tips (for example, /v2/lists/32/tips) or USER_ID/todos.

Category ID

Restricts the returned results to venues matching the input category ID.

Offset

The number of results to skip. Used to page through results.

LLBounds

Restricts the returned results to the input bounding box.

Limit

The number of results to return, up to 200.

Sort

Sorts the list items. Possible values are: recent — sorts the list items by the date added to the list and nearby — sorts the list items by the distance from the center of LLBounds.

Snap Execution

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Example


The example assumes that you have configured & authorized a valid Foursquare account (see Configuring Foursquare Accounts) to be used with this Snap. The following Get Lists Snap retrieves a list of tips from a Foursquare user account. In this example, the Get Lists Snap retrieves 4 results from the user's tips list under the category 'Ice Cream Shop' (ref: Foursquare Category Tree) with the Category ID, 4bf58dd8d48988d1c9941735, from a user with the user ID, 72450160:

 

After a successful validation of the above Snap, you will see a data preview that shows the following list information: 

 

Similarly, you can retrieve a user's to do lists by specifying the following:

 

Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates
4.27main12833 StableUpgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542
 
StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Stable

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
StableUpgraded with the latest SnapLogic Platform release.
4.10

snapsmrc414

 
StableUpgraded with the latest SnapLogic Platform release.
4.9

snapsmrc405

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 
StableUpgraded with the latest SnapLogic Platform release.
4.7

snapsmrc382

 
StableUpgraded with the latest SnapLogic Platform release.
4.6

rcmsf233

 
StableUpgraded with the latest SnapLogic Platform release.
4.5.1

rcmsf231

 
StableUpgraded with the latest SnapLogic Platform release.
4.5rcmsf231 Stable

Doc Enhancement: Example added to Foursquare Snap Pack.

January 2014NA

Initial release of this Snap Pack, with Get Lists, Get Tips, Recent Checkins, User Information, Venue Information, Venue Groups and Updates.