OXO.GE API
საჯარო, უფასო API ქართული საიტების რეიტინგის, ტრაფიკის სტატისტიკისა და სარეკლამო ზონებისთვის. ყველა endpoint მუშაობს GET მეთოდით, აბრუნებს JSON-ს და ღიაა cross-origin გამოძახებისთვის.
მრიცხველი & ვიზიტორები
აღრიცხავს გვერდის ერთ ნახვას და აბრუნებს 1×1 გამჭვირვალე GIF-ს.
GET https://oxo.ge/api/counter_hit?site_id=123&page=https://example.ge/
image/gif — 1×1 პიქსელი
heartbeat — ვიზიტორს ინარჩუნებს ონლაინ სტატუსში (~2 წთ). ონლაინ ფანჯარა 5 წთ.
GET https://oxo.ge/api/counter_ping?site_id=123&s=ab12cd34
image/gif — 1×1 პიქსელი
აბრუნებს მრიცხველის SVG ბეჯს. გამოიყენება img-ად.
<img src="https://oxo.ge/api/counter_image?site_id=123&style=1">
image/svg+xml
მიმდინარე ონლაინ ვიზიტორები (5-წუთიანი ფანჯარა).
GET https://oxo.ge/api/online_count?site_id=123
{
"site_id": 123,
"online": 42
}
სტატისტიკა
დღევანდელი შემაჯამებელი — ჰიტები, უნიკალები, რანკი, GE %.
GET https://oxo.ge/api/counter_stats?site_id=123
{
"rank": 17,
"hits": 1240,
"unique_visitors": 880,
"georgia_pct": 87
}
დეტალური ანალიტიკა გრაფიკებისთვის — ბრაუზერები, OS, ქვეყნები, გვერდები.
GET https://oxo.ge/api/stat_data?site_id=123&type=browsers
[
{ "label": "Chrome", "cnt": 640 }
]
მთელი ქსელის დღევანდელი ჯამური მაჩვენებლები.
GET https://oxo.ge/api/counter_total_stats
{
"total_hits": 152340,
"total_uniques": 61200
}
რეიტინგი & კატეგორიები
რეიტინგის ტოპ-100 საიტი, დალაგებული rank-ით.
GET https://oxo.ge/api/sites
[
{
"id": 5,
"name": "Example.ge",
"rank": 1
}
]
საიტების კატეგორიების სია.
GET https://oxo.ge/api/categories
[
{ "id": 1, "name": "მედია" }
]
სარეკლამო ზონები
აბრუნებს ზონისთვის გასაშვებ რეკლამას JSON-ად.
GET https://oxo.ge/api/ad_zone_serve?zone=a1b2c3d4
{ "ad": null }
ვიდეო pre-roll VAST 2.0 XML — VideoJS, JW Player თავსებადი.
GET https://oxo.ge/api/vast.php?zone=a1b2c3d4&geo=GE
application/xml — VAST 2.0