DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
لائیو Yahoo Organic SERP Advanced
Yahoo پر کسی کی ورڈ کے لیے درجہ بند نتائج ہم وقت واپس کرتا ہے۔ keyword، type، se_domain، location_code، language_code، check_url، datetime، spell، refinement_chips، item_types، items_count اور items واپس کرتا ہے۔ advanced ڈیفالٹ انتخاب ہے؛ regular تب لیں جب صرف درجہ بند فہرست اہم ہو، اور html صرف یہ دیکھنے کے لیے کہ پارسر نے کیا چھوڑا۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- depthقسم: integer | null
- deviceقسم: string | null
ڈیوائس کی قسم
اختیاری فیلڈ
مخصوص ڈیوائس کی قسم کے لیے نتائج واپس کریں
اقدار لے سکتا ہے:desktop،mobile
ڈیفالٹ قدر:desktop - keywordقسم: string
keyword
درکار فیلڈ
آپkeywordفیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
تمام %## ڈیکوڈ ہوں گے (نیز '+' حرف اسپیس حرف میں ڈیکوڈ ہوگا)
اگر آپ اپنےkeywordکے لیے "%" حرف استعمال کرنا چاہتے ہیں تو اسے "%25" کے طور پر متعین کریں؛
اگر آپ اپنےkeywordکے لیے “+” حرف استعمال کرنا چاہتے ہیں تو اسے “%2B” کے طور پر متعین کریںDataForSEO APIs میں
keywordاورkeywordsفیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں - languageقسم: string
_code سرچ انجن زبان کا کوڈ
اگر آپ متعین نہ کریں تو درکار فیلڈlanguage_name
اگر آپ یہ فیلڈ استعمال کریں توlanguage_nameمتعین کرنے کی ضرورت نہیں
آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کےlanguage_codeکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesسے حاصل کر سکتے ہیں
مثال:enn - languageقسم: string
_name سرچ انجن زبان کا پورا نام
اگر آپ متعین نہ کریں تو درکار فیلڈlanguage_code
اگر آپ یہ فیلڈ استعمال کریں توlanguage_codeمتعین کرنے کی ضرورت نہیں
آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کےlanguage_nameکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesسے حاصل کر سکتے ہیں
مثال:English - locationقسم: integer
_code سرچ انجن مقام کا کوڈ
اگر آپlocation_nameیاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوlocation_nameیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ سرچ انجنوں کے دستیاب مقامات کی فہرست ان کےlocation_codeکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:2840 - locationقسم: string
_coordinate مقام کے GPS کوآرڈینیٹس
اگر آپlocation_name_ یاlocation_codeمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlocation_nameیاlocation_codeمتعین کرنے کی ضرورت نہیںlocation_coordinateپیرامیٹر "latitude,longitude,radius" فارمیٹ میں متعین کرنا چاہیے
"latitude" اور "longitude" کے لیے زیادہ سے زیادہ اعشاریہ ہندسے: 7
"radius" کے لیے کم از کم قدر: 199.9 (mm)
"radius" کے لیے زیادہ سے زیادہ قدر: 199999 (mm)
مثال:53.476225,-2.243572,200n - locationقسم: string
_name سرچ انجن مقام کا پورا نام
اگر آپlocation_codeیاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوlocation_codeیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کےlocation_nameکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:London,England,United Kingdom - maxقسم: integer | null
_crawl _pages - osقسم: string | null
ڈیوائس آپریٹنگ سسٹم
اختیاری فیلڈ
اگر آپdesktopکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:windows،macos
ڈیفالٹ قدر:windows
اگر آپmobileکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:android،ios
ڈیفالٹ قدر:android - seقسم: string | null
_domain سرچ انجن ڈومین
اختیاری فیلڈ
ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
مثال:au.search.yahoo.com،uk.search.yahoo.com،ca.search.yahoo.com، وغیرہ۔ - searchقسم: string | null
_param سرچ کوئری کے اضافی پیرامیٹرز
اختیاری فیلڈ
دستیاب پیرامیٹرز کی فہرست اور اضافی تفصیلات یہاں حاصل کریں - stopقسم: array (object | null)[] | null
_crawl _on _match کرالنگ روکنے کے لیے اہداف کی صف اختیاری فیلڈ اگر متعین کیا جائے تو جواب میں متعین کردہ match_value تک اور اس سمیت SERP نتائج شامل ہوں گے؛ آپ اس صف میں زیادہ سے زیادہ 10 ہدف اقدار متعین کر سکتے ہیں مثال: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api آپ کے اکاؤنٹ سے متعین کردہ اہداف کے ذریعے کرال کیے گئے ہر SERP پر بل لیا جائے گا
- matchقسم: string | null
_type ہدف میچ کی قسم اگر stop_crawl_on_match متعین کیا جائے تو درکار فیلڈ؛ match_value کے لیے میچ کی قسم ممکنہ اقدار: domain, with_subdomains, wildcard
- matchقسم: string | null
_value ہدف ڈومین یا وائلڈ کارڈ قدر اگر stop_crawl_on_match متعین کیا جائے تو درکار فیلڈ؛ ہدف ڈومین یا وائلڈ کارڈ قدر متعین کریں؛ نوٹ: ڈومین نام درخواست پروٹوکول کے بغیر متعین کرنا ہوگا؛ مثال: dataforseo.com
- tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataآبجیکٹ میں متعین کردہtagقدر دیکھیں گے - targetقسم: string | null
نتائج حاصل کرنے کے لیے ہدف ڈومین، ذیلی ڈومین یا ویب صفحہ
اختیاری فیلڈ
ڈومین یا ذیلی ڈومین کوhttps://اورwww.کے بغیر متعین کرنا چاہیے
نوٹ کریں کہtargetسے مخصوص ٹاسکس کے نتائج میں صرف وہ SERP عناصر شامل ہوں گے جن میںurlاسٹرنگ موجود ہو؛
آپ SERP میں سرچ پیٹرن متعین کرنے اور نتائج کو محدود کرنے کے لیے وائلڈ کارڈ (‘’) حرف بھی استعمال کر سکتے ہیں؛
مثالیں:example.com- ویب سائٹ کے ہوم پیج کے لیے نتائج واپس کرتا ہے، جن کے URLs ایسے ہو سکتے ہیں:https://example.com، یاhttps://www.example.com/، یاhttps://example.com/؛example.com- ڈومین کے لیے نتائج واپس کرتا ہے، اس کے تمام صفحات سمیت؛example.com- پورے ڈومین کے لیے نتائج واپس کرتا ہے، اس کے تمام صفحات اور ذیلی ڈومینز سمیت؛example.com- ذیلی ڈومین سے قطع نظر ہوم پیج کے لیے نتائج واپس کرتا ہے، مثلاًhttps://en.example.com؛example.com/example-page- عین اسی URL کے لیے نتائج واپس کرتا ہے؛example.com/example-page- ڈومین کے ان تمام URLs کے لیے نتائج واپس کرتا ہے جو متعین کردہ اسٹرنگ سے شروع ہوں - urlقسم: string | null
سرچ کوئری کا براہ راست URL
اختیاری فیلڈ
آپ براہ راست URL متعین کر سکتے ہیں اور ہم اسے ضروری فیلڈز میں تقسیم کر دیں گے۔ نوٹ کریں کہ یہ طریقہ ہماری API کے لیے سب سے مشکل ہے اور اس کے لیے URL میں درست زبان اور مقام متعین کرنا بھی ضروری ہے۔ زیادہ تر صورتوں میں ہم یہ طریقہ استعمال کرنے کی سفارش نہیں کرتے۔
مثال:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8
- قسم: object | null · Response36Afe1097B20_SerpYahooOrganicLiveAdvancedResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_SerpYahooOrganicLiveAdvancedTaskInfo
- 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
نتائج کی صف
- checkقسم: string | null
_url سرچ انجن نتائج کا براہ راست URL
آپ اسے یقینی بنانے کے لیے استعمال کر سکتے ہیں کہ ہم نے درست نتائج فراہم کیے ہیں - datetimeقسم: string | null
وہ تاریخ اور وقت جب نتیجہ موصول ہوا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - itemقسم: array (string | null)[] | null
_types - itemsقسم: array (object | null)[] | null
SERP میں پائے جانے والے تلاش کے نتائج کے عناصر
- pageقسم: integer | null
تلاش کے نتائج کے صفحہ کا نمبر
اس SERP صفحہ کا نمبر بتاتا ہے جس پر عنصر موجود ہے - positionقسم: string | null
SERP میں عنصر کی سیدھ
درج ذیل قدریں لے سکتا ہے:left,right - rectangleقسم: object | null · Response36Afe1097B20_AiModeRectangleInfo
مستطیل پیرامیٹرز
SERP میں نتیجے کے اسنیپٹ کے کارٹیزین کوآرڈینیٹس اور پکسل طول و عرض رکھتا ہے
اگر POST درخواست میںcalculate_rectanglesکوtrueپر سیٹ نہ کیا گیا ہو توnullکے برابر ہوتا ہے- heightقسم: number | null فارمیٹ: double
عنصر کی اونچائی پکسلز میں
- widthقسم: number | null فارمیٹ: double
عنصر کی چوڑائی پکسلز میں
- xقسم: number | null فارمیٹ: double
x-axis کوآرڈینیٹ نتیجے کے اسنیپٹ کے اوپری بائیں کونے کا x-axis کوآرڈینیٹ، جہاں اسکرین کا اوپری بائیں کونا نقطۂ مبدا ہے
- yقسم: number | null فارمیٹ: double
y-axis کوآرڈینیٹ نتیجے کے اسنیپٹ کے اوپری بائیں کونے کا y-axis کوآرڈینیٹ، جہاں اسکرین کا اوپری بائیں کونا نقطۂ مبدا ہے
- typeقسم: string | null
عنصر کی قسم
- xpathقسم: string | null
عنصر کا XPath
- itemsقسم: integer | null فارمیٹ: int64
_count itemsصف میں واپس کیے گئے نتائج کی تعداد - keywordقسم: string | null
POST صف میں موصول ہونے والا کی ورڈ
کی ورڈ ڈی کوڈ شدہ %## کے ساتھ واپس کیا جاتا ہے (پلس کریکٹر '+' اسپیس کریکٹر میں ڈی کوڈ ہو جائے گا) - languageقسم: string | null
_code POST صف میں زبان کا کوڈ
- locationقسم: integer | null
_code POST صف میں مقام کا کوڈ
- pagesقسم: integer | null فارمیٹ: int64
_count حاصل کیے گئے کل صفحات
نتیجے میں حاصل کیے گئے SERPs کی کل تعداد - refinementقسم: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips تلاش کی باریکی کے چپس
nullکے برابر ہے- itemsقسم: array (object | null)[] | null
عنصر کے آئٹمز
- domainقسم: string | null
SERP میں ڈومین
- optionsقسم: array (object | null)[] | null
مزید تلاش کی باریکی کے مزید اختیارات
- domainقسم: string | null
SERP میں ڈومین
- titleقسم: string | null
عنصر کا عنوان
- typeقسم: string | null
عنصر کی قسم
- urlقسم: string | null
ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL
- titleقسم: string | null
عنصر کا عنوان
- typeقسم: string | null
عنصر کی قسم
- urlقسم: string | null
ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL
- typeقسم: string | null
عنصر کی قسم
- xpathقسم: string | null
عنصر کا XPath
- seقسم: string | null
_domain POST صف میں سرچ انجن کا ڈومین
- seقسم: integer | null فارمیٹ: int64
_results _count SERP میں نتائج کی کل تعداد
- spellقسم: object | null · Response36Afe1097B20_SpellInfo
سرچ انجن کی خودکار تصحیح
اگر سرچ انجن نے کسی ایسے کی ورڈ کے لیے نتائج فراہم کیے جو درست کیا گیا تھا، تو ہم سرچ انجن کی درست کردہ کی ورڈ اور خودکار تصحیح کی قسم بتائیں گے- keywordقسم: string | null
سرچ انجن کی خودکار تصحیح کے نتیجے میں حاصل کردہ کی ورڈ نتائج درست کیے گئے کی ورڈ کے لیے فراہم کیے جائیں گے
- typeقسم: string | null
خودکار تصحیح کی قسم ممکنہ اقدار: did_you_mean, showing_results_for, no_results_found_for, including_results_for نوٹ: Yahoo اور Yandex صرف درج ذیل خودکار تصحیح کی قسم معاون کرتے ہیں: including_results_for
- typeقسم: string | null
عنصر کی قسم
- 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/yahoo/organic/live/advanced \
--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,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}