DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Baidu Organic SERP টাস্ক সেট করা
Baidu-তে একটি কিওয়ার্ডের র্যাংক করা ফলাফল কিউ করে এবং tasks[0].id-এ একটি task id ফেরত দেয়। 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,tablet
ডিফল্ট মান:desktop - getটাইপ: boolean | null
_website _url প্রতিটি র্যাংক করা ফলাফলের জন্য সরাসরি URL যোগ করুন
ঐচ্ছিক ফিল্ডtrueসেট থাকলে ফেরত দেওয়া ফলাফলে র্যাংক করা ওয়েবসাইটগুলোর সরাসরি URL থাকবে
ডিফল্টভাবে, Baidu ফলাফলের URL সার্চ ইঞ্জিন এনকোড করে
উদাহরণ:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLডিফল্ট মান:false
নোট:trueসেট থাকলে প্রতি টাস্কের খরচ 10 গুণ হবে কারণ আমাদের সিস্টেম প্রতিটি র্যাংক করা ওয়েবসাইটের সরাসরি URL ফেরত দিতে আলাদা রিকোয়েস্ট চালায় - keywordটাইপ: string
কীওয়ার্ড
আবশ্যক ফিল্ড
আপনিkeywordফিল্ডে সর্বোচ্চ 700 অক্ষর উল্লেখ করতে পারেন
সব %## ডিকোড করা হবে (‘+’ অক্ষর একটি স্পেস অক্ষরে ডিকোড হবে)
আপনাকেkeyword-এ “%” অক্ষর ব্যবহার করতে হলে তা “%25” হিসেবে উল্লেখ করুন;
আপনাকেkeyword-এ “+” অক্ষর ব্যবহার করতে হলে তা “%2B” হিসেবে উল্লেখ করুনDataForSEO API-তে
keywordএবংkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে Help Center নিবন্ধে জানুন - languageটাইপ: string
_code সার্চ ইঞ্জিন ভাষা কোড
আবশ্যক ফিল্ড যদি আপনি উল্লেখ না করেনlanguage_name
আপনিhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ আলাদা রিকোয়েস্ট পাঠিয়েlanguage_code-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা পেতে পারেনমনে রাখবেন Baidu সার্চ ইঞ্জিনে শুধুzh_CNভাষা কোডযুক্তChinese (Simplified)ভাষা সমর্থিত। তবে Baidu অন্য ভাষার কোয়েরির জন্যও ফলাফল ফেরত দিতে পারে, তাইkeywordচীনা ভাষায় উল্লেখ করা বাধ্যতামূলক নয়উদাহরণ:
zh_CN - languageটাইপ: string
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
আবশ্যক ফিল্ড যদি আপনি উল্লেখ না করেনlanguage_code
আপনিhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ আলাদা রিকোয়েস্ট পাঠিয়েlanguage_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকা পেতে পারেনমনে রাখবেন Baidu সার্চ ইঞ্জিনে শুধুChinese (Simplified)ভাষা সমর্থিত। তবে Baidu অন্য ভাষার কোয়েরির জন্যও ফলাফল ফেরত দিতে পারে, তাইkeywordচীনা ভাষায় উল্লেখ করা বাধ্যতামূলক নয়উদাহরণ:
Chinese (Simplified) - locationটাইপ: integer
_code সার্চ ইঞ্জিন অবস্থান কোড
আবশ্যক ফিল্ড যদি আপনি উল্লেখ না করেনlocation_nameবাlocation_coordinate
এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_coordinateউল্লেখ করার প্রয়োজন নেই
আপনিhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ আলাদা রিকোয়েস্ট পাঠিয়েlocation_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা পেতে পারেন
উদাহরণ: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উল্লেখ করার প্রয়োজন নেই
আপনিhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ আলাদা রিকোয়েস্ট পাঠিয়েlocation_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা পেতে পারেন
উদাহরণ:New York,New York,United States - maxটাইপ: integer | null
_crawl _pages - osটাইপ: string | null
ডিভাইস অপারেটিং সিস্টেম
ঐচ্ছিক ফিল্ডdeviceফিল্ডেdesktopউল্লেখ থাকলে নিচের মধ্যে থেকে বেছে নিন:windows,macos
ডিফল্ট মান:windowsdeviceফিল্ডেmobileউল্লেখ থাকলে নিচের মধ্যে থেকে বেছে নিন:android,ios
ডিফল্ট মান:androiddeviceফিল্ডেtabletউল্লেখ থাকলে নিচের মধ্যে থেকে বেছে নিন:android,ios
ডিফল্ট মান:android - pingbackটাইপ: string | null
_url সম্পন্ন টাস্কের নোটিফিকেশন URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা আপনার নির্দিষ্ট URL-এ GET রিকোয়েস্ট পাঠিয়ে জানাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল হিসেবে এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
নোট:pingback_url-এ বিশেষ অক্ষর URL-এনকোড হবে;
অর্থাৎ,#অক্ষরটি%23হিসেবে এনকোড হবে - postbackটাইপ: string
_data postback_url ডেটাটাইপ
আবশ্যক ফিল্ড যদিpostback_urlউল্লেখ করা থাকে
আপনার সার্ভারে পাঠানো ডেটার ধরনের সাথে মেলে
সম্ভাব্য মান:regular,html - postbackটাইপ: string | null
_url টাস্কের ফলাফল পাঠানোর URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা তার ফলাফলgzipফরম্যাটে কম্প্রেস করে আপনার নির্দিষ্টpostback_url-এ POST রিকোয়েস্ট পাঠাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল হিসেবে এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
নোট:postback_url-এ বিশেষ অক্ষর URL-এনকোড হবে;
অর্থাৎ,#অক্ষরটি%23হিসেবে এনকোড হবে - priorityটাইপ: integer | null
- stopটাইপ: array (object | null)[] | null
_crawl _on _match ক্রলিং বন্ধ করার জন্য টার্গেটের অ্যারে ঐচ্ছিক ফিল্ড নির্দিষ্ট করা হলে, response-এ নির্দিষ্ট 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
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন
- টাইপ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: 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 সম্পূর্ণ 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
রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
- 401
একটি বৈধ Felo API key আবশ্যক।
- 402
বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
- 403
অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
- 429
রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
- 502
পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
- 503
API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
- 504
রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
- default
ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।
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
}
]
}