Flutter Dictionary API

A Flutter package that provides a simple and easy-to-use interface for the Free Dictionary API.

Features

• Get complete word data including definitions, pronunciation, and etymology
• Check if a word exists in the dictionary
• Get specific information about a word:
  • Definitions
  • Parts of speech
  • Pronunciation (text and audio URL)
  • Origin/etymology
  • Usage examples
  • Synonyms
  • Antonyms

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  dictionary_api: ^0.1.0

Usage

import 'package:dictionary_api/dictionary_api.dart';

// Get complete word data
final wordData = await DictionaryApi.getWordData('example');

// Check if a word exists
final exists = await DictionaryApi.wordExists('example');

// Get definitions
final definitions = await DictionaryApi.getDefinitions('example');

// Get parts of speech
final partsOfSpeech = await DictionaryApi.getPartsOfSpeech('example');

// Get pronunciation
final pronunciation = await DictionaryApi.getPronunciation('example');
if (pronunciation != null) {
  print('Text: ${pronunciation.text}');
  print('Audio URL: ${pronunciation.audio}');
}

// Get origin/etymology
final origin = await DictionaryApi.getOrigin('example');

// Get usage examples
final examples = await DictionaryApi.getExamples('example');

// Get synonyms
final synonyms = await DictionaryApi.getSynonyms('example');

// Get antonyms
final antonyms = await DictionaryApi.getAntonyms('example');

API Details

getWordData(String word)

Returns complete WordData for a word or null if not found.

wordExists(String word)

Returns true if the word exists in the dictionary, false otherwise.

getDefinitions(String word)

Returns a list of all definitions for the word.

getPartsOfSpeech(String word)

Returns a list of parts of speech for the word (e.g., "noun", "verb").

getPronunciation(String word)

Returns a Pronunciation object with phonetic text and audio URL.

getOrigin(String word)

Returns the word's origin/etymology or null if not available.

getExamples(String word)

Returns a list of example sentences using the word.

getSynonyms(String word)

Returns a list of synonyms for the word.

getAntonyms(String word)

Returns a list of antonyms for the word.

Data Models

The package includes several data models:

• WordData: Complete data for a word
• Meaning: A specific meaning of a word
• Definition: A definition within a meaning
• Phonetic: Pronunciation information
• Pronunciation: Simplified pronunciation data with text and audio

Dependencies

• http: For making API requests
• dart:convert: For JSON parsing

Credits

This package uses the free Dictionary API service.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.