DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı ChatGPT LLM Yanıtları
Bir ChatGPT modeline user_prompt gönderir ve yanıtını eşzamanlı olarak döndürür. model_name modeli seçer — bkz. get_dataforseo_ai_chat_gpt_llm_responses_models; listede olmayan bir ad doğrudan reddedilir. max_output_tokens, temperature ve top_p satıcının kendi API'sindeki gibi davranır ve web_search ya da force_web_search gezinmesini sağlar. model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items ve fan_out_queries döndürür. Bir istemin gerçekte ne kadara mal olduğunu görmek için yanıttaki money_spent değerini okuyun. 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. ⚠️ Bu, bir veri sağlayıcı üzerinden yönlendirilen genel bir LLM çağrısıdır, SEO ölçümü değildir. ChatGPT'nin bir marka hakkında kullanıcılara ne söylediğini bilmek istiyorsanız, post_dataforseo_ai_chat_gpt_llm_scraper_live tüketici deneyimini yeniden üretir.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.0695.
- 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)[]
- forceTür: boolean | null
_web _search AI aracısını web araması kullanmaya zorla
isteğe bağlı alan
bu parametreyi etkinleştirmek içinweb_searchde etkin olmalıdır;
etkinleştirildiğinde AI modeli güncel web bilgilerine erişmeye ve bunları alıntılamaya zorlanır;
varsayılan değer:false;
Not: parametretrueolarak ayarlansa bile yanıtta web kaynaklarının alıntılanacağı garanti edilmez
Not 2: akıl yürütme modellerinde desteklenmez - maxTür: integer | null
_output _tokens AI yanıtındaki maksimum token sayısı
isteğe bağlı alan
akıl yürütme modelleri için minimum değer (ör. Models uç noktasındareasoningdeğeritrue):1024;
akıl yürütme kullanmayan modeller için minimum değer:16;
maksimum değer:4096;
varsayılan değer:2048
Not:web_searchtrueolarak ayarlanırsa veya istekte akıl yürütme modeli belirtilirse çıktı token sayısı belirtilenmax_output_tokenssınırını aşabilir - messageTür: array (object | null)[] | null
_chain konuşma geçmişi isteğe bağlı alan önceki konuşma turlarını temsil eden mesaj nesneleri dizisi; her nesne şunları içermelidir: user veya ai rolünü içeren role dizesi; mesaj içeriğini içeren message dizesi (maks. 500 karakter); dizide en fazla 10 mesaj nesnesi belirtebilirsiniz; Not: Perplexity modellerinde mesajlar user ve AI rolleri arasında kesinlikle sırayla değişmelidir (user → ai); örnek: "message_chain": [{"role":"user","message":"Hello, what’s up?"},{"role":"ai","message":"Hello! I’m doing well, thank you. How can I assist you today?"}]
- messageTür: string | null
mesaj metni
- roleTür: string | null
mesajın kaynaklandığı kullanıcının rolü
- modelTür: string
_name AI modelinin adı
zorunlu alanmodel_namegerçek model adı ve sürüm adından oluşur;
temel model adı belirtilirse varsayılan olarak en son sürümü ayarlanır;
örneğingpt-4.1belirtilirsemodel_nameolarak otomatikmangpt-4.1-2025-04-14ayarlanır;
mevcut LLM modellerinin listesini ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models - systemTür: string | null
_message AI davranışına yönelik talimatlar
isteğe bağlı alan
AI'nın rolünü, tonunu veya belirli davranışını tanımlarsystem_messagealanında en fazla 500 karakter belirtebilirsiniz - 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 - temperatureTür: number | null
AI yanıtının rastgeleliği
isteğe bağlı alan
yüksek değerler çıktıyı daha çeşitli hale getirir;
düşük değerler çıktıyı daha odaklı hale getirir;
minimum değer:0
maksimum değer:2
varsayılan değer:0.94
Not: akıl yürütme modellerinde desteklenmez - topTür: number | null
_p AI yanıtının çeşitliliği
isteğe bağlı alan
token seçimini sınırlayarak yanıtın çeşitliliğini kontrol eder;
minimum değer:0
maksimum değer:1
varsayılan değer:0.92Not:
top_paynı istektetemperatureile birlikte kullanılamaz - userTür: string
_prompt AI modeli için prompt
zorunlu alan
AI modeline göndermek istediğiniz soru veya görev;user_promptalanında en fazla 500 karakter belirtebilirsiniz - webTür: boolean | null
_search - webTür: string | null
_search _city konumun şehir adı
isteğe bağlı alan
Not:o3-mini,o1-pro,o1modellerinde desteklenmez - webTür: string | null
_search _country _iso _code konumun ISO ülke kodu
isteğe bağlı alan
bu parametreyi etkinleştirmek içinweb_searchde etkin olmalıdır;
etkinleştirildiğinde AI modeli web'de belirttiğiniz ülkeden arama yapar;
Not:o3-mini,o1-pro,o1modellerinde desteklenmez
- Tür: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmResponsesLiveResponseInfo200
- 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_AiOptimizationChatGptLlmResponsesLiveTaskInfo
- 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 - fanTür: array (string | null)[] | null
_out _queries fan-out sorguları dizisi
daha kapsamlı bir yanıt sağlamak için ana sorgudan türetilen ilgili arama sorgularını içerir - inputTür: integer | null
_tokens girişteki token sayısı
işlenen toplam token sayısı - itemsTür: array (object | null)[] | null
yanıt öğeleri dizisi
yapılandırılmış AI yanıt verilerini içerir- typeTür: string | null
öğe türü
- modelTür: string | null
_name kullanılan AI modelinin adı
- moneyTür: number | null
_spent - outputTür: integer | null
_tokens çıktıdaki token sayısı
AI yanıtında oluşturulan toplam token sayısı - reasoningTür: integer | null
_tokens akıl yürütme tokenlarının sayısı
akıl yürütme içeriğini oluşturmak için kullanılan toplam token sayısı - webTür: boolean | null
_search web aramasının kullanılıp kullanılmadığını belirtir
- 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/ai_optimization/chat_gpt/llm_responses/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"system_message": "communicate as if we are in a business meeting",
"message_chain": [
{
"role": "user",
"message": "Hello, what’s up?"
},
{
"role": "ai",
"message": "Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?"
}
],
"max_output_tokens": 200,
"temperature": 0.3,
"top_p": 0.5,
"model_name": "gpt-4.1-mini",
"web_search": true,
"web_search_country_iso_code": "FR",
"web_search_city": "Paris",
"user_prompt": "provide information on how relevant the amusement park business is in France now"
}
]'
{
"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": [
{
"model_name": null,
"input_tokens": null,
"output_tokens": null,
"reasoning_tokens": null,
"web_search": null,
"money_spent": null,
"datetime": null,
"items": [
{
"type": null
}
],
"fan_out_queries": [
null
]
}
]
}
]
}