DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google Local Finder SERP HTML
Bir sorgu açıkça yerel olduğunda Google'ın gösterdiği genişletilmiş yerel sonuçları eşzamanlı olarak döndürür. Ayrıştırılmış sonuçlar yerine ham sayfa kaynağı. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.02.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array (object | null)[]
- depthTür: integer | null
ayrıştırma derinliği
isteğe bağlı alan
SERP'teki sonuç sayısı
varsayılan değer:
10maksimum değer:
100
Hesabınızdan 10 sonuca kadar içeren her SERP için ücret alınır;10 üzerinde derinlik ayarlamak, arama motoru 10'den fazla sonuç döndürürse ek ücretlere yol açabilir;
belirtilen derinlik yanıttaki sonuç sayısından yüksekse fark otomatik olarak hesap bakiyenize iade edilir;
maliyet Fiyatlandırma sayfasında hesaplanabilir.
- deviceTür: string | null
cihaz türü
isteğe bağlı alan
belirli bir cihaz türü için sonuç döndür
şu değerleri alabilir:
desktop,mobilevarsayılan değer:
desktop - keywordTür: string
anahtar kelime
zorunlu alan
keywordalanına en fazla 700 karakter girebilirsiniztüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)
keywordiçin “%” karakteri kullanmanız gerekiyorsa “%25” olarak belirtin;keywordiçin “+” karakteri kullanmanız gerekiyorsa “%2B” olarak belirtin - languageTür: string
_code arama motoru dil kodu
language_namebelirtmezseniz zorunlu alanbu alanı kullanırsanız
language_namebelirtmeniz gerekmezarama motorunun mevcut dillerinin listesini
language_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesörnek:
en - languageTür: string
_name arama motoru dilinin tam adı
language_codebelirtmezseniz zorunlu alanbu alanı kullanırsanız
language_codebelirtmeniz gerekmezarama motorunun mevcut dillerinin listesini
language_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesörnek:
English - locationTür: integer
_code arama motoru konum kodu
location_nameveyalocation_coordinatebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_nameveyalocation_coordinatebelirtmeniz gerekmezarama motorlarının mevcut konumlarının listesini
location_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsörnek:
2840 - locationTür: string
_coordinate bir konumun GPS koordinatları
location_nameveyalocation_codebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_nameveyalocation_codebelirtmeniz gerekmezlocation_coordinateparametresi "latitude,longitude,zoom" biçiminde belirtilmelidir"zoom" belirtilmezse varsayılan değer olarak 9z uygulanır
"latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
"zoom" için minimum değer: 4z
"zoom" için maksimum değer: 18z
örnek:
52.6178549,-155.352142,20z - locationTür: string
_name arama motoru konumunun tam adı
location_codeveyalocation_coordinatebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_codeveyalocation_coordinatebelirtmeniz gerekmezarama motorunun mevcut konumlarının listesini
location_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsörnek:
London,England,United Kingdom - minTür: string | null
_rating sonuçları minimum puana göre filtrele
isteğe bağlı alan
desktopiçin olası değerler:3.5,4,4.5;mobileiçin olası değerler:2,2.5,3,3.5,4,4.5 - osTür: string | null
cihaz işletim sistemi
isteğe bağlı alan
desktopdeğerinidevicealanında belirtirseniz şu değerlerden birini seçin:windows,macosvarsayılan değer:
windowsmobiledeğerinidevicealanında belirtirseniz şu değerlerden birini seçin:android,iosvarsayılan değer:
android - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirttiğiniz
tagdeğerini yanıtındatanesnesinde bulacaksınız - timeTür: string | null
_filter sonuçları açık saatlere göre filtrele
isteğe bağlı alan
bu alanı kullanarak sonuçlardaki yerleri ziyaretçilere açık oldukları saate göre filtreleyebilirsiniz
Google'ın bu filtreyle eşleşmeyen sonuçlar da sağlayabileceğini unutmayın
olası değerler:
"open_now","24_hours","$day_value","$day_value;$time_value";$day_valueyerine şu değerlerden birini kullanın:"monday","tuesday","wednesday","thursday","friday","saturday","sunday";$time_valueyerine şu değerlerden birini kullanın:"00","01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23"örnek:
"tuesday;18"
- Tür: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- datetimeTür: string | null
sonucun alındığı tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - itemsTür: array (object | null)[] | null
SERP'te bulunan arama sonucu öğeleri
- dateTür: string | null
HTML sayfasının tarandığı tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - htmlTür: string | null
HTML sayfası
- pageTür: integer | null
döndürülen HTML sayfasının seri numarası
- itemsTür: integer | null Biçim: int64
_count itemsdizisinde döndürülen sonuç sayısı - keywordTür: string | null
POST dizisinde alınan anahtar kelime
anahtar kelime, çözümlenmiş %## ile döndürülür ('+' artı karakteri boşluk karakterine çözümlenir) - languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: integer | null
_code POST dizisindeki konum kodu
- seTür: string | null
_domain POST dizisindeki arama motoru alan adı
- typeTür: string | null
öğe türü
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}