DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Baidu Organic SERP ٹاسکس سیٹ کرنا
Baidu پر کسی کی ورڈ کے لیے درجہ بند نتائج کو قطار میں ڈالتا ہے اور tasks[0].id میں ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ لائیو ہم منصب فوراً جواب دیتا ہے اور ایک ہی کوئری کے لیے آسان ہے؛ جب بیچ ٹول کال سے زیادہ طویل ہو تو قطار میں ڈالیں۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: array (object | null)[]
- depthقسم: integer | null
پارسنگ ڈیپتھ
اختیاری فیلڈ
SERP میں نتائج کی تعداد
ڈیفالٹ قدر:10
زیادہ سے زیادہ قدر:700
آپ کے اکاؤنٹ سے ہر اس SERP کے لیے بل لیا جائے گا جس میں زیادہ سے زیادہ 10 نتائج ہوں؛
10 سے زیادہ ڈیپتھ مقرر کرنے پر اضافی چارجز آ سکتے ہیں اگر سرچ انجن 10 سے زیادہ نتائج واپس کرے؛
لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔ - deviceقسم: string | null
ڈیوائس کی قسم
اختیاری فیلڈ
مخصوص ڈیوائس کی قسم کے لیے نتائج واپس کریں
اقدار لے سکتا ہے:desktop،mobile،tablet
ڈیفالٹ قدر:desktop - getقسم: boolean | null
_website _url ہر درجہ بند نتیجے کے لیے براہ راست URL شامل کریں
اختیاری فیلڈ
اگرtrueپر سیٹ کیا جائے تو واپس کیے گئے نتائج میں درجہ بند ویب سائٹس کے براہ راست URLs شامل ہوں گے
بطور ڈیفالٹ، Baidu نتائج میں URLs سرچ انجن کی جانب سے انکوڈ کیے جاتے ہیں،
مثلاً:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kL۔ ڈیفالٹ قدر:false
نوٹ: اگرtrueپر سیٹ کیا جائے تو ہر ٹاسک کا چارج 10 گنا بڑھ جائے گا کیونکہ ہمارا سسٹم ہر درجہ بند ویب سائٹ کا براہ راست URL واپس کرنے کے لیے الگ درخواست چلاتا ہے - keywordقسم: string
کی ورڈ
درکار فیلڈ
آپkeywordفیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف خالی جگہ کے حرف میں ڈی کوڈ ہوگا)
اگر آپ کو اپنےkeywordکے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛
اگر آپ کو اپنےkeywordکے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریںDataForSEO APIs میں
keywordاورkeywordsفیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں - languageقسم: string
_code سرچ انجن زبان کا کوڈ
اگر آپlanguage_nameمتعین نہ کریں تو درکار فیلڈ
آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کےlanguage_codeکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesپر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ نوٹ کریں کہ Baidu سرچ انجن میں صرفChinese (Simplified)زبان معاون ہے جس کا زبان کوڈzh_CNہے۔ تاہم، Baidu دیگر زبانوں کے استفسارات کے لیے بھی نتائج واپس کر سکتا ہے، لہٰذا چینی میںkeywordمتعین کرنا لازمی نہیںمثال:
zh_CN - languageقسم: string
_name سرچ انجن زبان کا پورا نام
اگر آپlanguage_codeمتعین نہ کریں تو درکار فیلڈ
آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کےlanguage_nameکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesپر الگ درخواست بھیج کر حاصل کر سکتے ہیں۔ نوٹ کریں کہ Baidu سرچ انجن میں صرفChinese (Simplified)زبان معاون ہے۔ تاہم، Baidu دیگر زبانوں کے استفسارات کے لیے بھی نتائج واپس کر سکتا ہے، لہٰذا چینی میںkeywordمتعین کرنا لازمی نہیںمثال:
Chinese (Simplified) - locationقسم: integer
_code سرچ انجن مقام کا کوڈ
اگر آپlocation_nameیاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوlocation_nameیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ سرچ انجنوں کے دستیاب مقامات کی فہرست ان کےlocation_codeکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:2156 - 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,200 - locationقسم: string
_name سرچ انجن مقام کا پورا نام
اگر آپlocation_codeیاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں تو آپ کوlocation_codeیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کےlocation_nameکے ساتھhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsپر الگ درخواست بھیج کر حاصل کر سکتے ہیں
مثال:New York,New York,United States - maxقسم: integer | null
_crawl _pages - osقسم: string | null
ڈیوائس آپریٹنگ سسٹم
اختیاری فیلڈ
اگر آپdesktopکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:windows،macos
ڈیفالٹ قدر:windows
اگر آپmobileکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:android،ios
ڈیفالٹ قدر:android
اگر آپtabletکوdeviceفیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں:android،ios
ڈیفالٹ قدر:android - pingbackقسم: string | null
_url مکمل شدہ ٹاسک کا نوٹیفکیشن URL
اختیاری فیلڈ
ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
آپ ‘$id’ اسٹرنگ کو$idمتغیر کے طور پر اور ‘$tag’ کو urlencoded$tagمتغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
نوٹ:pingback_urlمیں خصوصی حروف urlencoded ہو جائیں گے؛
یعنی،#حرف%23میں انکوڈ ہو جائے گا - postbackقسم: string
_data postback_url ڈیٹا ٹائپ
اگر آپpostback_urlمتعین کریں تو درکار فیلڈ
اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا
ممکنہ اقدار:regular،html - postbackقسم: string | null
_url ٹاسک کے نتائج بھیجنے کے لیے URL
اختیاری فیلڈ
ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کوgzipفارمیٹ میں کمپریس کر کے آپ کے متعین کردہpostback_urlپر POST درخواست کے ذریعے بھیجیں گے
آپ ‘$id’ اسٹرنگ کو$idمتغیر کے طور پر اور ‘$tag’ کو urlencoded$tagمتغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
مثال:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
نوٹ:postback_urlمیں خصوصی حروف urlencoded ہو جائیں گے؛
یعنی،#حرف%23میں انکوڈ ہو جائے گا - priorityقسم: integer | null
- 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قدر دیکھیں گے
- قسم: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: object | null
نتائج کی صف
اس صورت میں قدر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/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"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": null
}
]
}