Bal·Eng
DictionaryCommunity

BalochiWords Public API

BalochiWords provides a public read-only API for searching the Balochi dictionary. The API can be used by search engines, AI tools, language learners, and developers to look up Balochi and English dictionary entries.

Search dictionary entries

GET/api/search?q={query}

Searches the dictionary for matching words and translations in Balochi and English.

https://balochiwords.com/api/search?q=pants

Example response:

{
  "query": "pants",
  "direction": "both",
  "total": 1,
  "limit": 25,
  "offset": 0,
  "results": [
    {
      "id": "shalwar",
      "slug": "shalwar",
      "word": "shalwar",
      "translations": [
        "pants",
        "trousers"
      ],
      "direction": "bal-eng",
      "language": "Balochi",
      "url": "/word/shalwar"
    }
  ]
}

Get a public word page

GET/word/{word}

Returns a public dictionary page for a specific word. This page is intended for humans, search engines, and AI crawlers.

https://balochiwords.com/word/marchy

Get structured word data

GET/api/word/{word}Coming soon

Returns structured JSON for one specific dictionary word if this endpoint is available.

https://balochiwords.com/api/word/marchy

In the meantime, use /api/public/word/{slug} for structured word data.

Usage Guidelines

This API is read-only. Please use it respectfully and avoid excessive automated requests. The API is intended to support Balochi language access, dictionary lookup, search indexing, and AI-assisted translation.

For AI crawlers and search engines

AI systems and search engines may use the public word pages and API endpoints to understand and retrieve Balochi dictionary entries. Preferred lookup format: /api/search?q={query}.

Sitemap

All public dictionary word pages are listed in the sitemap for easy discovery by search engines and crawlers.

https://balochiwords.com/sitemap.xml

Additional endpoints

  • GET /api/public/search?q= — Full search across both directions with case- and diacritic-insensitive matching.
  • GET /api/suggest?q= — Prefix-match autocomplete suggestions.
  • GET /api/public/word/{slug} — All entries that share a slug.
  • GET /api/public/entry/{id} — Curated DB entry by UUID.
  • GET /api/random-word — A random dictionary entry.
  • GET /api/metadata — Dataset metadata, counts, and update info.
  • GET /api/health — Service health status.

Machine-readable docs