Knowledge - Feature - Association Suggest

Owned by Caleb Burch (Unlicensed)
Last updated: Mar 07, 2012Version comment
/knowledge/feature/assocSuggest/{entity1}/{verb}/{entity2}/{searchfield}/{communityids}

Returns a list of entity-association suggestions based the sentence/query fragment passed in (eg what the user has typed so far into a query box). Only the specified term (subject/object/verb) from the matching associations is returned, ordered by document count across the specified communities.

Authentication

Required, see Auth - Login

Arguments

entity1 (required)
The first term (subject) of the event you are searching for, send "null" to match on all subject entities

verb (required)
The 2nd term (verb) of the event you are searching for, send "null" to match on all possible verbs

entity2 (required)
The 3rd term (object) of the event you are searching for, send "null" to match on all object entities

searchfield (required)
The field that you want to get suggestions for, can be "entity1", "verb", or "entity2". Note that currently only "indexed" entities (eg "disambiguated_name/type") are returned, and only the verb categories corresponding to verbs.

communityids (required)
A comma deliminated list of community IDs or community ID - regex in the URL controls which sources the query will use. Obviously the logged-in user must have access rights to those communities. A user's communities can be viewed using the "person/get" API call.

Example

http://infinite.ikanow.com/api/knowledge/feature/assocSuggest/obam/null/null/entity1/4c927585d591d31d7b37097a
http://infinite.ikanow.com/api/knowledge/feature/assocSuggest/obama/travel/null/entity1/4c927585d591d31d7b37097a
http://infinite.ikanow.com/api/knowledge/feature/assocSuggest/obam/traveled/can/entity1/4c927585d591d31d7b37097a
http://infinite.ikanow.com/api/knowledge/feature/assocSuggest/obam/traveled/can/entity1/4c927585d591d31d7b37097a,4c927585d561d31e7b37096b

Example Response
{
    "response": {
        "action": "Association Suggestions",
        "success": true,
        "message": "obam",
        "time": 0
    },
    "data": [
        "mike del checcolo/person",
        "center on budget and policy priorities/organization",
        "trent gavazzi/person",
        "obama/person",
        "john nase/person",
        "mehmet oz/person",
        "michelle obama/person",
        "lopez howell/person",
        "dave booze/person",
        "earl perkins/person",
        "mark blyth/person",
        "kathleen o'loughlin/person",
        "larry lanzillotta/person",
        "barack obama/person",
        "obama administration/organization"
    ]
}