API Privacy and Permissions

Getting recommendations through the API

Hunch takes our users' privacy very seriously. When using the API, Hunch returns predictions for users within the Taste Graph. Certain API calls can be made for any user, while other calls require the user to Hunch Connect before predictions will be returned. Our guiding principle for this distinction is whether the user's likes or facts about themselves are already made public on the internet.

When using the get-recommendations call, predictions can be returned for Twitter (tw_barackobama), Facebook (fb_123), Foursquare (4sq_456), or Hunch (hn_789) users without requiring the user to Hunch Connect.

For example, to get magazine recommendations for Oprah:

http://api.hunch.com/api/v1/get-recommendations/
          ?user_id=tw_oprah
          &topic_ids=list_magazine
          &limit=3

When using the get-predictions call, predictions can be returned for any Twitter or Foursquare user, but Facebook and Hunch users must Hunch Connect into your application before predictions will be returned.

To get Oprah's gender (represented by the THAY question hn_424023):
(you will be asked to authenticate with your Hunch username and password)

http://api.hunch.com/api/v1/get-predictions/
          ?user_id=tw_19397785
          &allowed_qids=hn_424023
          &auth_basic=1