Knowledge - Feature - Entity Suggest

/knowledge/feature/entitySuggest/{fragment}/{comma-separated-list-of-community-ids}?geo=[true|1|false|0]&linkdata=[true|1|false|0]

Returns a list of entity suggestions based the sentence/query fragment passed in (eg what the user has typed so far into a query box).

Authentication

Required, see Auth - Login

Arguments

fragment (required)
One or more words (the last word can also be a fragment), which are "fuzzily" compared against known entities stored in Community Edition.

community ID list (required)
The 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.

geo (optional)
By default, where ("Where") entities have lat/longs associated with them, they are returned by this REST call. Specify this parameter as "false" or "0" to discard them.

linkdata (optional)
If specified as "true" or "1", then any "linkdata" fields for the entity (ie references to Web services that form part of the Linked Open Data Project) are returned. By default they are not.

Example

http://infinite.ikanow.com/api/knowledge/feature/entitySuggest/obam/4c927585d591d31d7b37097a
http://infinite.ikanow.com/api/knowledge/feature/entitySuggest/c/4c927585d591d31d7b37097a?geo=true&linkdata=true
http://infinite.ikanow.com/api/knowledge/feature/entitySuggest/hillary cli/4c927585d591d31d7b37097a,4c927585d561d31e7b37096b

Example Response

{
    "response": {
        "action": "Suggestions",
        "success": true,
        "message": "c",
        "time": 0
    },
    "data": {
        "dimensions": [
            {
                "dimension": "Where",
                "value": "New York City,New York,United States",
                "type": "City",
                "geotag": {
                    "lat": 40.7142,
                    "lon": -74.0064
                },
                "ontology_type": "city",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/city/ralg-geo1/b3719a18-c511-51a8-b3f9-f8480b3b6e48"
                ]
            },
            {
                "dimension": "Where",
                "value": "California,United States",
                "type": "ProvinceOrState",
                "geotag": {
                    "lat": 36.4885198674,
                    "lon": -119.701379437
                },
                "ontology_type": "countrysubsidiary",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/provinceorstate/ralg-geo1/fd9e1e90-96a9-04ff-1397-445c4e93208b"
                ]
            },
            {
                "dimension": "Who",
                "value": "CEO",
                "type": "Position"
            },
            {
                "dimension": "What",
                "value": "cancer",
                "type": "MedicalCondition"
            },
            {
                "dimension": "Where",
                "value": "China",
                "type": "Country",
                "geotag": {
                    "lat": 32.9042932784,
                    "lon": 110.467708512
                },
                "ontology_type": "country",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/country/ralg-geo1/8a7d7ba2-88ca-0f0e-a1ec-f975b026e8e1"
                ]
            },
            {
                "dimension": "Where",
                "value": "Canada",
                "type": "Country",
                "geotag": {
                    "lat": 56.757746527,
                    "lon": -86.4195625771
                },
                "ontology_type": "country",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/country/ralg-geo1/c2aadac2-ca30-ca8a-adfb-e331ae180d28"
                ]
            },
            {
                "dimension": "Who",
                "value": "Securities and Exchange Commission",
                "type": "Organization"
            },
            {
                "dimension": "Where",
                "value": "Los Angeles,California,United States",
                "type": "City",
                "geotag": {
                    "lat": 34.0522,
                    "lon": -118.2428
                },
                "ontology_type": "city",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/city/ralg-geo1/9c147196-160d-8555-537a-06b783fe54af"
                ]
            },
            {
                "dimension": "Where",
                "value": "San Francisco,California,United States",
                "type": "City",
                "geotag": {
                    "lat": 37.775,
                    "lon": -122.4183
                },
                "ontology_type": "city",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/city/ralg-geo1/f56118da-0256-d097-ff73-1f5d0938031b"
                ]
            },
            {
                "dimension": "Who",
                "value": "Congress",
                "type": "Organization"
            },
            {
                "dimension": "What",
                "value": "Jude Children?s Research Hospital",
                "type": "Facility"
            },
            {
                "dimension": "Where",
                "value": "Chicago,Illinois,United States",
                "type": "City",
                "geotag": {
                    "lat": 41.85,
                    "lon": -87.65
                },
                "ontology_type": "city",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/city/ralg-geo1/b0dfbe09-9b57-0fa7-e789-ccfc8a6f650a"
                ]
            },
            {
                "dimension": "Who",
                "value": "president and CEO",
                "type": "Position"
            },
            {
                "dimension": "Who",
                "value": "Microsoft Corporation",
                "type": "Company",
                "linkdata": [
                    "http://d.opencalais.com/er/company/ralg-tr1r/4ee13d20-b44f-3bce-98bc-49a303e72db5"
                ]
            },
            {
                "dimension": "Who",
                "value": "St. Jude Children?s Research Hospital",
                "type": "Organization"
            },
            {
                "dimension": "Who",
                "value": "Chairman",
                "type": "Position"
            },
            {
                "dimension": "Where",
                "value": "North Carolina,United States",
                "type": "ProvinceOrState",
                "geotag": {
                    "lat": 35.4833648675,
                    "lon": -79.4002284439
                },
                "ontology_type": "countrysubsidiary",
                "linkdata": [
                    "http://d.opencalais.com/er/geo/provinceorstate/ralg-geo1/56e11c06-6ad9-7041-8d6e-70a5eff06454"
                ]
            },
            {
                "dimension": "What",
                "value": "childhood cancer",
                "type": "MedicalCondition"
            },
            {
                "dimension": "Who",
                "value": "Apple Inc.",
                "type": "Company",
                "linkdata": [
                    "http://d.opencalais.com/er/company/ralg-tr1r/23d07771-c50b-315b-8050-3cdaf47ac0d0"
                ]
            },
            {
                "dimension": "Who",
                "value": "National Cancer Institute-designated Comprehensive Cancer Center",
                "type": "Organization"
            }
        ]
    }
}