Hoppa till huvudinnehåll
Google SERP (Search Engine Results Page) är resultatsidan som användare ser efter att ha angett en sökning i Googles sökmotor. Den visar organiska sökresultat, annonser, utvalda utdrag, kunskapsgrafer samt olika typer av innehåll som bilder och videor, i syfte att ge användare den mest relevanta informationen. Den här artikeln kommer att introducera Google SERP API i detalj. Det kan tillhandahålla resultat för sökningar som anges i Googles sökmotor, och innehållet i resultaten omfattar också många typer, såsom utvalda utdrag, kunskapsgrafer och bilder samt andra typer av resultat. Det här dokumentet kommer att introducera integrationsinstruktionerna för Google SERP API.

Ansökningsprocess

För att använda Google SERP API går du först till Ace Data Cloud-konsolen för att hämta din API Token och spara den för senare användning. Om du ännu inte är inloggad eller registrerad omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. När detta är klart återgår du automatiskt till den aktuella sidan. En API Token kan användas för att anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Vid den första ansökan får du kostnadsfria krediter för att prova tjänsten gratis; när krediterna inte räcker till kan du fylla på det gemensamma saldot i konsolen.
📘 Fullständig dokumentation: Google SERP API →

Grundläggande användning

Ange nyckelord och typen av sökresurs för att få resultat: använd query för att skicka nyckelord och type för att välja söktyper som webbsidor, bilder och nyheter; det här gränssnittet kräver inte att model skickas. Till exempel, för att söka efter information om ”apple inc” kan vi sedan fylla i motsvarande innehåll i gränssnittet, som visas på bilden:

Här kan vi se att vi har angett Request Headers, inklusive:
  • accept: vilket format av svar du vill ta emot. Här anges application/json, alltså JSON-format.
  • authorization: nyckeln för att anropa API:t, som kan väljas direkt från rullgardinsmenyn efter ansökan.
Dessutom har Request Body angetts, inklusive:
  • type: typen av sökresurs. För närvarande stöds endast sex typer, och standardvärdet är search.
  • query: sökordet.
  • country: landet där de anpassade sökresultaten ska visas, standardvärdet är USA (US).
  • language: språket för de anpassade sökresultaten, standardvärdet är engelska (en).
  • range: tidsintervallet för de anpassade sökresultaten, standardvärdet är obegränsat.
  • number: sidstorleken för pagineringen av de anpassade sökresultaten, standardvärdet är 10.
  • page: sidnumret för pagineringen av de anpassade sökresultaten, standardvärdet är 1.
Efter valet kan du se att motsvarande kod också har genererats till höger, som visas på bilden:

Klicka på knappen ”Try” för att testa. Som visas i bilden ovan får vi här följande resultat:
De returnerade resultaten innehåller flera fält, som beskrivs nedan:
  • knowledge_graph, kunskapsgrafen för sökresultaten.
  • organic, detaljerad information om sökresultaten.
  • people_also_ask, frågor relaterade till sökordet.
  • related_searches, relaterade sökningar för sökordet.
Det går att se att de returnerade resultaten här innehåller ett fält organic, som huvudsakligen innehåller resultaten för sökordet. Om du dessutom vill generera motsvarande integrationskod kan du kopiera den direkt för att generera den, exempelvis är CURL-koden följande:
Python-integrationskoden är följande:

Anpassad söktyp

Om du anpassar typen av sökresurs kan vi ändra parametern type, som omfattar vanliga resurser search, bildresurser images, nyhetsresurser news, kartresurser maps, platsresurser places och videoresurser videos. I den här artikeln använder vi videoresursen videos som ett exempel. Nedan visar vi den specifika åtgärden. Ställ först in parametern type på videos och skicka parametern query normalt, som visas i bilden:

Motsvarande kod är följande:
Följande svar kan erhållas:
Det returnerade resultatet innehåller flera fält, som beskrivs nedan:
  • news, lista med videoinformation i sökresultaten.
Det kan ses att det returnerade resultatet här har ett fält videos, som huvudsakligen innehåller resultaten för söknyckelorden.

Anpassa landet där sökresurserna finns

Detta gränssnitt stöder också begränsning av landet där sökresultaten finns. Vi kan lägga till parametern country för att begränsa landet, och den inmatade parametern är landets förkortning, till exempel cn (China), us (United States). I denna artikel används China som följande exempel, nedan finns den specifika informationen:

Uteffekten är följande:
Man kan se att resultaten är sökresultat i landet Kina, och det specifika innehållet liknar ovanstående.

Anpassat språk för sökresultat

Vi kan också anpassa språket för sökresultaten. Här lägger vi dessutom till fältet language med innehållet zh-cn, där det avser språket förenklad kinesiska. Andra språk stöds också, men du måste ange språkets förkortning, till exempel språk som en (English), fr (French), zh-cn (Chinese (Simplified)), som visas i bilden:

Motsvarande kod är följande:
Körresultatet är följande:
Det går att se att resultaten som visas här alla är på förenklad kinesiska, och innehållet i resultaten liknar det ovan.

Anpassa sökresultatens tidsintervall

I den här artikeln kan man även anpassa tidsintervallet för sökresultaten, vilket omfattar fem typer: qdr:h (senaste timmen), qdr:d (senaste dagen), qdr:w (senaste veckan), qdr:m (senaste månaden) och obegränsat som standard. Vi behöver bara skicka motsvarande tidsintervall via range, till exempel ställs det här in på qdr:d, vilket innebär att resultat från det senaste dygnet söks, så inmatningen är följande:

Motsvarande kod är följande:
Körresultatet är följande:
Som man kan se har vi framgångsrikt fått sökresultaten från det senaste dygnet, och innehållet i resultaten liknar det ovan.

Anpassad paginering av sökresultat

Detta API stöder även anpassad sidindelad visning av sökresultat. number och page anger sidstorleken och sidnumret för pagineringen. I den här artikeln ställs det in så att varje sida innehåller 20 sökresultat för sidindelad visning. Den specifika informationen visas i figuren:

Obs: När resultaten per sida överstiger 10 fördubblas antalet avdragna poäng.
Koden är följande:
Körningsresultatet är som följer:
Det kan ses att sökresultaten här visas med sidindelning, med 20 resultat per sida, och innehållet i resultaten liknar det ovan.