# Farasa Web API

**Canonical:** https://apis.io/apis/hbku/farasa-api/  
**Provider:** Hamad Bin Khalifa University — https://apis.io/providers/hbku/  
**Base URL:** https://farasa.qcri.org/webapi  
**Documentation:** https://farasa.qcri.org/

Farasa Web API is one of 5 APIs that [Hamad Bin Khalifa University](https://apis.io/providers/hbku/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Natural Language Processing, Arabic, and Research. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Farasa ("insight") is the Arabic text-processing toolkit built by the Arabic Language Technologies group at QCRI, Hamad Bin Khalifa University, and offered free to registered users as a keyed web API. Six endpoints were confirmed live on 2026-08-30 by unauthenticated POST probes — segmentation, lemmatization, pos, ner, diacritize and spellcheck each returned 400 "invalid api key", while sibling module paths returned 404. The api_key travels in the request body rather than a header. No OpenAPI is published by the provider; the definition in this repo is DERIVED from QCRI's own Python/Java/JavaScript/curl samples plus those probes, and the success payload shape is deliberately left unasserted because it could not be observed.

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hbku/refs/heads/main/openapi/hbku-farasa-api-openapi.yml
- **Documentation** — https://farasa.qcri.org/
- **Reference** — https://alt.qcri.org/farasa/
- **SignUp** — https://farasa.qcri.org/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/hbku/refs/heads/main/authentication/hbku-authentication.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/hbku/refs/heads/main/examples/hbku-farasa-invalid-key-example.json

## Other Hamad Bin Khalifa University APIs (4)

- [Fanar API](https://apis.io/apis/hbku/fanar-api/)
- [Elmi Research Portal — OAI-PMH](https://apis.io/apis/hbku/elmi-oai-pmh/)
- [HBKU Academic Catalog — Course Search](https://apis.io/apis/hbku/course-catalog-search/)
- [Manara — Qatar Research Repository (HBKU portal)](https://apis.io/apis/hbku/manara-repository/)

## Tags

Natural Language Processing, Arabic, Research

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hbku/farasa-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hbku/.