DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP API AI خلاصہ
Google پر کسی کوئری کے لیے نتائج کے اوپر Google جو AI اوورویو دکھاتا ہے، واپس کرتا ہے۔ keyword، type، se_domain، location_code، language_code، check_url، datetime، spell، refinement_chips، item_types، items_count اور items واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- fetchقسم: boolean | null
_content SERP میں موجود صفحات سے مواد حاصل کریں
اختیاری فیلڈ
اگرtrueپر سیٹ کیا جائے تو API SERP نتائج میں شامل صفحات سے مواد حاصل کرے گی، اور AI ماڈل نتیجے میں خلاصہ تیار کرتے وقت اس مواد کو مدنظر رکھے گا؛
ڈیفالٹ قدر:false - includeقسم: boolean | null
_links خلاصے میں ماخذ لنکس شامل کریں
اختیاری فیلڈ
اگرtrueپر سیٹ کیا جائے تو API جواب میںsummaryفیلڈ میں تیار کردہ خلاصے کے ماخذوں کے لنکس شامل ہوں گے؛
ڈیفالٹ قدر:false - promptقسم: string | null
AI پرامپٹ
اختیاری فیلڈ
AI summariser کے لیے اضافی ٹاسک؛
کسی بھی قسم کا متن، سوال یا معلومات جو AI کو بتائیں کہ آپ کون سا جواب چاہتے ہیں؛
آپ زیادہ سے زیادہ کتنے علامات یا حروف متعین کر سکتے ہیں:2000؛
نوٹ: آپ کا پرامپٹ SERP API کے POST درخواست میں متعین کیے گئے کی ورڈ سے متعلق ہونا چاہیے - supportقسم: boolean | null
_extra اضافی SERP فیچرز کی معاونت کریں
اختیاری فیلڈ
اگرtrueپر سیٹ کیا جائے تو AI ماڈلorganicنتائج کے علاوہ درج ذیل اضافی SERP فیچرز کو بھی مدنظر رکھے گا:answer_box،knowledge_graph،featured_snippet؛
ڈیفالٹ قدر:true - taskقسم: string
_id
- قسم: object | null · Response36Afe1097B20_SerpAiSummaryResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_SerpAiSummaryTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: array (object | null)[] | null
نتائج کی صف
- itemsقسم: array (object | null)[] | null
آئٹمز کی صف
- summaryقسم: string | null
تیار کردہ خلاصہ
درخواست میں بتائے گئے پیرامیٹرز کے مطابق AI ماڈل کے تیار کردہ خلاصے
- itemsقسم: integer | null فارمیٹ: int64
_count نتائج کی صف میں آئٹمز کی تعداد
- resultقسم: integer | null فارمیٹ: int64
_count result صف میں عناصر کی تعداد
- statusقسم: integer | null
_code ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- 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
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/ai_summary \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"task_id": "07031739-1535-0139-0000-9d1e639a5b7d",
"prompt": "explain what DataForSEO is",
"include_links": true,
"fetch_content": true
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"summary": null
}
]
}
]
}
]
}