انتقل للمحتوى

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    زرار الموقع وروابط واتساب

    إحصائيات الرابط

    GET/v2/links/{linkId}/stats
    • الصلاحية:links:read
    • Idempotency-Key:مش مستخدم
    • قراءة بس

    الضغطات والمحادثات المنسوبة ونسبة التحويل باليوم ومصدر/وسيلة utm والحملة والجهاز ودومين المصدر.

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    linkIdإجباريالنوعstringالقيود—الوصفid رابط واتساب.

    الاستعلام (Query)

    الاسمالنوعالقيودالوصف
    fromاختياريالنوعstringالقيود—الوصفYYYY-MM-DD (الافتراضي: 30 يوم قبل to).
    toاختياريالنوعstringالقيود—الوصفYYYY-MM-DD (الافتراضي: النهارده)؛ أقصاها 92 يوم.
    tzاختياريالنوعstringالقيود—الوصفالمنطقة الزمنية للأيام (الافتراضي Africa/Cairo).

    الهيدرز

    الاسمالنوعالقيودالوصف
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الطلب

    curl -X GET "https://mursilat.com/api/v2/links/linkId/stats?from=2026-10-01&to=2026-10-14" \
      -H "Authorization: Bearer $WASLA_API_KEY"

    الرد

    200مثال

    200 — application/json
    {
      "range": {
        "from": "2026-10-01",
        "to": "2026-10-14",
        "tz": "Africa/Cairo"
      },
      "totals": {
        "impressions": null,
        "clicks": 40,
        "conversations": 12,
        "conversionRate": 0.3
      },
      "byDay": [
        {
          "day": "2026-10-14",
          "impressions": 0,
          "clicks": 3,
          "conversations": 1
        }
      ],
      "byPage": [
        {
          "key": "/products/bag",
          "clicks": 10,
          "conversations": 3
        }
      ],
      "bySource": [
        {
          "key": "facebook / cpc",
          "source": "facebook",
          "medium": "cpc",
          "clicks": 5,
          "conversations": 2
        }
      ],
      "byCampaign": [
        {
          "key": "summer",
          "clicks": 4,
          "conversations": 1
        }
      ],
      "byAgent": [
        {
          "key": "sales",
          "clicks": 4,
          "conversations": 1
        }
      ],
      "byDevice": [
        {
          "key": "mobile",
          "clicks": 30,
          "conversations": 9
        }
      ],
      "byReferrer": [
        {
          "key": "facebook.com",
          "clicks": 4,
          "conversations": 1
        }
      ]
    }

    شكل الرد

    حقول الرد في المثال. افتح الكائنات والقوايم.

    • responseobject9 حقل
      • rangeobject3 حقل
        • fromstring "2026-10-01"
        • tostring "2026-10-14"
        • tzstring "Africa/Cairo"
      • totalsobject4 حقل
        • impressionsnull null
        • clicksinteger 40
        • conversationsinteger 12
        • conversionRatenumber 0.3
      • byDayarray1 عنصر
        • [0]object4 حقل
          • daystring "2026-10-14"
          • impressionsinteger 0
          • clicksinteger 3
          • conversationsinteger 1
      • byPagearray1 عنصر
        • [0]object3 حقل
          • keystring "/products/bag"
          • clicksinteger 10
          • conversationsinteger 3
      • bySourcearray1 عنصر
        • [0]object5 حقل
          • keystring "facebook / cpc"
          • sourcestring "facebook"
          • mediumstring "cpc"
          • clicksinteger 5
          • conversationsinteger 2
      • byCampaignarray1 عنصر
        • [0]object3 حقل
          • keystring "summer"
          • clicksinteger 4
          • conversationsinteger 1
      • byAgentarray1 عنصر
        • [0]object3 حقل
          • keystring "sales"
          • clicksinteger 4
          • conversationsinteger 1
      • byDevicearray1 عنصر
        • [0]object3 حقل
          • keystring "mobile"
          • clicksinteger 30
          • conversationsinteger 9
      • byReferrerarray1 عنصر
        • [0]object3 حقل
          • keystring "facebook.com"
          • clicksinteger 4
          • conversationsinteger 1

    الأخطاء

    غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:

    الأخطاء →

    جرّب

    ابعت الطلب ده من متصفحك لـ API مرسلات.

    مثال موثّق

    معاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.

    الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (قراءة بس)

    متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.

    بارامترات المسار
    بارامترات الاستعلام

    تبعت الطلب ده بجد؟

    GET /v2/links/{linkId}/stats