docs
Endpoints
Examples

Examples

Base URL:

https://igboapi.com/api/v1/

Get Multiple Examples
GET /examples

Get examples from dictionary

Request Headers

NameDescriptionExample
X-API-Key requiredSecret API tokenX-API-Key=API_token

Parameters

NameDescriptionExample
keyword requiredKeyword for querying wordskeyword=ego
styleStyle for requested example sentences`style=no_style
pagePage for resultspage=1
rangePage for result using [x,y] syntax, max range includes 25 documentsrange=[0, 24]

Responses

An array of up to 10 example JSON objects.

[
 {
   "igbo": "Agụ nà-àtakwo mangō ācharọ acha",
   "english": "Agụ is eating unripe mango",
   "associatedWords": [],
   "pronunciation": "https://igbo-api.s3.us-east-2.amazonaws.com/audio-pronunciations/620c4c01ebaecf171e074c89.webm",
   "meaning": "",
   "style": "",
 },
]

Get a Single Example
GET /examples/{exampleId}

Returns a single example JSON object from the database

exampleId is the Id of the example document you are requesting.

Responses

A single example JSON object will be returned.

{
 "nsibidi": "",
 "igbo": "Agụ nà-àtakwo mangō ācharọ acha",
 "english": "Agụ is eating unripe mango",
 "associatedWords": [],
 "pronunciation": "https://igbo-api.s3.us-east-2.amazonaws.com/audio-pronunciations/620c4c01ebaecf171e074c89.webm",
 "updatedAt": "2022-05-02T06:18:09.906Z",
 "meaning": "",
 "style": "",
 "associatedDefinitionsSchemas": [],
}

Response Code

Success:

[JSON Object]

If there are more than 10 examples that match the query, you can look at the Content-Range response header to find the total number of matching examples.