🚀 Getting Started
Quick Start Guide
Integrate Dictionary's powerful language API into your application in under 5 minutes. Follow these steps to make your first API call.
1
Create an Account & Get Your API Key
Sign up for a free account and navigate to your dashboard to generate your personal API key. This key authenticates your requests to the Dictionary API.
Go to Dashboard →2
Install the SDK (Optional)
We recommend using our official SDK for easier integration. Install it via your preferred package manager:
bash
# Using npm
npm install @dictionary/sdk
# Using yarn
yarn add @dictionary/sdk
# Using pnpm
pnpm add @dictionary/sdk3
Initialize & Make Your First Request
Initialize the client with your API key and search for a word. The SDK handles authentication, retries, and pagination automatically.
javascript
import { Dictionary } from "@dictionary/sdk";
// Initialize with your API key
const client = new Dictionary("your_api_key_here");
// Search for a word
const result = await client.words.search("ephemeral", {
language: "en",
include: ["definitions", "synonyms", "pronunciation"]
});
console.log(result.data.definitions[0].text);
// Output: "Lasting for a very short time; transitory."Never expose your API key in client-side code. Use environment variables or a backend proxy.
4
Parse & Display Results
Structure the response according to your app's needs. The API returns standardized JSON with definitions, phonetics, examples, and metadata. Check our API Reference for complete response schemas.
Frequently Asked Questions
The free tier includes 500 requests per day. If you need higher limits or enterprise support, upgrade to our Pro or Enterprise plans. Rate limits are automatically reset at 00:00 UTC.
Yes! All plans allow commercial use. The free tier is great for personal projects and prototyping, while Pro and Enterprise plans are designed for production applications with SLAs.
The SDK includes built-in retry logic with exponential backoff. You can configure max retries via `client.config.retries`. API errors return standard HTTP status codes with descriptive JSON bodies. Check our Error Handling Guide for best practices.
Absolutely. The official SDK is built natively in TypeScript and ships with complete type definitions. You get full autocomplete and validation for all API endpoints, parameters, and responses.