Welcome to the Hunch Developer Homepage

Basics

Hunch provides personalized recommendations tailored specifically for you. Hunch can determine the affinity between any user and any item based on a user’s tastes, preferences, and interests. Through our API you can create custom Hunch-powered applications.

As an example, let's recommend some magazines to Oprah. The following API call returns the top 3 magazine (topic list_magazine) recommendations based on her Twitter taste profile:

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

The resulting JSON (abridged for clarity) looks like:


{     ok: true
      is_personalized: true
      recommendations: [

            {
                score: 1.0566 
                name: "The New Yorker"
                url: http://www.amazon.com/gp/product/B001U5SPJW/
            },

            {
                score: 0.9281 
                name: "Vanity Fair"
                url: http://www.amazon.com/gp/product/B001U5SPL0/
            },

            {
                score: 0.8918 
                name: "Cosmopolitan"
                url: http://www.amazon.com/gp/product/B001THPA12/
            }
      ]
}

Personalize your application today

Register your application:

Getting Started

1. Concepts

Background information about using the Hunch API:

2. Reference

Explore the details of the Hunch API methods:

3. Resources

Find tools and best practices for using the Hunch API: