დეველოპერებისთვის

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–6 — pill \| split \| minimal \| neon \| glass \| terminal
color	optional	ნებისმიერი hex, მაგ. %236366f1 (აქცენტი/ფონი)
size	optional	compact \| default \| large

მაგალითი

<img src="https://static.webo.ge/api/counter_image?site_id=1&style=1&color=10b981">

პასუხი

image/svg+xml

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, ქვეყნები, გვერდები.

პარამეტრები

სახელი	საჭიროება	აღწერა
site_id	required	საიტის ID
type	required	browsers, os, countries, pages, hours, daily
days	optional	პერიოდი (default 30)

მაგალითი

GET https://static.webo.ge/api/stat_data?site_id=1&type=browsers

პასუხი

[
  { "label": "Chrome", "cnt": 640 }
]

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": "მედია" }
]

📣 სარეკლამო ზონები

GET /api/ad_zone_serve

აბრუნებს ზონისთვის გასაშვებ რეკლამას JSON-ად (weighted როტაცია).

პარამეტრები

სახელი	საჭიროება	აღწერა
zone	required	ზონის კოდი (hex)
device	optional	targeting — desktop \| mobile \| tablet
geo	optional	targeting — ქვეყნის კოდი (მაგ. GE)
lang	optional	targeting — ka \| en

მაგალითი

GET https://static.webo.ge/api/ad_zone_serve?zone=a1b2c3d4

პასუხი

{
  "zone": "a1b2c3d4",
  "ad": {
    "id": 3,
    "title": "აქცია -50%",
    "image_url": "https://…/banner.jpg",
    "target_url": "https://static.webo.ge/api/ad_click?ad=3",
    "impressions": 1250,
    "clicks": 42
  }
}

GET /api/vast.php

ვიდეო pre-roll VAST 2.0 XML — VideoJS, JW Player თავსებადი.

პარამეტრები

სახელი	საჭიროება	აღწერა
zone	required	ვიდეო-ზონის კოდი
geo	optional	targeting — ქვეყნის კოდი
device	optional	targeting

მაგალითი

GET https://static.webo.ge/api/vast.php?zone=a1b2c3d4&geo=GE

პასუხი

application/xml — VAST 2.0

GET /api/ad_click

დაწკაპუნების ტრეკინგი — ითვლის დაწკაპუნებას და გადამისამართებს სამიზნე URL-ზე. type=impression აღრიცხავს ნაჩვენებს (VAST).

პარამეტრები

სახელი	საჭიროება	აღწერა
ad	required	რეკლამის ID
type	optional	impression \| click

მაგალითი

GET https://static.webo.ge/api/ad_click?ad=3

პასუხი

302 → target_url

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

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

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