DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google AI Mode SERP HTML
Bir sorgu için Google AI Mode yanıtını, Google'da atıfta bulunduğu kaynaklarla birlikte 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)[]
- 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,mobile
varsayılan değer:desktop - keywordTür: string
anahtar kelime
zorunlu alankeywordalanında en fazla 700 karakter belirtebilirsiniz
tüm %## kodları çözülür ('+' karakteri boşluk karakteri olarak çözülür)keywordiçin "%" karakterini kullanmanız gerekiyorsa "%25" olarak belirtin;keywordiçin “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin; - languageTür: string
_code arama motoru dil kodu
language_namebelirtmezseniz zorunlu alan;
bu alanı kullanırsanızlanguage_namebelirtmeniz gerekmez;
arama motorunun mevcut dillerinin listesinilanguage_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/google/ai_mode/languages - languageTür: string
_name arama motoru dilinin tam adı
language_codebelirtmezseniz zorunlu alan;
bu alanı kullanırsanızlanguage_codebelirtmeniz gerekmez;
arama motorunun mevcut dillerinin listesinilanguage_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/google/ai_mode/languages; - locationTür: integer
_code arama motoru konum kodu
location_nameveyalocation_coordinatebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_nameveyalocation_coordinatebelirtmeniz gerekmez
arama motorlarının mevcut konumlarının listesinilocation_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ı
belirtmezseniz zorunlu alanlocation_nameveyalocation_code
bu alanı kullanırsanızlocation_nameveyalocation_codebelirtmeniz gerekmezlocation_coordinateparametresi "latitude,longitude,radius" biçiminde belirtilmelidir
"latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
"radius" için minimum değer: 199.9 (mm)
"radius" için maksimum değer: 199999 (mm)
örnek:53.476225,-2.243572,200 - locationTür: string
_name arama motoru konumunun tam adı
location_codeveyalocation_coordinatebelirtmezseniz zorunlu alan
bu alanı kullanırsanızlocation_codeveyalocation_coordinatebelirtmeniz gerekmez
arama motorunun mevcut konumlarının listesinilocation_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 - osTür: string | null
cihaz işletim sistemi
isteğe bağlı alandevicealanındadesktopbelirtirseniz şu değerlerden birini seçin:windows,macos
varsayılan değer:windowsdevicealanındamobilebelirtirseniz şu değerlerden birini seçin:android,ios
varsayı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
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveHtmlResponseInfo200
- 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_SerpGoogleAiModeLiveHtmlTaskInfo
- 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/ai_mode/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
}
]
}
]
}
]
}