GetNameSuggestions
input: string Query, string[] Documents, enum DocumentFormat, int NumberOfResults
output: NameFacet[] NameSuggestionsResult

Takes as an input a Query, a list of Documents and their DocumentFormat : text or URL, as well as the NumberOfResults to restrict the set of name suggestions.
It is assumed that the documents match the query, e.g. were returned by a search engine.
Finds named entities in the input that can help narrow the search. A named entity can be a name of a person, company, brand, product, organization, event, but not a location.

The NameFacet object stores the term title and its score. The score is defined by the co-occurrence with the query terms offset by the total frequency. Names that do-not co-occur with the query term are not extracted.

See also Location facets extraction and Entity extraction.

Sample code in C#:

PingarAPIRequest request = new PingarAPIRequest();
request.AppID = "your app id";
request.AppKey = "your app key";
request.SearchSupport = new SearchSupportRequest();
request.SearchSupport.Query = "sample query";
request.SearchSupport.NumberOfResults = 5;
request.SearchSupport.Documents = new string[] { "document text" };
request.SearchSupport.DocumentsFormat = DocumentFormat.Text;
request.Language = Language.EN;

PingarAPIServiceSoapClient pingarAPI = new PingarAPIServiceSoapClient();
PingarAPIResponse response = pingarAPI.GetNameSuggestions(request);
if (response.Error == null)
{
    Console.WriteLine("Name Suggestions: ");
    foreach (NameFacet name in response.SearchSupport.NameSuggestionsResult)
    {
        Console.WriteLine(name.Title + " (" + name.Score + ")");
    }
}