API Documentation

Amaalsense API

دمج تحليل المشاعر الجماعية في تطبيقاتك باستخدام واجهة برمجة التطبيقات RESTful

البداية السريعة
1

احصل على مفتاح API

سجل للحصول على حساب واحصل على مفتاح API الخاص بك من لوحة التحكم

2

أضف المفتاح للطلبات

أضف مفتاح API في header كـ Bearer token

3

ابدأ الاستخدام

استخدم نقاط النهاية للحصول على بيانات المشاعر

Base URL

https://api.amalsense.com/v1

Authentication

curl -X GET "https://api.amalsense.com/v1/indices/global" \
  -H "Authorization: Bearer YOUR_API_KEY"
حدود الاستخدام

Free

100/day

Burst: 10/min

Pro

1,000/day

Burst: 60/min

Enterprise

10,000/day

Burst: 300/min

Government

Unlimited

Burst: Custom

Emotion Indices

احصل على المؤشرات العاطفية الحالية (GMI, CFI, HRI) على المستوى العالمي أو لدولة محددة

GET/indices/global
Get current global emotion indices (GMI, CFI, HRI)

Response

{
  "gmi": 45.2,
  "cfi": 62.8,
  "hri": 38.5,
  "confidence": 87,
  "timestamp": "2026-01-31T12:00:00Z"
}

Example

curl -X GET "https://api.amalsense.com/v1/indices/global" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/indices/country/:code
Get emotion indices for a specific country

Parameters

code(string)RequiredISO 3166-1 alpha-2 country code (e.g., LY, EG, US)

Response

{
  "countryCode": "LY",
  "countryName": "Libya",
  "gmi": 42.1,
  "cfi": 58.3,
  "hri": 45.7,
  "confidence": 82,
  "timestamp": "2026-01-31T12:00:00Z"
}

Example

curl -X GET "https://api.amalsense.com/v1/indices/country/LY" \
  -H "Authorization: Bearer YOUR_API_KEY"
SDKs & Libraries
مكتبات جاهزة للاستخدام في لغات البرمجة المختلفة

Python

pip install amalsense

JavaScript/Node.js

npm install @amalsense/sdk

cURL

# No installation needed

SDKs قادمة قريباً - استخدم REST API مباشرة في الوقت الحالي

Welcome to Amaalsense

Amaalsense is a revolutionary platform that analyzes collective emotions from digital sources worldwide. Let's take a quick tour!