Serpstack pregled: JSON rest API za rezultate Google pretraživanja

Ako trebate doznati rezultate tražilice - posebno one s Googlea - jedan od načina da to učinite pokrenite stvarnu pretragu na google.com i pokušajte raščlaniti zamršeni HTML kôd koji ćete dobiti kao proizlaziti. To se može, ali to je prilično nastojanje. Ako želite krenuti lakšom rutom, zašto ne koristite namjenski SERP API koji možete hraniti svojim pojmom za pretraživanje i koji će rezultate vratiti u formatu koji se lako može raščlaniti. Jedan takav proizvod je Serpstack API od apilayera. Niz i parametri vašeg upita za pretraživanje uzimaju kao ulaz i vraća rezultate pretraživanja u JSON formatu. Pogledajmo proizvod.

Počet ćemo kao što to često radimo raspravljajući o SERP-u općenito. Zatim ćemo objasniti što je to i opisati nekoliko različitih vrsta rezultata koji su obično dostupni u tražilicama. Istražit ćemo i nekoliko razloga zbog kojih bi se koristio API SERP. Kad jednom budemo svi na istoj stranici, podrobno ćemo pogledati Serpstack API. Kratko ćemo pregledati neke njegove glavne značajke prije nego što istražimo kako koristiti API. Prije nego što zaključimo, istražit ćemo strukturu cijena i dostupne planove usluge.

SERP ukratko

Prvo, SERP je akronim za stranice s rezultatima tražilice. To su web stranice koje se korisnicima služe kada putem pretraživača poput Googlea ili Binga traže nešto na mreži. Korisnik određuje svoj upit za pretraživanje koristeći specifične pojmove i izraze koji se obično nazivaju ključnim riječima, a zatim im pretraživač predstavlja SERP.

Svaki SERP je jedinstven. To se čak odnosi i na više upita pretraživanja koje se obavljaju na istoj tražilici koristeći iste ključne riječi ili tekst upita. Glavni razlog za to je taj što gotovo svaka tražilica prilagođava iskustvo svojim korisnicima predstavljajući rezultate temeljene na širokom rasponu faktora koji nadilaze njihove pojmove za pretraživanje. Ti čimbenici mogu uključivati ​​fizičku lokaciju korisnika, povijest pregledavanja i društvene postavke itd. I dok se dva SERP-a mogu činiti identična i mogu sadržavati mnogo istih rezultata, često će sadržavati suptilne razlike.

Davatelji tražilice poput Googlea, Binga ili drugih igrača neprestano razvijaju svoje usluge i tehnologije i eksperimentiraju sa njihovim rezultatima. Njihov je cilj pružiti svojim korisnicima još brže i intuitivnije iskustvo. Kako se u prostor za pretraživanje uvode nove tehnologije - i one su zadivljujućim tempom, izgled SERP-a se mijenja i danas se prilično razlikuju od nekadašnjih.

Organski rezultati

SERP obično sadrže dvije vrste sadržaja: organske rezultate i plaćene rezultate. Organski rezultati su popisi web stranica koje se prikazuju kao rezultat algoritma tražilice. Više o tome u trenu. Optimizacija za tražilice, odnosno SEO, je znanost - ili je to više umjetnost - manipuliranje sadržajem kako bi se tražilice navelo na uvrštavanje na naše web mjesto za određenu ključnu riječ ili niz pretraživanja.

O algoritmima pretraživanja i rangiranju signala

Dakle, natrag do organskih rezultata. Ukratko, to su popisi koje je indeksirala tražilica na temelju niza faktora koji se zajedno nazivaju "signali rangiranja". Na primjer, algoritam za pretraživanje koji upotrebljava Google sadrži stotine faktori rangiranja. Pružatelji tražilica obično čuvaju u tajnosti detalje njihovog sustava rangiranja. Dakle, iako nitko izvan Googlea - a možda i ne toliko ljudi unutra - točno zna što su signali za rangiranje, neki se smatraju važnijima od drugih.

Zašto koristiti SERP API?

Postoji nekoliko razloga zbog kojih bi itko imao koristi za SERP API. Postoji očita potreba za povremenim pronalaženjem SERP podataka za vaše proizvode i web stranice i praćenje ih tijekom vremena, jer je to bitan dio svake SEO strategije. S rangom koji se stalno mijenja i ključne riječi za pretraživanje postaju manje ili više primjenjive i vrijedne s vremenom, postoji samo jedan način da ostanete na vrhu tih Promjene, a to je korištenje gotovog softverskog softvera kao usluge (SaaS) koji implementira SERP podatke izravno u vlastite aplikacije ili web stranice koristeći SERP API poput Serpstack.

Ukratko, glavna razlika između korištenja preglednika za preuzimanje SERP podataka i upotrebe SERP API-ja kao što je Serpstack je format odgovora. Serpstack API će vratiti JSON podatke koje lako analizira vaš interni softver. Pomoću nje oslobađate potrebu za vađenjem značajnih podataka iz svih okolnih web formata.

Predstavljamo Serpstack

U jednoj rečenici Serpstack je API-ja rezultata Google pretraživanja u stvarnom vremenu i točan. Pouzdane od nekih od najvećih svjetskih marki, ovaj JSON REST API munjevito je brz i jednostavan za upotrebu. Proizvod proizvodi i održava apilayer, softverska tvrtka sa sjedištem u Londonu, Ujedinjenom Kraljevstvu i Beču, Austrija. Izvorno stvoren iz unutarnje potrebe za automatskim praćenjem pozicija tražilice, proizvod je postao jedan od najpouzdanijih SERP API-ova koji su dostupni na tržištu. Što se tiče apilayera, ovo je tvrtka koja stoji iza nekih od najpopularnijih API-ja i SaaS proizvoda širom svijeta, uključujući Currencylayer, Invoicely i Eversign.

Serpstack API automatski preuzima SERP podatke s tražilica pomoću proxy mreže i vlastite tehnologije struganja, kad god se postave zahtjevi API-ja. Dobiveni podaci SERP-a su javno dostupni i svatko im može pristupiti. Nadalje, Serpstack API podržava gotovo sve vrste rezultata pretraživanja koje je vratio Google, uključujući i web rezultati, rezultati slike, video rezultati, rezultati vijesti, rezultati kupovine, sponzorirani oglasi, pitanja i još mnogo toga više.

Izgrađen na vrhu oblačne infrastrukture apilayera, sustava na kojem rade neke od najpopularnijih svjetskih API usluga u stvarnom vremenu, API Serpstack visoko je skalabilan i fleksibilan u bilo kojoj fazi. Izgrađen je tako da nudi način brisanja Google SERP podataka u stvarnom vremenu i u bilo kojem opsegu. Provedba usluge traje samo nekoliko minuta koristeći jednostavnu strukturu HTTP GET URL-a, a rezultati se vraćaju u JSON ili CSV formatu.

Glavne značajke Serpstack-a

Izvrsno, Serpstack API ne ostavlja ništa što želi. Prvo i najvažnije, usluga je visoko skalabilna i uvijek neuredna. Apilayerova moćna infrastruktura u oblaku jednostavno je izgrađena tako da može podnijeti zahtjeve API-ja velike količine bez potrebe za redom. To je bio srž nekoliko proizvoda tvrtke. Također je vrlo prilagodljiv. Budući da nijedna dva kupca nemaju identične potrebe, možete prilagoditi automatske upite pretraživanja na temelju niza opcija, uključujući lokaciju, jezik, uređaj i još mnogo toga.

Upotreba ovog proizvoda je zabrinuta zbog globalnih IP-ova, klastera preglednika ili CAPTCHA-ova. Zahvaljujući a moćna temeljna proxy mreža, ovaj program za struganje iz SERP-a prilično vas pokriva situacija. A lako je i u proračunu. Dobivate do 100 mjesečnih zahtjeva besplatno i, ako vam treba više od toga - i to ćete najvjerovatnije - plaćeni planovi počinju od samo 29,99 USD mjesečno. Uskoro ćemo detaljnije pokriti cijene proizvoda.

Evo pregleda nekih najvažnijih značajki proizvoda:

Jednostavna integracija

Korištenje Scrapestack API-ja teško može biti lakše od samog početka. Potrebno je samo nekoliko minuta za kreiranje prilagođenih upita i započinjanje struganja SERP stranica na bilo kojoj skali pomoću prilagođenih lokacija, uređaja, jezika i više.

Visoka razina sigurnosti

Svi protoci podataka poslani i primljeni iz API Serpstack šifrirani su pomoću 256-bitne SSL enkripcije. To je ista vrsta osiguranja koju koriste bankarske web stranice ili većina platformi za e-trgovinu. Možete biti sigurni da će vaši podaci ostati zaštićeni.

Neporediva brzina i dostupnost

Uz gotovo savršen rezultat dostupnosti, možete biti sigurni da će Scrapestack API biti tamo kada vam zatreba. A apilayer nikad ne ugrožava brzinu. API zahtjevi poslani u API obrađuju se u nekoliko milisekundi. Naravno, koliko brzo dođu rezultati ovisi i o Googleovim vremenima odgovora.

Izbor izlaznih formata

Da bi podnošenje tužbe SERP podataka bilo još lakše, Serpstack jednostavan za korištenje REST API nudi izbor JSON ili CSV odgovora. To ga čini kompatibilnim s bilo kojim programskim jezikom.

Podrška svjetske klase

Često se kaže da je proizvod dobar samo koliko i njegova struktura tehničke podrške. Opet, ovo je mjesto gdje Scrapestack sjaji. Ako imate bilo kakvih tehničkih pitanja, na raspolaganju vam je obučen tim stručnjaka koji će vam pomoći u bilo kojem zahtjevu. Odziv je brz i usluga djeluje prilično dobro.

Opsežna dokumentacija

Jednako važna kao podrška, Dokumentacija će vam često biti osnovni način učenja kako koristiti proizvod. Serpstack nudi opsežnu dokumentaciju o API-ju koja čeka da bude istražena. Pomoću njega pokrenut ćete u roku od samo nekoliko minuta i učinit ćete stručnjakom za nekoliko dana, a ne tjedana ili mjeseci.

Korištenje Serpstacka

Dosta se hvalimo s odličnim značajkama proizvoda - a uistinu jesu, pogledajmo kako možete zapravo koristite proizvod i različite vrste zahtjeva koje možete uputiti i odgovarajuće odgovore mogu očekivati.

Osnove

Da biste upotrebljavali API Serpstack, najprije se morate prijaviti na račun. Ovo je besplatno, a kao rezultat toga dodijelit će vam se jedinstveni pristupni ključ API-ja. Ovo je ono što ćete od sada koristiti za provjeru autentičnosti s API-jem putem jednostavnih HTTP GET zahtjeva za pristup bilo kojoj od dostupnih krajnjih točaka. Dakle, da biste koristili API jednostavno morate dodati API ključ osnovnom URL-u pomoću gumba "pristupni ključParametar. Evo kako izgleda tipičan - iako vrlo jednostavan i potpuno beskoristan - zahtjev:

http://api.serpstack.com/search? access_key = YOUR_ACCESS_KEY

Radi dodatne sigurnosti, svi plaćeni planovi omogućavaju upotrebu 256-bitne SSL enkripcije. Da biste ga koristili, sve što trebate je slanje HTTPS zahtjeva umjesto HTTP zahtjeva. Na primjer, gornji primjer s enkripcijom postao bi:

https://api.serpstack.com/search? access_key = YOUR_ACCESS_KEY

Kad god API zahtjev ne uspije, API Serpstack vratit će JSON objekt koji sadrži detalje o pogrešci. Na primjer, evo što bi API mogao vratiti ako je dosegnuto ili prekoračeno najveće dopušteno ograničenje zahtjeva za API. Svaki pretplatni plan ima različito ograničenje broja zahtjeva koji mogu podnijeti.

{"success": false, "error": {"code": 104, "type": "use_limit_reached", "info": "Dosegnut je vaš mjesečni volumen zahtjeva za API. Nadogradite svoj plan. "}}

Zahtjev i parametri API-ja

Ako nije drugačije navedeno, API Serpstack uvijek će zadati isporučivanje Google rezultata pretraživanja. Stoga, ako želite pitati API za rezultate Google pretraživanja, sve što trebate učiniti je dodati „pitanje"Za API-jev osnovni URL i postavite ga na upit za pretraživanje po vašem izboru. Evo kako upit koji upotrebljava "mcdonalds" kao pojam za pretraživanje izgleda s autentifikacijom i šifriranjem:

https://api.serpstack.com/search? access_key = YOUR_ACCESS_KEY & query = mcdonalds

Kao što vidite, ovo je prilično jednostavna sintaksa. Postoji, kao što ste sigurno zamislili, niz neobveznih parametara koji se mogu dodati zahtjevu za daljnjim sužavanjem rezultata pretraživanja. Istražit ćemo ih nekoliko u trenu, ali detaljan popis svih njih dostupan je u internetskoj API dokumentaciji.

Odgovori API-ja

Odgovori koje ćete dobiti iz API-ja Serpstack uvelike će ovisiti o vašem upitu pretraživanja i parametrima koje odaberete. Osnovni upit bez navedenog filtriranja vratit će tonu podataka. Evo prvog dijela odgovora koji ćete dobiti od gornjeg primjera.

{"zahtjev": {"uspjeh": istina, "obrađeni_timestamp": 1566207832, "search_url": " https://www.google.com/search? q = mcdonalds "," total_time_taken ": 1.5}," search_parameters ": {" engine ":" google "," query ":" mcdonalds "," type ":" web "," device ":" desktop ", "google_domain": "google.com", "hl": "en", "gl": "nas", "stranica": "1", "num": "10"}, "search_information": {"total_results ": 759000000, "time_taken_displayed": 0,91, "did_you_mean": null, "shows_results_for": null, "query_displayed": "mcdonalds", "dete_location": null, "no_results_for_original_query": false},

Svrha gornjeg uzorka je upravo dati vam predstavu o tome kako mogu izgledati rezultati. Uključio sam samo prvih 25 redaka odgovora, koji je u cjelini dugačak više od četristo redaka.

Kao što ste primijetili kada koristite Google pretraživanje, tipična stranica rezultata pretraživanja ima različite odjeljke, pri čemu svaki prikazuje drugačiju vrstu rezultata. Plaćaćete rezultate oglasa, organske rezultate, slike, videozapise itd. Nadalje, vrpca na vrhu stranice omogućit će vam prikazivanje određenih vrsta rezultata kao što su karte, vijesti, kupovina ili knjige, samo da nabrojite nekoliko. Različiti neobvezni parametri omogućit će vam određivanje vrste rezultata pretraživanja koja vas zanima, što će raščlaniti rezultirajuću JSON datoteku mnogo jednostavnije. Pogledajmo dublje neke od različitih vrsta rezultata koje možete dobiti.

Rezultati oglasa

Kad god postoje sponzorirani oglasi za vaš upit za pretraživanje - a najčešće ih bude, API odgovor dolazi s objektom oglasa. Sadrži sve oglase redoslijedom kojim su prikazani u rezultatu pretraživanja. Uključuju oba oglasa koja se prikazuju pri vrhu i na dnu rezultata pretraživanja.

Organski rezultati

Rezultati organskog pretraživanja glavni su rezultati pretraživanja koje nudi Google, a vjerojatno će oni biti posebno zainteresirani. Određuje ih niz čimbenika, poput mrežnog prometa, povratnih veza, prisutnosti društvenih medija i još mnogo toga, uz točan algoritam koji Google drži u tajnosti kako bi zadržao svoju konkurentsku prednost. API te detalje raščlanjuje na rezultate i vraća ih kao "organic_results”.

Rezultati slike

Kao što postoje dva načina za dobivanje rezultata slike iz Google pretraživanja, API može vratiti slike na dva načina. Kada obavljate standardnu ​​internetsku pretragu, Google nudi neke slike u rezultatima pretraživanja. Ove slike - koje se nazivaju umetnute slike - Scrapestack API vraća unutar "inline_images"Niz.

"image_results": [{"položaj": 1, "naslov": "McDonald's Gold Card: Istinita priča ...", "širina": 1024, "visina": 683, "image_url": " https://www.rd.com/wp-content/uploads/2017/12/the-true-story-behind-the-mysterious-mcdonalds-gold-card-673955074-Vytautas-Kielaitis-1024x683.jpg", "type": "png", "url": " http://rd.com", "izvor": " https://rd.com" }, {"položaj": 2, "naslov": "McDonald's - Wikipedia", "širina": 1200, "visina": 1051, "image_url": " https://upload.wikimedia.org/wikipedia/commons/thumb/3/36/McDonald%27s_Golden_Arches.svg/1200px-McDonald%27s_Golden_Arches.svg.png", "type": "png", "url": " https://en.wikipedia.org/wiki/McDonald%27s", "izvor": " https://en.wikipedia.org" }, {"položaj": 3, "naslov": "Najbolje nove stavke globalnog izbornika ...", "širina": 970, "visina": 545, "image_url": " https://assets3.thrillist.com/v1/image/2825587/size/gn-gift_guide_variable_c.jpg", "type": "png", "url": " https://thrillist.com/", "izvor": " https://thrillist.com" } ]

Ako se s druge strane slike pretražuju posebno, s parametrom tipa postavljenim na slike, slike se vraćaju kao "image_results"Niz. U tim situacijama API vraća 100 slika prema zadanim postavkama.

Rezultati videozapisa

Potpuno ista razmatranja koja smo upravo preuzeli za slike vrijede i za video rezultate uz dostupnost oba umetnuta videozapisa uz rezultate globalnog pretraživanja ili namjenskih video rezultata

Možemo nastaviti sa stranicama i dati vam detaljne informacije o različitim vrstama rezultata koje API Serpstack može vratiti, ali mislimo da dobivate sliku. Dovoljno je reći da su bilo koje vrste rezultata koje vraća tipična Google pretraga također dostupni u odgovoru API-ja. Pored već opisanih vrsta rezultata, API će se vratiti, rezultati vijesti, rezultati kupovine i lokalni rezultata kao i sadržaj okvira za odgovore na stranici s rezultatima, vremenske okvira, događanja, vrtiljaka, najboljih priča itd.

Podržana programska okruženja

Jedna od najboljih stvari u vezi sa Serpstack API-jem je što ga možete lako koristiti iz većine okruženja, Bez obzira na to koji jezik koristite, sve dok možete slati HTTP zahtjeve dobro je ići. Svi popularni web jezici kao što su PHP ili Python su podržani. U stvari, dokumentacija API-ja uključuje primjere kako se koriste iz PHP-a, Pythona, Nodejs-a, jQuery-ja, Go i Ruby-a.

Ovdje je, na primjer, PHP kôd za ispis ukupnog broja rezultata pretraživanja, kao i svaki organski rezultat pretraživanja koji je vratio Serpstack API.

$ queryString = http_build_query (['access_key' => 'YOUR_ACCESS_KEY', 'upit' => 'mcdonalds',]); $ ch = curl_init (sprintf ('% s?% s', ' https://api.serpstack.com/search', $ Upitnog niza)); curl_setopt ($ ch, CURLOPT_RETURNTRANSFER, istina); $ json = curl_exec ($ ch); curl_close ($ CH); $ api_result = json_decode ($ json, istina); echo "Ukupni rezultati:", $ api_result ['search_information'] ['total_results'], PHP_EOL; foreach ($ api_result ['organic_results'] kao $ number => $ rezultat) {echo "{$ number}. {$ result ['title']} ", PHP_EOL; }

Evo nekoliko koda za postizanje iste stvari u Pythonu:

import zahtjeva params = {'access_key': 'YOUR_ACCESS_KEY', 'query': 'mcdonalds'} api_result = questions.get (' https://api.serpstack.com/search', params) api_response = api_result.json () ispis "Ukupno rezultata:", api_response ['search_information'] ['total_results'] za broj, rezultira nabrajanjem (api_response ['organic_results'], start = 1): ispis "% s. % s "% (broj, rezultat ['naslov'])

Cijene i planovi

Dostupan je API Serpstack pod nekoliko planova ovisno o vašim potrebama. Najosnovniji plan je Slobodan plan. Kao što mu ime kaže, besplatan je, ali iako nije vremenski ograničen poput tipičnih probnih verzija, ograničen je na značajke, kao i upotreba ograničena. Moći ćete pokrenuti samo do 100 pretraživanja mjesečno.

Sljedeće su tri razine sa punim značajkama i razlikuju se samo prema maksimalnom broju mjesečnih pretraživanja koja ste dozvoljeni u pokretanju. Osnovni plan će vam dati 5000 za 29,99 USD mjesečno, poslovni plan 99,99 USD mjesečno donosi i do 20 000, a plan programa Business Pro omogućuje pokretanje nevjerojatnih 50 000 pretraživanja za 199,99 dolara mjesečno. Ako vam nijedan od tih planova ne odgovara, postoji i Enterprise plan različitog cijene koji se može prilagoditi vašim potrebama. Ako odaberete godišnje naplate umjesto mjesečne, imate pravo na 20% popusta, što uslugu čini još pristupačnijom.

Završavati

Ukratko, API Serpstack jednostavan je proizvod s punim značajkama jednostavan za korištenje koji možete dobro iskoristiti kad god trebate dohvatiti SERP podatke s Googlea. Njegovo vrijeme zvijezde i impresivno vrijeme odziva neke su od najboljih stvari. Potpomognut programom apilayer koji nam je donio i druge izvrsne API-ove, sigurni smo da će ovaj pružiti očekivane rezultate. Ovo je proizvod koji možemo samo preporučiti.