Ова е сервис за глобално пребарување што користи веќе индексирани страни на Google, Yahoo, Bing и др..
Има и некои напредни опции за пребарување како на пр. пребарување во конкретен домејн или екстенција итн..
Потребно е да сте најавен корисник за да можете да го користите сервисот.
Најавата / регистрацијата ја упростивме на најлесниот можен начин. Потребно е само да се најавите со вашиот Google / Gmail профил. После најавата во полето за токен (подоле) ќе можете да го користите Вашиот личен токен на PHP.mk сервисите.
Личен токен
За да се прикаже токенот, потребна е најава!
Верзија ({верзија}): v1.0
Хост ({host}): * Опционален сегмент за пребарување само во специфичен хост.
query ({q}): ?q= пр. настани во Скопје * q (query) URL параметар за дефиниција на пребарувањето.
Страна ({страна}): цел број за следна страна * опционално (доколку се изостави - вредноста е 1)
Сервис end-point
HTTP/GET
https://api.php.mk/search/{верзија}/{host}?token={token}&q={q}&page={страна}
Пример HTTP/GET request
Пример 1: пребарува за „Настани во Скопје“ само на sitel.com.mk
Пример 2: Втора страна од пребарувањето за „Настани во Скопје“ само на „mk“ домени.
Пример 3: Пребарува за „Настани во Скопје“ без ограничување по домејн.
https://api.php.mk/search/v1.0/sitel.com.mk?token=&q=Настани+во+Скопје;?> https://api.php.mk/search/v1.0/mk?token=&q=Настани+во+Скопје;?>&page=2 https://api.php.mk/search/v1.0/?token=&q=Настани+во+Скопје
Пример PHP
$url='https://api.php.mk/search/v1.0/?token=&page=1&q=Настани+во+Скопје';
$jsonResponse=file_get_contents($url);
$response= json_decode($jsonResponse,true);
echo '<pre>';
print_r($response['data']);
exit();
Пример cUrl
curl -X GET 'https://api.php.mk/search/v1.0/?token=&page=1&q=Настани+во+Скопје';
Пример Javascript
var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
var response_data=JSON.parse(this.responseText).data;
console.log(response_data);
}
});
xhr.open("GET", "https://api.php.mk/search/v1.0/?token=&page=1&q=Настани+во+Скопје");
xhr.send();
Пример jQuery / JavaScript
$.getJSON('https://api.php.mk/search/v1.0/?token=&page=1&q=Настани+во+Скопје',function(r){
console.log(r.data);
}).error(function(error){
console.log(error.responseJSON.msg);
});
Одговорот е секогаш во JSON формат
Одговорот од сервисот го содржи резултатот од пребарувањата за наведената страна.
Пример од одговор
{
"error": false,
"status_text": "OK",
"status_code": 200,
"page": 1,
"data": [
{
"title": "Настани во Скопје | TIME.mk",
"link": "https://time.mk/nastani/skopje/2",
"description": "Изборот и позициите на вестите на TIME.mk се одредуваат автоматски со компјутерска програма.",
"pubDate": "Fri, 08 Feb 2019 21:55:00 GMT"
},
{
"title": "Дениција - Ресторан за свадби, настани и прослави во Скопје",
"link": "http://denicija.mk/",
"description": "Ви ја претставуваме Дениција- нов ресторан за свадби, настани и прослави во Скопје. Инспирацијата за овој ресторан доаѓа од македонската “Химна на љубовта” - безвремената Дениција.",
"pubDate": "Thu, 14 Feb 2019 09:31:00 GMT"
},
{
"title": "Официјален портал на Град Скопје - Објави, конкурси, настани",
"link": "http://www.skopje.gov.mk/DesktopDefault.aspx?tabindex=0&tabid=652",
"description": "Официјален портал на Град Скопје MK | EN | SQ : www.skopje.gov.mk Официјален портал на Град Скопје ... Времето во Скопје: Прогноза : Објави, конкурси, настани : Факти: Симболи: Мапа: Поважни телефони: Корисни линкови | Најава: Администр",
"pubDate": "Thu, 14 Feb 2019 13:05:00 GMT"
},
{
"title": "НАСТАНИ: ENRIQUE IGLESIAS ВО СКОПЈЕ - Денес Магазин",
"link": "https://denesmagazin.mk/nastani-enrique-iglesias-vo-skopje/",
"description": "Спортски Центар Борис Трајковски, 20 Јуни МЕГА ПОЗИТИВНА БОМБА: СУПЕР ЕКСКЛУЗИВЕН КОНЦЕРТ НА КРАЛОТ НА ЛАТИНО ПОП МУЗИКАТА enrique iglesias ВО МАКЕДОНИЈА!!! Почитувани, Огромно задоволство ни е да ..."
},
{
"title": "Со настани во Скопје, Охрид и Штип, МВР ќе го одбележи ...",
"link": "https://macedonia365.com/10347/",
"description": "Со настани во Скопје, Охрид и Штип, МВР ќе го одбележи денот на полицијата 28 април, 2018 | 18:07 часот | 195 прикажувања |",
"pubDate": "Thu, 07 Feb 2019 21:42:00 GMT"
},
{
"title": "Настани - Posts | Facebook",
"link": "https://www.facebook.com/nastanicommk/posts",
"description": "Настани. 844 likes. www,nastani.com.mk за да бидете во тек со сите поважни случувања во Скопје и Македонија."
},
{
"title": "Викенд настани во Скопје | skopjeinfo.mk",
"link": "https://skopjeinfo.mk/vikend-nastani-vo-skopje-0?qt-popularni_vo_node=0",
"description": "Викендов времето ќе биде претежно сончево со локална облачност и топло време со дневна температура од 23 до 33 степени. Доколку се уште не сте испланирале каде ќе го поминeте вашето слободно ...",
"pubDate": "Sat, 26 Jan 2019 23:43:00 GMT"
},
{
"title": "Откажани настани во културата - А1он",
"link": "https://a1on.mk/archives/1014588",
"description": "Поради жртвите во тешката сообраќајна несреќа и прогласените денови на жалост, денеска и утре се откажуваат закажани настани во институциите од културата.",
"pubDate": "Thu, 14 Feb 2019 09:45:00 GMT"
},
{
"title": "Tango Milonguero настани во Скопје",
"link": "https://tangonastaniskopje.blogspot.com/",
"description": "- Машките ги покануваат девојките со поглед или знак со главата (cabеceo) - Танцуваме во круг (ronda), кој се движи со постојано темпо спротивно од стрелката на часовникот",
"pubDate": "Sun, 10 Feb 2019 02:26:00 GMT"
},
{
"title": "Настани | Скопје вечер",
"link": "https://reporter.mk/skopjevecer/category/nastani/",
"description": "Во рамките на одбележувањето на Денот на уметноста, кој МКЦ години наназад традиционално го прославува со голем хепенинг насловен како Роденден, по цели 11 години, повторно во Скопје доаѓа...",
"pubDate": "Mon, 04 Feb 2019 00:38:00 GMT"
}
]
}