DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Seznam Organic SERP টাস্ক সেট করা
Seznam-এ একটি কিওয়ার্ডের র্যাংক করা ফলাফল কিউ করে এবং 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)[]
- calculateটাইপ: boolean | null
_rectangles উন্নত ফলাফলে SERP এলিমেন্টের জন্য পিক্সেল র্যাঙ্কিং গণনা করুন
ঐচ্ছিক ফিল্ড
পিক্সেল র্যাঙ্কিং মানে ফলাফল স্নিপেট ও স্ক্রিনের উপরের বাম কোণের মধ্যে দূরত্ব;
আরও জানতে Help Center দেখুন>>
ডিফল্টভাবে, প্যারামিটারটিfalse-এ সেট থাকে
নোট:true-তে সেট করলে প্রতি টাস্কের চার্জ 2 দিয়ে গুণ হবে - depthটাইপ: integer | null
- deviceটাইপ: string | null
ডিভাইসের ধরন
ঐচ্ছিক ফিল্ড
নির্দিষ্ট ডিভাইসের ধরনের জন্য ফলাফল ফেরত দিন
নিম্নলিখিত মান নিতে পারে:desktop,mobile
ডিফল্ট মান:desktop - keywordটাইপ: string
কীওয়ার্ড
আবশ্যক ফিল্ড
আপনিkeywordফিল্ডে সর্বোচ্চ 700 অক্ষর উল্লেখ করতে পারেন
সব %## ডিকোড করা হবে (‘+’ অক্ষর একটি স্পেস অক্ষরে ডিকোড হবে)
আপনাকেkeyword-এ “%” অক্ষর ব্যবহার করতে হলে তা “%25” হিসেবে উল্লেখ করুন;
আপনাকেkeyword-এ “+” অক্ষর ব্যবহার করতে হলে তা “%2B” হিসেবে উল্লেখ করুনDataForSEO API-তে
keywordএবংkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে Help Center নিবন্ধে জানুন - languageটাইপ: string
_code সার্চ ইঞ্জিন ভাষা কোড
language_nameনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlanguage_nameনির্দিষ্ট করার প্রয়োজন নেই
আপনিlanguage_code-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:cs - languageটাইপ: string
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
language_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlanguage_codeনির্দিষ্ট করার প্রয়োজন নেই
আপনিlanguage_name-সহ সার্চ ইঞ্জিনের উপলব্ধ ভাষার তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languages-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:Czech - locationটাইপ: integer
_code সার্চ ইঞ্জিন অবস্থান কোড
location_nameনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameনির্দিষ্ট করার প্রয়োজন নেই
আপনিlocation_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:2840 - locationটাইপ: string
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
location_codeনির্দিষ্ট না করলে আবশ্যক ফিল্ড
আপনি এই ফিল্ড ব্যবহার করলেlocation_codeনির্দিষ্ট করার প্রয়োজন নেই
আপনিlocation_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকাhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেন
উদাহরণ:London,England,United Kingdom - maxটাইপ: integer | null
_crawl _pages - osটাইপ: string | null
ডিভাইস অপারেটিং সিস্টেম
ঐচ্ছিক ফিল্ডdeviceফিল্ডেdesktopউল্লেখ থাকলে নিচের মধ্যে থেকে বেছে নিন:windows,macos
ডিফল্ট মান:windowsdeviceফিল্ডেmobileউল্লেখ থাকলে নিচের মধ্যে থেকে বেছে নিন: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,advanced,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
- seটাইপ: string | null
_domain সার্চ ইঞ্জিন ডোমেইন
ঐচ্ছিক ফিল্ড
আমরা প্রাসঙ্গিক সার্চ ইঞ্জিন ডোমেইন স্বয়ংক্রিয়ভাবে বেছে নিই
তবে আপনি এই ফিল্ডে কাস্টম সার্চ ইঞ্জিন ডোমেইন সেট করতে পারেন
উদাহরণ: - searchটাইপ: string | null
_param সার্চ কুয়েরির অতিরিক্ত প্যারামিটার
ঐচ্ছিক ফিল্ড - 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অবজেক্টে পাবেন - urlটাইপ: string | null
সরাসরি সার্চ URL
ঐচ্ছিক ফিল্ড
আপনি সরাসরি URL উল্লেখ করতে পারেন এবং আমরা তা প্রয়োজনীয় ফিল্ডে পার্স করব;
মনে রাখবেন, এই পদ্ধতি আমাদের API-এর জন্য প্রক্রিয়া করা সবচেয়ে কঠিন এবং এতে URL-এ ভাষা ও অবস্থান সঠিকভাবে মিলতে হবে;
বেশিরভাগ ক্ষেত্রে আমরা এই পদ্ধতি ব্যবহার করার পরামর্শ দিই না
- টাইপ: object | null · Response36Afe1097B20_SerpSeznamOrganicTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_SerpSeznamOrganicTaskPostTaskInfo
- 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/seznam/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "cs",
"location_code": 2203,
"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": null
}
]
}