OPIDB

webapi

OPIDB (Open Proverbs and Idioms Database) is a comprehensive database and API service that provides access to a vast collection of proverbs and idioms from various cultures and languages around the world. The service offers a RESTful API that enables developers to integrate proverbs and idioms into their applications. The API provides multiple endpoints for querying proverbs and idioms based on different criteria such as language, culture, category, and keywords. Users can retrieve random proverbs, search for specific idioms, or browse by various filters to find the perfect expression for their needs.

API Usage

The OPIDB API is available at https://api.opidb.co/api/v1/ and provides a simple RESTful interface for accessing proverbs and idioms.

Get a random proverb or idiom (any type):

curl "https://api.opidb.co/api/v1/random"

Get a random proverb (filtered):

curl "https://api.opidb.co/api/v1/proverbs/random?language_code=en"

Get a random idiom (filtered):

curl "https://api.opidb.co/api/v1/idioms/random?difficulty_level=advanced"

Search across proverbs + idioms (full-text):

curl "https://api.opidb.co/api/v1/search?search=wisdom&language_code=en"

Get proverbs by language:

curl "https://api.opidb.co/api/v1/proverbs?language_code=en"

Get idioms by thematic category:

curl "https://api.opidb.co/api/v1/idioms?thematic_category=love"

Get a specific item by ID:

curl "https://api.opidb.co/api/v1/items/123"

Get available languages:

curl "https://api.opidb.co/api/v1/languages"

Get API statistics:

curl "https://api.opidb.co/api/v1/stats"

Documentation ↗ (opens in a new tab)