Sentence Recognition will match up one phrase against a range of other phrases based off of the meaning behind the phrases. It makes natural language processing easy!

All inputs are sent through a REST interface using GET.

The API address is: http://www.sentencerecognition.com/sentencerecognition.php

You must send a phrase with the name "input". This is the phrase that you are comparing against the others.

You can send up to 10 phrases to compare the input against. These phrases should be sent with the name "sentence#", where # is a number between 1 and 10. Always start with 1 and increase the number incrementally. For example a valid series of phrases would have the names "sentence1", "sentence2", "sentence3".

The results are returned in XML format. The results indicate which of the phrases best matches the input The results show a score (ranging from 0 to 100) describing how well they match. The results also show the time that the API took to run. Additionally, the results show all of the "sentence#" phrases and the score for each. The item "matching_prompt" is the best match.

Register at SentenceRecognition.com for an API key to compare and input against up to 50 phrases.


This is an example of an API call:

http://www.sentencerecognition.com/sentencerecognition.php?input=this+is+the+input+string&sentence1=sentence+recognition+is+a+powerful+tool&sentence2=combine+it+with+speech+to+text+for+interesting+results&sentence3=this+is+the+best+string+to+match


These are the parts of the API call broken out:

http://www.sentencerecognition.com/sentencerecognition.php? input=this+is+the+input+string &sentence1=sentence+recognition+is+a+powerful+tool &sentence2=combine+it+with+speech+to+text+for+interesting+results &sentence3=this+is+the+best+string+to+match


These are the results that the API returns with those inputs:

<results> <input>this is the input string</input> <number_of_prompts>3</number_of_prompts> <prompts> <prompt> <prompt_number>0</prompt_number> <prompt_text>sentence recognition is a powerful tool</prompt_text> <prompt_score>27</prompt_score> </prompt> <prompt> <prompt_number>1</prompt_number> <prompt_text>combine it with speech to text for interesting results</prompt_text> <prompt_score>0</prompt_score> </prompt> <prompt> <prompt_number>2</prompt_number> <prompt_text>this is the best string to match</prompt_text> <prompt_score>80</prompt_score> </prompt> </prompts> <matching_prompt>this is the best string to match</matching_prompt> <matching_prompt_score>80</matching_prompt_score> <start_time>1373260591</start_time> <end_time>1373260592</end_time> <time_elapsed>1</time_elapsed> </results>


Here are descriptions of the items in the results XML:

matching_prompt = This is the Sentence whose meaning is closest to the Input.

matching_prompt_score = This is a score from 0 to 100 which tells you how well the matching_prompt describes the Input.

input = This is the Input received through the REST interface.

number_of_prompts = This is how many Sentences were received through the REST interface.

prompt = This shows the Sentences received through REST.

prompt_number = This is a numeric counter for the Sentences received.

prompt_text = This is the text of a Sentence received through REST.

prompt_score = This is the a score from 0 to 100 which tells you how well that specific Sentence matched the Input.

time_elapsed = This tells you how long the API took to process your query.

Last 7 days, UTC

Average Latency
358ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

070313

HTTP 200 : string GET/sentencerecognition.php
Sentence Recognition XML Response

This is the format for communicating with the SentenceRecognition API


Test console
Description
Parameter
string

This is the string that you want to compare against a range of possibilities.
Example: this is the input string

input

Required

string

This is the first possible option that could mean the same thing as the input.
Example: sentence recognition is a powerful tool

sentence1

Required

string

This is the second possible option that could mean the same thing as the input.
Example: combine it with speech to text for interesting results

sentence2

Required

string

This is the third possible option that could mean the same thing as the input.
Example: this is the best string to match

sentence3

Optional

string

This is the fourth possible option that could mean the same thing as the input.
Example: these strings are optional

sentence4

Optional

string

This is the fifth possible option that could mean the same thing as the input.
Example: always start with sentence one

sentence5

Optional

string

This is the sixth possible option that could mean the same thing as the input.
Example: check the website for code examples

sentence6

Optional

string

This is the seventh possible option that could mean the same thing as the input.
Example: contact us with questions

sentence7

Optional

string

This is the eighth possible option that could mean the same thing as the input.
Example: or any potential issues

sentence8

Optional

string

This is the ninth possible option that could mean the same thing as the input.
Example: feedback from you helps us

sentence9

Optional

string

This is the tenth possible option that could mean the same thing as the input.
Example: be sure to include examples

sentence10

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using Sentence Recognition API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.