Sentence Generating API


An API for generating English sentences for a given input.

How to use Linguatools Sentence Generating API

The API can realise simple sentences given a subject, a verb and an object. Optional additional parameters allow to specify features like tense, number, voice, sentence type. The following table shows example request parameters and their outputs.

request parametersgenerated sentence
subject=police&verb=arrest&object=thiefThe police arrests a thief.
subject=police&verb=arrest&object=thief&tense=pastThe police arrested a thief.
subject=police&verb=arrest&object=thief&tense=past&passive=passiveA thief was arrested by the police.
subject=police&verb=arrest&object=thief&objmod=suspected&perfect=perfect&objnum=plural&objdet=theThe police has arrested the suspected thieves.
subject=police&verb=arrest&object=thief&objmod=suspected&perfect=perfect&objnum=plural&objdet=the&sentencetype=yesnoHas the police arrested the suspected thieves?

Connect to API


For testing, the following endpoint can be used with HTTP method GET:

Query parameters

parameterdescriptionparameter value
subjectrequiredany noun, any pronoun
specifies the subject’s determiner. Default is „the“. Use subjdet=- to generate a subject without determiner.
a, the, –
specifies the subject’s number. Default is singular. A value of plural is overridden by subjdet=a.
singular, plural
verbrequiredany verb, including phrasal verbs like „start out“
objectrequiredany noun or pronoun
specifies the object’s determiner. Default is „a“. Use objdet=- to generate an object without determiner.
a, the, –
specifies the object’s number. Default is singular. A value of plural is overridden by objdet=a.
singular, plural
specifies an adjective modifying the object
any adjective
specifies the verb’s tense. Default is „present“
present, past, future
&progressive=progressive sets the progressive (continuous) tense
&perfect=perfect sets the perfect tense
&negated=negated generates a negated sentence
&passive=passive generates a sentence in passive voice. The object is set as subject and the subject becomes the by-object.
specifies a modal verb modifying the verb. Only allowed for present tense. If tense=past or tense=future is set then the parameter modal will be ignored.
can, may, must, ought, shall, should, would
specifies the sentence type. Default is a declarative sentence. &sentencetype=yesno generates a yes/no-question, whatobj generates a WH-question for the object, whosubj generates a WH-question for the subject
yesno, whatobj, whosubj


If successful, the response body contains a JSON object with the generated sentence:

If there was an error the response status is 400 and the response body contains a JSON object with an error message:

Licensing conditions

The API/data package can be used in any number of private and commercial projects of the purchaser:
E. g. in a website application, in a smartphone app etc.

Redistribution is not allowed.

If you want to use the API/data package in your project please contact
The prices for the API start at 9 € (incl. Vat) per month (max. 1 query per second)