گرفتن آمار‌های آگهی

با استفاده از این API می‌توانید آمارهای یک آگهی را مشاهده کنید. این آمارها شامل میزان نمایش آگهی در لیست دیوار (impressions)، نمایش صفحه‌ی آگهی (views)، و تعداد مکالمه‌های چت دریافتی آگهی (chats) است. توجه کنید که به روزرسانی این آمارها با چند دقیقه تاخیر رخ می‌دهد.

برای فراخوانی این سرویس به دسترسی‌های زیر نیاز دارید:

• دسترسی POST_STATS_RETRIEVE بر روی API KEY
• دسترسی USER_POSTS_STATS_READ در OAuth

نمونه درخواست:

GET https://open-api.divar.ir/experimental/open-platform/posts/{post_token}/stats
x-api-key: {{apikey}}
Authorization: Bearer {{access_token}}

نکته: مقادیر صفر در خروجی API نمی‌آیند. در صورتی که کلیدی وجود ندارد، مقدار آن را صفر در نظر بگیرید.

نمونه پاسخ:

{
  "views": {
    "daily": [
      {
        "count": 17,
        "date": "2025-06-01"
      },
      {
        "count": 6,
        "date": "2025-06-02"
      },
      {
        "date": "2025-06-03"
      },
      {
        "date": "2025-06-04"
      },
      {
        "date": "2025-06-05"
      },
      {
        "date": "2025-06-06"
      },
      {
        "count": 2,
        "date": "2025-06-07"
      }
    ],
    "total": 32
  },
  "impressions": {
    "daily": [
      {
        "count": 210,
        "date": "2025-06-01"
      },
      {
        "count": 251,
        "date": "2025-06-02"
      },
      {
        "count": 293,
        "date": "2025-06-03"
      },
      {
        "count": 431,
        "date": "2025-06-04"
      },
      {
        "count": 732,
        "date": "2025-06-05"
      },
      {
        "count": 984,
        "date": "2025-06-06"
      },
      {
        "count": 1393,
        "date": "2025-06-07"
      }
    ],
    "total": 32
  },
  "chats": {
    "daily": [
      {
        "date": "2025-06-01"
      },
      {
        "date": "2025-06-02"
      },
      {
        "count": 6,
        "date": "2025-06-03"
      },
      {
        "count": 15,
        "date": "2025-06-04"
      },
      {
        "count": 31,
        "date": "2025-06-05"
      },
      {
        "count": 27,
        "date": "2025-06-06"
      },
      {
        "count": 45,
        "date": "2025-06-07"
      }
    ],
    "total": 32
  }
}