SerpApi

SerpApi aracılığıyla gerçek zamanlı arama motoru sonuçları. Proxy'leri, CAPTCHA'ları veya ayrıştırıcıları yönetmeden Google, Bing, YouTube, Google Akademik ve daha fazlasını kazıyın. SerpApi, iş akışlarınızın temiz, yapılandırılmış JSON alması için altyapıyı işler.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Service	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD)

Contact
İsim	SerpApi
URL	https://serpapi.com
E-posta	support@serpapi.com

Bağlayıcı Meta Verileri
Publisher	SerpApi
Web Sitesi	https://serpapi.com
Gizlilik ilkesi	https://serpapi.com/legal/privacy
Kategoriler	Web sitesi; İş Zekası

SerpApi

SerpApi, gerçek zamanlı bir arama motoru sonuçları API'sidir. Proxy'leri, CAPTCHA'ları ve ayrıştırma işlemlerini işler, böylece Power Apps ve Power Automate akışlarınız herhangi bir kazıma altyapısı yönetmeden temiz, yapılandırılmış JSON alır.

Publisher: SerpApi

Prerequisites

Bir SerpApi hesabı. serpapi.com kaydolun.
Geçerli bir SerpApi API anahtarı. Ücretsiz planlar ayda 250 arama içerir. Ücretli planlar daha yüksek hacimli olarak kullanılabilir.

Desteklenen İşlemler

Google Search (`GoogleSearch`)

Belirli bir sorgu için yapılandırılmış Google Search sonuçlarını alın. Organik sonuçlar, reklamlar, bilgi grafiği girdileri, ilgili sorular, yerel sonuçlar, en iyi öyküler ve daha fazlasını döndürür. Döndürülen alanların tam değeri sorguya ve Google'ın bu sorgu için ne ortaya çıkar olduğuna bağlıdır.

Konumları Al (`GetLocations`)

Aramanın parametresine location geçirilebilen desteklenen coğrafi konumların listesini döndürür. Arama çalıştırmadan önce bir şehir veya bölgenin tam konum dizesini aramak için bunu kullanın.

Hesap Bilgilerini Al (`GetAccount`)

Geçerli planınız, aylık arama kotanız, kalan aramalar ve saatlik kullanım istatistikleri dahil olmak üzere SerpApi hesabınızla ilgili bilgileri döndürür.

Kimlik Bilgilerini Alma

serpapi.com'da SerpApi hesabınızda oturum açın.
serpapi.com/manage-api-key gidin.
API anahtarınızı kopyalayın.
Power Apps veya Power Automate bağlantı oluştururken API anahtarınızı API Anahtarı alanına yapıştırın.

API anahtarınız Power Platform tarafından güvenli bir şekilde depolanır ve her isteğe otomatik olarak eklenir. Bağlantı kurulduktan sonra yeniden sağlamanız gerekmez.

Getting Started

Temel kullanım

Eylem, GoogleSearch gerekli bir bağımsız değişken (arama sorgusu) ve ek parametrelerin isteğe bağlı bir kaydını alır:

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

Ham JSON yanıtını hata ayıklamaya yönelik bir HTML Metin denetiminde görüntülemek için:

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

İsteğe bağlı parametreleri geçirme

İsteğe bağlı parametreler kayıt olarak geçirilir (ikinci bağımsız değişken). Yalnızca ayarlamak istediğiniz parametreleri ekleyin; anahtarın atlanması bu parametre için hiçbir şey göndermez ve SerpApi'nin kendi varsayılanını kullanmasına izin verir.

Aşağıdaki örnekte, giriş türleri ve adları zorunlu değil önerilerdir.

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

Denetim türü eşlemesi:

Parametre türü	Önerilen Power Apps denetimi	Değer başvurusu
Metin (dize)	Metin Girişi	`controlName.Text`
Boolean	Geçiş veya Onay Kutusu	`controlName.Value`
Sabit listesi (sabit seçenekler)	Açılan Liste	`controlName.Selected.Value`
Sayı	Metin Girişi	`controlName.Text`

Yanıt verilerine erişme

Yanıt bir JSON nesnesidir. Üst düzey özelliklere doğrudan değişkenden erişin:

varJsonResponse.search_information.total_results

Galeriyi organik sonuçlara bağlamak için:

varJsonResponse.organic_results

Galeriyi yerel iş sonuçlarına bağlamak için:

varJsonResponse.local_results.places

Yanıt alanlarının tam listesi için SerpApi Google Search belgelerine bakın .

Geçerli bir konum dizesi arama

konumuna geçirecek tam konum adını bulmak için GetLocationskullanınGoogleSearch. q parametresi şehir veya bölge adına göre filtre uygular ve limit döndürülen sonuç sayısını kaplar.

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

Sonuçları bir Galeriye bağlamak için:

varLocations

Koleksiyondaki her öğenin , , name, , , canonical_nameve country_code alanları vardırtarget_type. reachgps canonical_name Sonraki bir location çağrıda değeri parametre olarak GoogleSearch geçirin:

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

Hesap kullanımını denetleme

Geçerli plan ayrıntılarınızı ve kota kullanımınızı almak için kullanın GetAccount . Bu, aylık sınırınıza erişmeden önce kaç aramanın kaldığını denetlemek için kullanışlıdır.

Set(varAccount, SerpApi.GetAccount())

Yanıt dışında tek tek alanlara erişin:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Yanıt alanlarının tam listesi için SerpApi Hesabı API'si belgelerine bakın .

Bilinen Sorunlar ve Sınırlamalar

Değişken yanıt yapısı: Google Search yanıtında bulunan alanlar, sorguya ve Google'ın bunun için ne döndürdüğüne bağlıdır. Her yanıtta tüm alanlar görünmez. Olası yanıt alanlarının tam açıklaması için SerpApi Google Search belgelerine bakın .
Hız sınırları: İstekler, SerpApi planınızın aylık kotasına ve saatlik hız sınırına tabidir. İki durumdan birini aşmak hata 429 yanıtına neden olur.
Önbelleğe alınan sonuçlar: Varsayılan olarak, SerpApi her kullanıcıya özgü yinelenen istekler (1 saate kadar eski) için önbelleğinden sonuçlar sağlar. no_cache Yeni bir sonucu zorlamak için parametresini kullanın. Önbelleğe alınan aramaların aylık kotanıza göre sayılmadığını unutmayın.

Support

Bu bağlayıcı veya SerpApi hesabınızla ilgili yardım için SerpApi destek ekibine başvurun:

EmailEmail:contact@serpapi.com
Canlı sohbet: Serpapi.com'de 7/24 kullanılabilir ve burada Doğrudan SerpApi destek ekibinin bir üyesiyle konuşabilirsiniz.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:


Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Zorunlu
API Anahtarı	securestring	SerpApi API anahtarınız. Şu konumda bulabilirsiniz: https://serpapi.com/manage-api-key	True

Eylemler

Google Search	Belirli bir sorgu için yapılandırılmış Google Search sonuçlarını alın. Organik sonuçları, reklamları, bilgi grafiğini, ilgili soruları, en önemli hikayeleri, yerel sonuçları ve daha fazlasını döndürür.
Hesap Bilgilerini Al	Plan ayrıntıları, kalan aramalar ve kullanım istatistikleri dahil olmak üzere kimliği doğrulanmış SerpApi hesabı hakkındaki bilgileri döndürür.
Konumları Al	Aramada location parametresiyle kullanılabilecek desteklenen coğrafi konumların listesini döndürür. Bir şehir veya bölge için tam konum dizesini bulmak için kullanışlıdır.

Google Search

İşlem Kimliği:: GoogleSearch

Belirli bir sorgu için yapılandırılmış Google Search sonuçlarını alın. Organik sonuçları, reklamları, bilgi grafiğini, ilgili soruları, en önemli hikayeleri, yerel sonuçları ve daha fazlasını döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Arama Sorgusu	q	True	string	Arama sorgusu. Tüm standart işleçleri (ör. site:, inurl:, intitle:) ve as_dt ve as_eq gibi gelişmiş parametreleri destekler.
Konum	location		string	Aramanın kaynaklandığı konum. En iyi doğruluk için şehir düzeyinde belirtin (örneğin, Austin, Texas). Uule, lat veya lon parametreleriyle birlikte kullanılamaz. Desteklenen konumlar için lütfen bakın https://serpapi.com/locations-api .
Kodlanmış Konum (UULE)	uule		string	Google'ın kodlanmış konum dizesi. Tam coğrafi konum için konum parametresine alternatif olarak kullanın. Konum, lat, lon veya yarıçap ile birlikte kullanılamaz.
Enlem	lat		number	Arama kaynağı için GPS enlemi. lon parametresi kullanılırken gereklidir. Konum veya uule ile birlikte kullanılamaz.
Boylam	lon		number	Arama kaynağı için GPS boylamı. lat parametresi kullanılırken gereklidir. Konum veya uule ile birlikte kullanılamaz.
Yarıçap (metre)	radius		integer	Arama sonuçlarının sapmak için metreler içinde uzaklık. Bu bölge içindeki sonuçlar daha yüksek sıralanır. Konum veya lat/lon ile birlikte kullanılabilir. Maksimum yarıçap: Masaüstünde 199 m; Tablet veya mobil cihazlarda 1000 m. Uule ile birlikte kullanılamaz.
Google Domain	google_domain		string	Kullanılacak Google etki alanı (örneğin, google.com, google.co.uk, google.fr). Varsayılan olarak google.com. Tam liste için bkz https://serpapi.com/google-domains .
Country	gl		string	Arama için iki harfli ülke kodu (ör. biz, gb, fr, de). Tam liste için bkz https://serpapi.com/google-countries .
Language	hl		string	İki harfli arabirim dil kodu (en, es, fr, de gibi). Tam liste için bkz https://serpapi.com/google-languages .
Ülke Kısıtlaması	cr		string	Sonuçları belirli ülkelerden gelen belgelerle kısıtlayın. \| ile ülke{CODE} biçimini kullan sınırlayıcı olarak (örn. countryFR\|countryDE).
Dil Kısıtlama	lr		string	Sonuçları belirli dillerle kısıtlayın. \| ile lang_{code} biçimini kullan sınırlayıcı olarak (örneğin, lang_fr\|lang_de).
Gelişmiş Arama Filtresi	tbs		string	Gelişmiş arama filtresi (aranacak). Tarih aralığına, içerik türüne ve daha fazlasına göre filtrelemeyi etkinleştirir (örneğin, geçen gün için qdr:d, geçen hafta için qdr:w).
Güvenli Arama	safe		string	Yetişkinlere yönelik içerik filtreleme düzeyi. Filtrelemeyi etkinleştirmek için etkin olarak veya devre dışı bırakmak için kapalı olarak ayarlayın.
Otomatik Düzeltilen Sonuçları Dışla	nfpr		integer	Özgün sorgu yanlış yazıldığında sonuçları otomatik olarak düzeltilen sorguların dışında tutmak için 1 olarak ayarlayın. Bunları dahil etmek için 0 olarak ayarlayın (varsayılan).
Yinelenen İçerik Filtresi	filter		integer	Benzer Sonuçlar ve Atlanmış Sonuçlar filtrelerini denetler. Etkinleştirmek için 1 (varsayılan) veya devre dışı bırakmak için 0 olarak ayarlayın.
Arama Türü	tbm		string	Gerçekleştirilecek Google araması türü (eşleştirilecek). Normal bir web araması için atla.
Sonuç Uzaklığı	start		integer	Sayfalama uzaklığı. Verilen sonuç sayısını atlar. 0 ilk sayfayı, 10 ise ikinci sayfayı vb. döndürür.
Device	device		string	Benzetimi yapılan cihaz türü. Masaüstü (varsayılan), tablet veya mobil kullanın.
Önbelleği Atla	no_cache		boolean	Yeni bir sonucu zorlamak için, SerpApi'nin 1 saatlik önbelleğini atlayarak true olarak ayarlayın. Önbelleğe alınmış aramalar ücretsizdir ve aylık kotanıza göre sayılmaz. Zaman uyumsuz ile birlikte kullanmayın.
Zaman Uyumsuz Mod	async		boolean	Arama göndermek ve sonuçları zaman uyumlu olarak beklemek yerine Daha sonra Arama Arşivi API'sinden almak için true olarak ayarlayın. no_cache ile birlikte kullanmayın.
Çıkış Biçimi	output		string	Çıkış biçimi. Yapılandırılmış JSON için json (varsayılan) veya ham HTML için html olarak ayarlayın. Hata ayıklama için veya henüz tam olarak desteklenmeyen sonuç türleri için html kullanın.
Yer CID	ludocid		string	Belirli bir yerin Google CID (müşteri tanımlayıcısı). Yerel sonuçlarda place_id olarak bulunur. Bir yerin bilgi grafiğini almak için kullanılır.
Bilgi Grafiği Kimliği	kgmid		string	Bir Google Bilgi Grafiği varlığının KGMID'i. Başlangıç dışındaki diğer arama parametrelerini geçersiz kılabilir.
Yerel İmza (lsig)	lsig		string	Yerel bir yer için bilgi grafiği harita görünümünü zorlamak için kullanılır. Yerel Paket API'sini veya Google Yerel API'sini kullanarak edinin.
Önbelleğe Alınmış Arama Parametreleri (si)	si		string	Bilgi Grafiği sekmeleri için önbelleğe alınmış şifrelenmiş arama parametreleri. Başlangıç dışındaki diğer arama parametrelerini geçersiz kılabilir.
Düzen Genişletme (ibp)	ibp		string	Google sonuçlarında düzen genişletmelerini denetler (örn. gwp; 0,7).
Filtre Dizesi (uds)	uds		string	Sonuç filtreleme için Google tarafından sağlanan filtre dizesi.
Sıfır İzleme	zero_trace		boolean	Yalnızca kurumsal hesaplar. Arama parametrelerinin ve meta verilerin sunucu tarafı depolamasını atlamak için true olarak ayarlayın.

Döndürülenler

Name	Yol	Tür	Description
search_metadata	search_metadata	object	Durum, zamanlama ve SerpApi tanımlayıcıları dahil olmak üzere arama isteğiyle ilgili meta veriler.
search_parameters	search_parameters	object	Bu arama için kullanılan parametreler istekten geri yankılandı.
search_information	search_information	object	Arama hakkında toplam sonuç sayısı ve geçen süre gibi üst düzey bilgiler.
organic_results	organic_results	array of object	Google tarafından döndürülen standart organik web sonuçları.
items	organic_results	object
Reklam	ads	array of object	Organik sonuçların üstünde veya altında gösterilen ücretli reklamlar.
items	ads	object
knowledge_graph	knowledge_graph	object	Sorgu için varsa Google Bilgi Grafiği paneli verileri.
related_questions	related_questions	array of object	Kişiler Sorguyla ilgili sorular da sorar.
items	related_questions	object
related_searches	related_searches	array of object	Sonuçlar sayfasının en altında gösterilen ilgili arama önerileri.
items	related_searches	object
local_results	local_results	object	Sorgunun yerel amacı olduğunda yerel paket sonuçları sunulur.
top_stories	top_stories	array of object	Sorguyla ilgili en önemli haber hikayeleri.
items	top_stories	object
sayfalandırma	pagination	object	Sonuçların sonraki ve önceki sayfalarına bağlantılar.

Hesap Bilgilerini Al

İşlem Kimliği:: GetAccount

Plan ayrıntıları, kalan aramalar ve kullanım istatistikleri dahil olmak üzere kimliği doğrulanmış SerpApi hesabı hakkındaki bilgileri döndürür.

Döndürülenler

Kimliği doğrulanmış SerpApi hesabı hakkında bilgi.

Body: AccountInfo

Konumları Al

İşlem Kimliği:: GetLocations

Aramada location parametresiyle kullanılabilecek desteklenen coğrafi konumların listesini döndürür. Bir şehir veya bölge için tam konum dizesini bulmak için kullanışlıdır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Arama Terimi	q		string	Kullanılabilir konumların listesini (örneğin Austin) filtrelemek için bir şehir veya bölge adı.
Sınır	limit		integer	Döndürülecek en fazla konum sayısı.

Döndürülenler

response: array of Location

Tanımlar

Konum

Konum arama parametresiyle kullanılmak üzere desteklenen bir coğrafi konum.

Name	Yol	Tür	Description
kimlik	id	string	Bu konumun benzersiz tanımlayıcısı.
name	name	string	Konumun tam adı (örneğin Austin, Texas, Birleşik Devletler).
canonical_name	canonical_name	string	Konum parametresinde kullanılan kurallı ad.
country_code	country_code	string	İki harfli ISO ülke kodu.
target_type	target_type	string	Konum türü (ör. Şehir, DMA Bölgesi, Ülke).
Ulaşmak	reach	integer	Bu konum için tahmini aylık arama hacmi erişimi.
Gps	gps	array of number	GPS koordinatları [enlem, boylam].

Hesap Bilgisi

Kimliği doğrulanmış SerpApi hesabı hakkında bilgi.

Name	Yol	Tür	Description
account_id	account_id	string	Hesabın benzersiz tanımlayıcısı.
API anahtarı	api_key	string	Bu hesabın API anahtarı.
account_email	account_email	string	Hesapla ilişkili e-posta adresi.
plan_name	plan_name	string	Geçerli abonelik planının adı.
plan_monthly_price	plan_monthly_price	number	Geçerli planın ABD doları olarak aylık fiyatı.
searches_per_month	searches_per_month	integer	Geçerli plana aylık olarak eklenen toplam arama sayısı.
plan_searches_left	plan_searches_left	integer	Geçerli faturalama döneminde kalan arama sayısı.
extra_credits	extra_credits	integer	Plan dışından satın alınan ek arama kredileri.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Saatte izin verilen en fazla API isteği sayısı.
this_month_usage	this_month_usage	integer	Bu faturalama dönemine kadar kullanılan arama sayısı.
this_hour_searches	this_hour_searches	integer	Geçerli saatte yapılan arama sayısı.
last_hour_searches	last_hour_searches	integer	Önceki saatte yapılan arama sayısı.

SerpApi

SerpApi

Publisher: SerpApi

Prerequisites

Desteklenen İşlemler

Google Search (GoogleSearch)

Konumları Al (GetLocations)

Hesap Bilgilerini Al (GetAccount)

Kimlik Bilgilerini Alma

Getting Started

Temel kullanım

İsteğe bağlı parametreleri geçirme

Yanıt verilerine erişme

Geçerli bir konum dizesi arama

Hesap kullanımını denetleme

Bilinen Sorunlar ve Sınırlamalar

Support

Bağlantı oluşturma

Temerrüt

Eylemler

Google Search

Parametreler

Döndürülenler

Hesap Bilgilerini Al

Döndürülenler

Konumları Al

Parametreler

Döndürülenler

Tanımlar

Konum

Hesap Bilgisi

Google Search (`GoogleSearch`)

Konumları Al (`GetLocations`)

Hesap Bilgilerini Al (`GetAccount`)