API Overview

Concepts

Hunch personalizes the internet by learning about your tastes. The Hunch API provides access to this personalization through result recommendations as well as predictions about users. Results and users come from the user-generated hunch.com website, web crawls, and partner applications. Every result and user has a unique id.

The Taste Graph

The Hunch Taste Graph maps people to what they like, connecting every person on the web with their affinity for every entity (camera, car, movie star, anything!). Using the Taste Graph, Hunch is able to make highly accurate predictions and recommendations for users.

Test-driving the API

• You can make test API calls in your browser using the API console.

• You can make test API calls in your browser or in an app using the auth_basic parameter, which enables HTTP basic authentication.

  For example, click the link below to see the top 10 movie recommendations for your Hunch account. (list_movie is the Movies topic, from the list of API topics.) Since this call uses HTTP basic authentication, your browser will prompt you for your Hunch username and password:

  http://api.hunch.com/api/v1/get-recommendations/?topic_ids=all_544&limit=10&auth_basic=1

  You may want to use a plugin like JSONView to make viewing JSON in a browser easier on your eyes.

• You can make test API calls with OAuth in your browser or in an app using your personal auth_token for hunch.com. Be advised: anyone with this auth_token can edit and view your information.

  To see your token, you first need to sign in.