DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
लाइव Claude LLM Responses
Claude मॉडल को user_prompt भेजता है और सिंक्रोनस रूप से उसका उत्तर लौटाता है। model_name get_dataforseo_ai_claude_llm_responses_models से आना चाहिए — नाम claude-sonnet-5 जैसे दिखते हैं, और मामूली लगने वाला अनुमान अस्वीकार हो जाता है। model_name, input_tokens, output_tokens, reasoning_tokens, web_search, money_spent, datetime, items और fan_out_queries लौटाता है। किसी प्रॉम्प्ट की वास्तविक लागत देखने के लिए response पर money_spent पढ़ें। DataForSEO के envelope में लिपटा: डेटा tasks[0].result में, परिणाम tasks[0].status_code में — अस्वीकृत request फिर भी HTTP 200 लौटाता है।
मूल्य संदर्भ
- मीटरिंग: रिपोर्ट किया गया response लागत
- संदर्भ request अनुमान: USD 0.0567
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: array (object | null)[]
- forceटाइप: boolean | null
_web _search AI एजेंट को वेब सर्च के लिए बाध्य करें
वैकल्पिक फ़ील्ड
इस पैरामीटर को सक्षम करने के लिएweb_searchभी सक्षम होना चाहिए;
सक्षम होने पर AI मॉडल वर्तमान वेब जानकारी तक पहुँचने और उसे उद्धृत करने के लिए बाध्य होता है;
डिफ़ॉल्ट मान:false;
नोट: पैरामीटरtrueपर सेट होने पर भी response में वेब स्रोतों के उद्धृत होने की गारंटी नहीं है - maxटाइप: integer | null
_output _tokens AI response में अधिकतम टोकन संख्या
वैकल्पिक फ़ील्ड
न्यूनतम मान:1;
अधिकतम मान:4096;
डिफ़ॉल्ट मान:2048;
नोट: यदिweb_searchकोtrueसेट किया गया है या request में रीज़निंग मॉडल निर्दिष्ट है, तो आउटपुट टोकन संख्या निर्दिष्टmax_output_tokensसीमा से अधिक हो सकती है
नोट 2: यदिuse_reasoningtrueपर सेट है, तोmax_output_tokensका न्यूनतम मान1025है - messageटाइप: array (object | null)[] | null
_chain बातचीत का इतिहास वैकल्पिक फ़ील्ड पिछले बातचीत टर्न को दर्शाने वाले message ऑब्जेक्ट का ऐरे; हर ऑब्जेक्ट में होना चाहिए: role — user या ai भूमिका वाला स्ट्रिंग; message — message सामग्री वाला स्ट्रिंग (अधिकतम 500 अक्षर); ऐरे में अधिकतम 10 message ऑब्जेक्ट निर्दिष्ट कर सकते हैं; नोट: Perplexity मॉडल के लिए message को user और AI भूमिकाओं के बीच सख़्ती से बदलते रहना चाहिए (user → ai); उदाहरण: "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?"}]
- messageटाइप: string | null
message टेक्स्ट
- roleटाइप: string | null
उस उपयोगकर्ता की भूमिका जिससे message आता है
- modelटाइप: string
_name AI मॉडल का नाम
आवश्यक फ़ील्डmodel_nameमें वास्तविक मॉडल नाम और संस्करण नाम होता है;
यदि बेस मॉडल नाम दिया गया है, तो डिफ़ॉल्ट रूप से उसका नवीनतम संस्करण सेट होगा;
उदाहरण के लिए, यदिclaude-opus-4-0निर्दिष्ट है, तोclaude-opus-4-20250514अपने आपmodel_nameके रूप में सेट होगा;
आपhttps://api.dataforseo.com/v3/ai_optimization/claude/llm_responses/modelsपर अलग request भेजकर उपलब्ध LLM मॉडल की सूची प्राप्त कर सकते हैं - systemटाइप: string | null
_message AI व्यवहार के लिए निर्देश
वैकल्पिक फ़ील्ड
AI की भूमिका, टोन या विशिष्ट व्यवहार परिभाषित करता है;
आपsystem_messageफ़ील्ड में अधिकतम 500 अक्षर निर्दिष्ट कर सकते हैं - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - temperatureटाइप: number | null
AI response की रैंडमनेस
वैकल्पिक फ़ील्ड
अधिक मान आउटपुट को अधिक विविध बनाते हैं;
कम मान आउटपुट को अधिक केंद्रित बनाते हैं;
न्यूनतम मान:0
अधिकतम मान:1
डिफ़ॉल्ट मान:0.7नोट:
temperatureको एक ही request मेंtop_pके साथ उपयोग नहीं किया जा सकता - topटाइप: number | null
_p AI response की विविधता
वैकल्पिक फ़ील्ड
टोकन चयन सीमित करके response की विविधता नियंत्रित करता है;
न्यूनतम मान:0
अधिकतम मान:1
डिफ़ॉल्ट मान:nullनोट:
top_pको एक ही request मेंtemperatureके साथ उपयोग नहीं किया जा सकता - useटाइप: boolean | null
_reasoning AI मॉडल के लिए रीज़निंग सक्षम करें
वैकल्पिक फ़ील्ड
सक्षम होने पर मॉडल response उत्पन्न करने से पहले रीज़निंग करेगाreasoningसमर्थित करने वाले मॉडल की सूची के लिए Models endpoint देखें
डिफ़ॉल्ट मान:false
नोट: यदिtrueपर सेट है, तोmax_output_tokensका न्यूनतम मान1025है
नोट 2: यदिtrueपर सेट है, तोforce_web_searchकोfalseपर सेट करना होगा
नोट 3: यदिtrueपर सेट है, तोtemperatureऔरtop_pउपयोग नहीं किए जा सकते - userटाइप: string
_prompt AI मॉडल के लिए प्रॉम्प्ट
आवश्यक फ़ील्ड
वह प्रश्न या कार्य जो आप AI मॉडल को भेजना चाहते हैं;
आपuser_promptफ़ील्ड में अधिकतम 500 अक्षर निर्दिष्ट कर सकते हैं - webटाइप: boolean | null
_search - webटाइप: string | null
_search _city वेब सर्च के लिए उपयोग किए जाने वाले स्थान का शहर नाम
वैकल्पिक फ़ील्ड - webटाइप: string | null
_search _country _iso _code वेब सर्च के लिए उपयोग किए जाने वाले स्थान का ISO देश कोड
वैकल्पिक फ़ील्ड
संभावित मान:'AR','AT','AU','BE','BR','CA','CH','CL','CN','DE','DK','ES','FI','FR','GB','HK','ID','IN','IT','JP','KR','MX','MY','NL','NO','NZ','PH','PL','PT','RU','SA','SE','TR','TW','US','ZA'
- टाइप: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_AiOptimizationClaudeLlmResponsesLiveTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- propertyटाइप: object | null
Name
- idटाइप: string | null
टास्क आइडेंटिफ़ायर हमारे सिस्टम में अद्वितीय टास्क आइडेंटिफ़ायर, UUID प्रारूप में
- pathटाइप: array (string | null)[] | null
URL पथ
- resultटाइप: array (object | null)[] | null
परिणामों का ऐरे
- datetimeटाइप: string | null
वह तारीख और समय जब परिणाम प्राप्त हुआ
UTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”
उदाहरण:2019-11-15 12:57:46 +00:00 - fanटाइप: array (string | null)[] | null
_out _queries fan-out क्वेरी का ऐरे
अधिक व्यापक उत्तर देने के लिए मुख्य क्वेरी से निकाली गई संबंधित सर्च क्वेरी शामिल हैं - inputटाइप: integer | null
_tokens input में टोकन की संख्या
प्रोसेस किए गए टोकन की कुल संख्या - itemsटाइप: array (object | null)[] | null
response आइटम का ऐरे
संरचित AI response डेटा शामिल है- typeटाइप: string | null
एलिमेंट का प्रकार
- modelटाइप: string | null
_name उपयोग किए गए AI मॉडल का नाम
- moneyटाइप: number | null
_spent - outputटाइप: integer | null
_tokens output में टोकन की संख्या
AI response में जनरेट किए गए टोकन की कुल संख्या - reasoningटाइप: integer | null
_tokens रीजनिंग टोकन की संख्या
रीजनिंग सामग्री बनाने में उपयोग किए गए टोकन की कुल संख्या - webटाइप: boolean | null
_search बताता है कि वेब सर्च का उपयोग हुआ या नहीं
- resultटाइप: integer | null फ़ॉर्मेट: int64
_count result ऐरे में एलिमेंट की संख्या
- statusटाइप: integer | null
_code टास्क का स्टेटस कोड DataForSEO द्वारा जनरेट किया गया, यह निम्न श्रेणी में हो सकता है: 10000-60000 response कोड की पूरी सूची यहाँ देखी जा सकती है
- statusटाइप: string | null
_message टास्क का सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- timeटाइप: string | null
निष्पादन समय, सेकंड
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_count tasks ऐरे में टास्क की संख्या
- टाइप: integer | null फ़ॉर्मेट: int64tasks
_error त्रुटि के साथ लौटाए गए tasks ऐरे में टास्क की संख्या
- टाइप: string | nulltime
कुल निष्पादन समय, सेकंड
- टाइप: string | nullversion
API का वर्तमान संस्करण
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/claude/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,
"model_name": "claude-opus-4-0",
"temperature": 0.3,
"web_search": true,
"web_search_country_iso_code": "FR",
"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
]
}
]
}
]
}