შესვლა რეგისტრაცია
დეველოპერებისთვის

WeboStats API

საჯარო, უფასო API ქართული საიტების რეიტინგის, ტრაფიკის სტატისტიკისა და ვიზიტორთა მრიცხველისთვის. ყველა endpoint მუშაობს GET მეთოდით, აბრუნებს JSON-ს და ღიაა cross-origin გამოძახებისთვის.

Base URL
https://static.webo.ge/api/
CORS
ღია
Rate limit
~200/წთ
ფასი
უფასო

📊 მრიცხველი & ვიზიტორები

GET /api/counter_hit

აღრიცხავს გვერდის ერთ ნახვას და აბრუნებს 1×1 გამჭვირვალე GIF-ს.

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
s optional სესიის იდენტიფიკატორი
page optional გვერდის URL
ref optional referrer
მაგალითი
GET https://static.webo.ge/api/counter_hit?site_id=1&page=https://example.ge/
პასუხი
image/gif — 1×1 პიქსელი
GET /api/counter_ping

heartbeat — ვიზიტორს ინარჩუნებს ონლაინ სტატუსში (~2 წთ). ონლაინ ფანჯარა 5 წთ.

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
s optional სესია
მაგალითი
GET https://static.webo.ge/api/counter_ping?site_id=1&s=ab12cd34
პასუხი
image/gif — 1×1 პიქსელი
GET /api/counter_image

აბრუნებს მრიცხველის SVG ბეჯს. გამოიყენება img-ად. ფერი ხელით ირჩევა — ტექსტის ფერი ავტომატურად კონტრასტდება.

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
style optional 1–7 — pill | split | minimal | neon | glass | terminal | classic (90×30)
color optional ნებისმიერი hex, მაგ. %236366f1 (აქცენტი/ფონი)
size optional compact | default | large
w optional classic სტილის სიგანე პიქსელებში (default 90, მაქს 450)
მაგალითი
<img src="https://static.webo.ge/api/counter_image?site_id=1&style=classic&w=180">
პასუხი
image/svg+xml
GET /js/webo-counter.js

კლასიკური 90×30 მრიცხველის ვიჯეტი — კონტეინერში ჩასმული ლინკი + სერვერული ბანერი (style=classic): ჯამური, დღევანდელი ვიზიტორები და ონლაინი. SPA ნავიგაციაზე ავტომატურად განახლდება.

მაგალითი
<div id="webo-counter-container" data-site-id="1"></div>
<script async src="//static.webo.ge/js/webo-counter.js"></script>
პასუხი
application/javascript
GET /api/online_count

მიმდინარე ონლაინ ვიზიტორები (5-წუთიანი ფანჯარა).

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
მაგალითი
GET https://static.webo.ge/api/online_count?site_id=1
პასუხი
{
  "site_id": 1,
  "online": 42
}

📈 სტატისტიკა

GET /api/counter_stats

დღევანდელი შემაჯამებელი — ჰიტები, უნიკალები, რანკი, GE %.

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
მაგალითი
GET https://static.webo.ge/api/counter_stats?site_id=1
პასუხი
{
  "rank": 17,
  "hits": 1240,
  "unique_visitors": 880,
  "georgia_pct": 87
}
GET /api/stat_data

დეტალური ანალიტიკა გრაფიკებისთვის — ბრაუზერები, OS, ქვეყნები, გვერდები, რეფერერები. type=hours ითვლის მთელ კალენდარულ დღეებს — days=1 მხოლოდ დღევანდელ დღეს აბრუნებს (გუშინდელის შერევის გარეშე).

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
type required browsers, os, countries, pages, referrers, hours, weekdays, weekdays_compare, daily — hours: days=N → ბოლო N კალენდარული დღე, days=1 → დღევანდელი; weekdays: ორშ–კვი (0–6); weekdays_compare: ეს კვირა vs წინა კვირა — cnt = ეს კვირა, prev = წინა კვირა (იგივე დღემდე, სამართლიანი შედარება); daily: ბოლო N დღე თარიღების მიხედვით; pages/referrers დაბრუნდება დეკოდირებული (სრული URL-ებით)
days optional პერიოდი (default 30). type=hours-ზე ითვლება მთელი კალენდარული დღეები: days=1 → მხოლოდ დღევანდელი (00:00-დან ახლა-მდე), days=7 → ბოლო 7 დღე. სხვა type-ებზე — მოძრავი N×24სთ ფანჯარა
მაგალითი
GET https://static.webo.ge/api/stat_data?site_id=1&type=hours&days=1
პასუხი
[
  { "label": "9", "cnt": 12 },
  { "label": "10", "cnt": 34 },
  { "label": "11", "cnt": 52 }
]  // label = საათი 0–23, დღევანდელი დღის მიხედვით
GET /api/stat_data

კვირის დღეების შედარება — ეს კვირა vs წინა კვირა (type=weekdays_compare). წინა კვირა იჭრება დღევანდელი დღის ინდექსამდე, რომ შედარება თანასწორი იყოს (ორშაბათს ორივე მხარე მხოლოდ ორშ–დღეს მოიცავს).

პარამეტრები
სახელისაჭიროებააღწერა
site_id required საიტის ID
type required weekdays_compare
მაგალითი
GET https://static.webo.ge/api/stat_data?site_id=1&type=weekdays_compare
პასუხი
[
  { "label": "0", "cnt": 120, "prev": 95 },  // ორშ — ეს კვირა 120, წინა 95
  { "label": "1", "cnt": 88, "prev": 90 },  // სამშ
  { "label": "2", "cnt": 64, "prev": 71 },  // ოთხ (დღევანდელი) — ორივე მხარე ოთხამდეა
  { "label": "3", "cnt": 0, "prev": 0 }     // ხუთშ — ამ კვირაში ჯერ არ მოსულა
]  // label = კვირის დღე 0–6 (ორშ=0 … კვი=6)
GET /api/counter_total_stats

მთელი ქსელის დღევანდელი ჯამური მაჩვენებლები.

მაგალითი
GET https://static.webo.ge/api/counter_total_stats
პასუხი
{
  "total_hits": 152340,
  "total_uniques": 61200
}

🏆 რეიტინგი & კატეგორიები

GET /api/sites

რეიტინგის ტოპ-100 საიტი, დალაგებული rank-ით.

პარამეტრები
სახელისაჭიროებააღწერა
limit optional მაქსიმალური რაოდენობა (default 100)
მაგალითი
GET https://static.webo.ge/api/sites
პასუხი
[
  {
    "id": 5,
    "name": "Example.ge",
    "rank": 1
  }
]
GET /api/categories

საიტების კატეგორიების სია.

მაგალითი
GET https://static.webo.ge/api/categories
პასუხი
[
  { "id": 1, "name": "მედია" }
]

მზად ხარ ინტეგრაციისთვის?

დაამატე შენი საიტი და მიიღე site_id + მზა embed კოდი.

HTML კოდის გენერატორი დაამატე საიტი