Skip to main content
GET
/
v1
/
comments
List Comments
curl --request GET \
  --url https://api.trynawa.com/v1/comments

Documentation Index

Fetch the complete documentation index at: https://developers.trynawa.com/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve classified comments with filtering and pagination. This endpoint is free.

​
Request

​
Query parameters

ParameterTypeRequiredDescription
channel_idstringNoFilter by channel ID
platformstringNoFilter by platform: youtube, instagram, twitter, facebook
intentstringNoFilter by intent: question, complaint, praise, suggestion, spam, other
sentimentstringNoFilter by sentiment: positive, negative, neutral, mixed
dialectstringNoFilter by dialect: gulf, egyptian, levantine, msa
toxicitystringNoFilter by toxicity: none, mild, moderate, severe
fromstringNoStart date (ISO 8601): 2025-01-01T00:00:00Z
tostringNoEnd date (ISO 8601): 2025-01-31T23:59:59Z
limitintegerNoResults per page (1–100). Default: 25.
cursorstringNoPagination cursor from previous response.

​
Example request

curl "https://api.trynawa.com/v1/comments?platform=youtube&intent=question&limit=10" \
  -H "Authorization: Bearer nawa_test_sk_xxx"

​
Response

​
Success response (200)

{
  "success": true,
  "result": {
    "comments": [
      {
        "id": "cmt_abc123",
        "text": "متى الجزء الثاني؟",
        "platform": "youtube",
        "intent": "question",
        "sentiment": "neutral",
        "dialect": "gulf",
        "toxicity": "none",
        "created_at": "2025-01-15T10:30:00Z",
        "channel_id": "ch_123"
      }
    ],
    "pagination": {
      "has_more": true,
      "next_cursor": "cur_def456",
      "total_count": 1523
    }
  },
  "errors": [],
  "request_id": "req_lst_abc123"
}