Skip to main content

​
First API call in 3 minutes

Get up and running with the NAWA classification API in three steps.
1

Get your API key

Go to trynawa.com/developers/keys to create your free API key. Sign in with Google or email - no credit card required.
Free keys (nawa_test_sk_xxx) require no credit card. Limited to 100 lifetime requests and 14-day expiry. They use real AI models - same accuracy as paid keys.
2

Make your first classification

Send an Arabic comment to the /v1/classify endpoint:
curl -X POST https://api.trynawa.com/v1/classify \
  -H "Authorization: Bearer nawa_test_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "متى الجزء الثاني؟",
    "platform": "youtube"
  }'
3

Read the response

Every NAWA response follows a consistent envelope format:
{
  "success": true,
  "result": {
    "text": "متى الجزء الثاني؟",
    "intent": "question",
    "intent_confidence": 0.97,
    "sentiment": "neutral",
    "sentiment_confidence": 0.91,
    "dialect": "gulf",
    "dialect_confidence": 0.95,
    "toxicity": "none",
    "toxicity_confidence": 0.99,
    "categories": ["engagement"],
    "language": "ar",
    "model": "nagl-v1",
    "cached": false
  },
  "errors": [],
  "request_id": "req_abc123def456"
}
Response fields:
FieldTypeDescription
intentstringOne of: question, complaint, praise, suggestion, spam, other
intent_confidencenumberConfidence score between 0 and 1
sentimentstringOne of: positive, negative, neutral, mixed
dialectstringOne of: gulf, egyptian, levantine, msa
dialect_confidencenumberConfidence score between 0 and 1
toxicitystringOne of: none, mild, moderate, severe
categoriesarrayContent categories: engagement, support, feedback, spam
cachedbooleantrue if served from semantic cache (no cost)

​
What’s next?

Authentication

Learn about API keys, free vs paid tiers, and key rotation.

API Reference

Explore all endpoints, parameters, and response schemas.

Dialect Detection

Deep dive into Gulf, Egyptian, Levantine, and MSA classification.

SDKs

Install the TypeScript or Python SDK for a better developer experience.