DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google News SERP টাস্ক সেট করা
Google-এ একটি কিওয়ার্ডের সংবাদ ফলাফল কিউ করে এবং 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)[]
- browserটাইপ: integer | null
_screen _height ব্রাউজার স্ক্রিনের উচ্চতা
ঐচ্ছিক ফিল্ড
কোনো নির্দিষ্ট ডিভাইসের জন্য পিক্সেল র্যাঙ্কিং গণনা করতে আপনি কাস্টম ব্রাউজার স্ক্রিনের উচ্চতা সেট করতে পারেন;
ডিফল্টভাবে, প্যারামিটারটি
1080সেট থাকে;নোট: এই প্যারামিটার ব্যবহার করতে
calculate_rectanglestrueসেট করুন - browserটাইপ: integer | null
_screen _resolution _ratio ব্রাউজার স্ক্রিনের রেজোলিউশন অনুপাত
ঐচ্ছিক ফিল্ড
কোনো নির্দিষ্ট ডিভাইসের জন্য পিক্সেল র্যাঙ্কিং গণনা করতে আপনি কাস্টম ব্রাউজার স্ক্রিনের রেজোলিউশন অনুপাত সেট করতে পারেন;
ডিফল্টভাবে, প্যারামিটারটি
1সেট থাকে;নোট: এই প্যারামিটার ব্যবহার করতে
calculate_rectanglestrueসেট করুন - browserটাইপ: integer | null ফরম্যাট: int64
_screen _width ব্রাউজার স্ক্রিনের প্রস্থ
ঐচ্ছিক ফিল্ড
কোনো নির্দিষ্ট ডিভাইসের জন্য পিক্সেল র্যাঙ্কিং গণনা করতে আপনি কাস্টম ব্রাউজার স্ক্রিনের প্রস্থ সেট করতে পারেন;
ডিফল্টভাবে, প্যারামিটারটি
1920সেট থাকে;নোট: এই প্যারামিটার ব্যবহার করতে
calculate_rectanglestrueসেট করুন - calculateটাইপ: boolean | null
_rectangles অ্যাডভান্সড ফলাফলে SERP এলিমেন্টের জন্য পিক্সেল র্যাংকিং গণনা করুন
ঐচ্ছিক ফিল্ড
পিক্সেল র্যাংকিং ফলাফল স্নিপেট এবং স্ক্রিনের উপরের বাম কোণের মধ্যে দূরত্ব বোঝায়;
ডিফল্টভাবে, প্যারামিটার
falseসেট থাকেনোট:
trueসেট থাকলে প্রতি টাস্কের খরচ 2 গুণ হবে - depthটাইপ: integer | null
পার্সিং গভীরতা
ঐচ্ছিক ফিল্ড
SERP-এ ফলাফলের সংখ্যা
ডিফল্ট মান:
10সর্বোচ্চ মান:
700
আপনার অ্যাকাউন্ট থেকে প্রতিটি SERP-এর জন্য বিল নেওয়া হবে যাতে সর্বোচ্চ 10টি ফলাফল থাকে;গভীরতা 10-এর বেশি সেট করলে অতিরিক্ত চার্জ হতে পারে যদি সার্চ ইঞ্জিন 10-এর বেশি ফলাফল ফেরত দেয়;
নির্দিষ্ট গভীরতা রেসপন্সে ফলাফলের সংখ্যার চেয়ে বেশি হলে পার্থক্য স্বয়ংক্রিয়ভাবে আপনার অ্যাকাউন্ট ব্যালেন্সে ফেরত দেওয়া হবে;
খরচ Pricing পেজে হিসাব করা যায়।
- keywordটাইপ: string
কীওয়ার্ড
আবশ্যক ফিল্ড
আপনি
keywordফিল্ডে সর্বোচ্চ 700 অক্ষর নির্দিষ্ট করতে পারেনসব %## ডিকোড করা হবে (‘+’ অক্ষর একটি স্পেস অক্ষরে ডিকোড হবে)
আপনার
keyword-এর জন্য “%” অক্ষর ব্যবহার করতে হলে এটি “%25” হিসেবে নির্দিষ্ট করুন;আপনার
keyword-এর জন্য “+” অক্ষর ব্যবহার করতে হলে এটি “%2B” হিসেবে নির্দিষ্ট করুন;এই ফিল্ডে ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’ ইত্যাদি প্যারামিটার থাকলে প্রতি টাস্কের চার্জ 5 গুণ হবে
নোট: ‘cache:’ প্যারামিটারযুক্ত কোয়েরি সমর্থিত নয় এবং validation error ফেরত দেবে
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-এ পৃথক রিকোয়েস্ট পাঠিয়ে পেতে পারেনউদাহরণ:
en - 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,200 - 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 পেজ ক্রল সীমা
ঐচ্ছিক ফিল্ড
ক্রল করার জন্য সার্চ ফলাফল পেজের সংখ্যা
সর্বোচ্চ মান:
100নোট:
max_crawl_pagesওdepthপ্যারামিটার একে অপরের পরিপূরক;আরও জানুন আমাদের Help Center-এ
- osটাইপ: string | null
ডিভাইস অপারেটিং সিস্টেম
ঐচ্ছিক ফিল্ড
মনে রাখবেন, এই API শুধু ডেস্কটপের জন্য ফলাফল দেয়
নিম্নলিখিত মান থেকে বেছে নিন:
windows,macosডিফল্ট মান:
windows - 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-এ এনকোড করা হবে
আমাদের Help Center-এ আরও জানুন
- postbackটাইপ: string
_data postback_url ডেটাটাইপ
postback_urlনির্দিষ্ট করলে আবশ্যক ফিল্ডআপনার সার্ভারে পাঠানো ডেটাটাইপের সঙ্গে মেলে
সম্ভাব্য মান:
advanced,html - postbackটাইপ: string | null
_url টাস্কের ফলাফল পাঠানোর URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা
gzipফরম্যাটে সংকুচিত ফলাফলসহ একটি POST রিকোয়েস্ট আপনার নির্দিষ্ট করাpostback_url-এ পাঠাবআপনি ‘$id’ স্ট্রিংকে
$idভেরিয়েবল হিসেবে এবং ‘$tag’কে urlencoded$tagভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।উদাহরণ:
http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagনোট:
postback_url-এর বিশেষ অক্ষর urlencode করা হবে;যেমন,
#অক্ষরটি%23হিসেবে এনকোড হবে
আমাদের Help Center-এ আরও জানুন
- priorityটাইপ: integer | null
টাস্কের অগ্রাধিকার
ঐচ্ছিক ফিল্ড
নিম্নলিখিত মান নিতে পারে:
1 – সাধারণ সম্পাদন অগ্রাধিকার (ডিফল্টভাবে সেট)
2 – উচ্চ সম্পাদন অগ্রাধিকার
উচ্চ সম্পাদন অগ্রাধিকারযুক্ত টাস্কের জন্য অতিরিক্ত চার্জ নেওয়া হবে।খরচ Pricing পেজে হিসাব করা যায়।
- seটাইপ: string | null
_domain সার্চ ইঞ্জিন ডোমেইন
ঐচ্ছিক ফিল্ড
আপনার নির্দিষ্ট অবস্থান ও ভাষা অনুযায়ী আমরা প্রাসঙ্গিক সার্চ ইঞ্জিন ডোমেইন স্বয়ংক্রিয়ভাবে বেছে নিই
তবে, আপনি এই ফিল্ডে একটি কাস্টম সার্চ ইঞ্জিন ডোমেইন সেট করতে পারেন
উদাহরণ:
- searchটাইপ: string | null
_param সার্চ কোয়েরির অতিরিক্ত প্যারামিটার
ঐচ্ছিক ফিল্ড
- tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরের সীমা 255
আপনি এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে তা ফলাফলের সঙ্গে মেলাতে পারেন
আপনি নির্দিষ্ট
tagমান response-এরdataঅবজেক্টে পাবেন - urlটাইপ: string | null
সার্চ কোয়েরির সরাসরি URL
ঐচ্ছিক ফিল্ড
আপনি একটি সরাসরি URL নির্দিষ্ট করতে পারেন এবং আমরা সেটি প্রয়োজনীয় ফিল্ডে ভাগ করে নেব;
মনে রাখবেন, এই পদ্ধতি আমাদের API-এর জন্য প্রক্রিয়া করা সবচেয়ে কঠিন এবং URL-এ সঠিক ভাষা ও অবস্থান নির্দিষ্ট করাও প্রয়োজন। বেশিরভাগ ক্ষেত্রে আমরা এই পদ্ধতি ব্যবহার করার পরামর্শ দিই না;
উদাহরণ:
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleNewsTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_SerpGoogleNewsTaskPostTaskInfo
- 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/google/news/task_post \
--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": null
}
]
}