Linguatools Sentence Generating API Documentation

An API for generating English sentences for a given input.

Learn more about this API

GETrealise

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.

Header Parameters

X-RapidAPI-HostSTRING

REQUIRED

X-RapidAPI-KeySTRING

REQUIRED

Required Parameters

objectSTRING

REQUIREDany noun or pronoun. If the object is a pronoun set objdet=- and use the base form of the pronoun (e.g. she instead of her). Possible base forms are: I, you, he, she, it, we, they. This will be automatically replaced by me, you, him, her, it, us, them. Set objnum=plural to get the plural forms (e. g. object=he and objdet=- and objnum=plural yields them).

subjectSTRING

REQUIREDany noun, any pronoun

verbSTRING

REQUIREDany verb, including phrasal verbs like „start out“

Optional Parameters

objdetSTRING

OPTIONALSpecifies the object’s determiner (a, the, –). Default is „a“. Use objdet=- to generate an object without determiner.

objnumSTRING

OPTIONALSpecifies the object’s number (singular, plural). Default is singular. A value of plural is overridden by objdet=a.

passiveSTRING

OPTIONAL&passive=passive generates a sentence in passive voice. The object is set as subject and the subject becomes the by-object.

progressiveSTRING

OPTIONAL&progressive=progressive sets the progressive (continuous) tense

modalSTRING

OPTIONALSpecifies a modal verb modifying the verb (can, may, must, ought, shall, should, would). Only allowed for present tense. If tense=past or tense=future is set then the parameter modal will be ignored.

subjdetSTRING

OPTIONALSpecifies the subject’s number (a, the, –). Default is „the“. Use subjdet=- to generate a subject without determiner.

perfectSTRING

OPTIONAL&perfect=perfect sets the perfect tense

subjnumSTRING

OPTIONALSpecifies the subject’s number (singular, plural). A value of plural is overridden by subjdet=a.

objmodSTRING

OPTIONALSpecifies an adjective modifying the object: any adjective

sentencetypeSTRING

OPTIONALSpecifies the sentence type (yesno, whatobj, whosubj). 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

negatedSTRING

OPTIONAL&negated=negated generates a negated sentence

tenseSTRING

OPTIONALSpecifies the verb’s tense (present, past, future). Default is „present“