Knowledge - Feature - Association Suggest
/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" ] }