Sentence Generating API

Overview

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 parameters generated sentence
subject=police&verb=arrest&object=thief The police arrests a thief.
subject=police&verb=arrest&object=thief&tense=past The police arrested a thief.
subject=police&verb=arrest&object=thief&tense=past&passive=passive A thief was arrested by the police.
subject=police&verb=arrest&object=thief&objmod=suspected&perfect=perfect&objnum=plural&objdet=the The police has arrested the suspected thieves.
subject=police&verb=arrest&object=thief&objmod=suspected&perfect=perfect&objnum=plural&objdet=the&sentencetype=yesno Has the police arrested the suspected thieves?

Connect to API

Endpoint

You can test the Sentence Generating API and develop your own application – for free – after sign up in RapidAPI

Link to API on RapidApi: https://rapidapi.com/petapro/api/linguatools-sentence-generating

http request & code snippets

RapidAPI provides programming examples for many programming languages like Node.js, Ruby, Java, JavaScript, Python etc. how to use the API.

 

Query parameters

parameter description parameter value
subject required any noun, any pronoun
subjdet optional
specifies the subject’s determiner. Default is „the“. Use subjdet=- to generate a subject without determiner.
a, the, –
subjnum optional
specifies the subject’s number. Default is singular. A value of plural is overridden by subjdet=a.
singular, plural
verb required any verb, including phrasal verbs like „start out“
object required
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).
any noun or pronoun
objdet optional
specifies the object’s determiner. Default is „a“. Use objdet=- to generate an object without determiner.
a, the, –
objnum optional
specifies the object’s number. Default is singular. A value of plural is overridden by objdet=a.
singular, plural
objmod optional
specifies an adjective modifying the object
any adjective
tense optional
specifies the verb’s tense. Default is „present“
present, past, future
progressive optional
&progressive=progressive sets the progressive (continuous) tense
progressive
perfect optional
&perfect=perfect sets the perfect tense
perfect
negated optional
&negated=negated generates a negated sentence
negated
passive optional
&passive=passive generates a sentence in passive voice. The object is set as subject and the subject becomes the by-object.
passive
modal optional
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
sentencetype optional
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

 

Response

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:

Terms of Use

Link: Terms of Use

Pricing

The „BASIC“ plan on RapidAPI with 1.000 requests/month is free.

 

Demo

The sentence generator https://gramomat.com/ is based on the Sentence Generating API.