লাইভ ‘Google Ads Search Volume’ টাস্ক সেট করুন
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
লাইভ ‘Google Ads Search Volume’ টাস্ক সেট করুন
keywords-এর তালিকার জন্য Google Ads সার্চ ভলিউম। keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc ও monthly_searches ফেরত দেয়, সাথে spell যখন Google শব্দটি সংশোধন করেছে। DataForSEO-এর এনভেলপে মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ - প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। এটি প্রচলিত সার্চ-ভলিউম সংখ্যা; মানুষ কতবার কোনো অ্যাসিস্ট্যান্টকে জিজ্ঞাসা করে তা জানতে post_dataforseo_ai_keyword_volume_live ব্যবহার করুন। এই এন্ডপয়েন্টের সাবমিট ও ফেচ জমজ একই কাজ অ্যাসিঙ্ক্রোনাসভাবে, একই দামে করে — যেসব ব্যাচের জন্য অপেক্ষা করা সম্ভব নয়।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা রেসপন্স খরচ
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.09
- রেফারেন্স গ্রাহক গুণক: 1.0। ইতিমধ্যে নিষ্পত্তি হওয়া গ্রাহক অর্থের উপর এটি আবার প্রয়োগ করবেন না
শুধুমাত্র রেফারেন্স মেটাডেটা, কোনো অ্যাকাউন্ট কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- dateটাইপ: string | null
_from সময়সীমার শুরুর তারিখ
ঐচ্ছিক ফিল্ড
তারিখের ফরম্যাট:"yyyy-mm-dd"
সর্বনিম্ন মান: বর্তমান তারিখ থেকে সর্বোচ্চ 4 বছর আগে পর্যন্ত
ডিফল্টভাবে, গত 12 মাসের ডেটা ফেরত দেওয়া হয়;
নোট: নির্দিষ্ট তারিখdate_to-এ নির্দিষ্ট তারিখ এবং/অথবা গতকালের তারিখের চেয়ে বেশি হতে পারবে না; যদি Status endpointactual_dataফিল্ডেfalseফেরত দেয়, তাহলেdate_fromগত মাসের আগের মাস এবং তার আগে পর্যন্ত সেট করা যাবে;
যদি Status endpointactual_dataফিল্ডেtrueফেরত দেয়, তাহলেdate_fromগত মাস এবং তার আগে পর্যন্ত সেট করা যাবে - dateটাইপ: string | null
_to সময়সীমার শেষ তারিখ
ঐচ্ছিক ফিল্ড
নোট: নির্দিষ্ট তারিখ গত মাসের চেয়ে বেশি হতে পারবে না, Google Ads বর্তমান মাসের ডেটা ফেরত দেয় না;
আপনি এই ফিল্ড নির্দিষ্ট না করলে ডিফল্টভাবে গতকালের তারিখ ব্যবহৃত হবে
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2022-11-30" - includeটাইপ: boolean | null
_adult _keywords - keywordsটাইপ: array string[]
কীওয়ার্ড
আবশ্যক ফিল্ড
সর্বোচ্চ কতগুলো কীওয়ার্ড নির্দিষ্ট করতে পারবেন: 1000
প্রতিটি কীওয়ার্ডের জন্য সর্বোচ্চ অক্ষর: 80
প্রতিটি কীওয়ার্ড বাক্যাংশের জন্য সর্বোচ্চ শব্দ: 10
আপনার নির্দিষ্ট করা কীওয়ার্ড lowercase ফরম্যাটে রূপান্তরিত হবে
নোট #1: Google Ads কিছু কীওয়ার্ড গোষ্ঠীর জন্য কোনো ডেটা ফেরত নাও দিতে পারে;
নোট #2: Google Ads একই ধরনের কীওয়ার্ড গোষ্ঠীর জন্য সম্মিলিত সার্চ ভলিউম মান প্রদান করে
একই ধরনের কীওয়ার্ডের সার্চ ভলিউম পেতে আমরা এ ধরনের কীওয়ার্ড আলাদা রিকোয়েস্টে জমা দেওয়ার পরামর্শ দিই;
নোট #3: Google Ads কিছু প্রতীক ও অক্ষর (যেমন UTF প্রতীক, ইমোজি) ব্যবহারের অনুমতি দেয় না, তাই টাস্ক সেট করার সময় সেগুলো ব্যবহার করা যাবে না;
কোন প্রতীক ও অক্ষর ব্যবহার করা যাবে তা জানতে এই নিবন্ধ দেখুনDataForSEO API-তে
keywordওkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে জানুন - languageটাইপ: string | null
_code সার্চ ইঞ্জিন ভাষা কোড
ঐচ্ছিক ফিল্ডlanguage_code-সহ উপলব্ধ সার্চ ইঞ্জিন ভাষার তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
উদাহরণ:en - languageটাইপ: string | null
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
ঐচ্ছিক ফিল্ডlanguage_name-সহ উপলব্ধ সার্চ ইঞ্জিন ভাষার তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
উদাহরণ:English - locationটাইপ: integer | null
_code সার্চ ইঞ্জিন অবস্থান কোড
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেই;location_code-সহ উপলব্ধ সার্চ ইঞ্জিন অবস্থানের তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
উদাহরণ:2840 - locationটাইপ: string | null
_coordinate অবস্থানের GPS স্থানাঙ্ক
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_codeনির্দিষ্ট করার প্রয়োজন নেই;location_coordinateপ্যারামিটার "latitude,longitude" ফরম্যাটে উল্লেখ করতে হবে;
ডেটা সেই দেশের জন্য দেওয়া হবে যার অন্তর্গত নির্দিষ্ট স্থানাঙ্ক;
উদাহরণ:52.6178549,-155.352142 - locationটাইপ: string | null
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_codeবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইlocation_name-সহ উপলব্ধ সার্চ ইঞ্জিন অবস্থানের তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
উদাহরণ:London,England,United Kingdom - searchটাইপ: boolean | null
_partners - sortটাইপ: string | null
_by ফলাফল সর্টিং প্যারামিটার
ঐচ্ছিক ফিল্ড
ফলাফলগুলোকেrelevance,search_volume,competition_index,low_top_of_page_bidবাhigh_top_of_page_bidঅনুযায়ী অবরোহী ক্রমে সাজাতে এই প্যারামিটারগুলো ব্যবহার করুন
ডিফল্ট মান:relevance - tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅ্যারেতে পাবেন
- টাইপ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
- 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
ফলাফলের অ্যারে
- competitionটাইপ: string | null
- competitionটাইপ: integer | null
_index - cpcটাইপ: number | null
প্রতি ক্লিকে খরচ
প্রদত্ত কীওয়ার্ডের জন্য দেখানো বিজ্ঞাপনে প্রতিটি ক্লিকের জন্য প্রদত্ত পরিমাণ (USD) নির্দেশ করে - highটাইপ: number | null
_top _of _page _bid প্রথম পৃষ্ঠার শীর্ষে বিজ্ঞাপন দেখানোর জন্য সর্বোচ্চ বিড
যে সর্বনিম্ন বিডগুলোর জন্য বিজ্ঞাপন দেখানো হয়েছিল তার প্রায় 80%-এর বেশি মান নির্দেশ করে (বিজ্ঞাপনদাতাদের জন্য Google Ads পরিসংখ্যানের ভিত্তিতে);
POST রিকোয়েস্টে নির্দিষ্ট অবস্থানের উপর নির্ভর করে মান ভিন্ন হতে পারে - keywordটাইপ: string | null
কীওয়ার্ড
কীওয়ার্ড ডিকোড করা %##-সহ ফেরত দেওয়া হয় (প্লাস অক্ষর '+' স্পেস অক্ষরে ডিকোড হবে) - languageটাইপ: string | null
_code POST অ্যারেতে ভাষা কোড
ডেটা না থাকলে মান হয়null - locationটাইপ: integer | null
_code POST অ্যারেতে অবস্থান কোড
ডেটা না থাকলে মান হয়null - lowটাইপ: number | null
_top _of _page _bid প্রথম পৃষ্ঠার শীর্ষে বিজ্ঞাপন দেখানোর জন্য সর্বনিম্ন বিড
যে সর্বনিম্ন বিডগুলোর জন্য বিজ্ঞাপন দেখানো হয়েছিল তার প্রায় 20%-এর বেশি মান নির্দেশ করে (বিজ্ঞাপনদাতাদের জন্য Google Ads পরিসংখ্যানের ভিত্তিতে);
POST রিকোয়েস্টে নির্দিষ্ট অবস্থানের উপর নির্ভর করে মান ভিন্ন হতে পারে - monthlyটাইপ: array (object | null)[] | null
_searches মাসিক সার্চ
নির্দিষ্ট ভৌগোলিক অবস্থানকে লক্ষ্য করে এই কীওয়ার্ড আইডিয়ায় সার্চের (আনুমানিক) সংখ্যা উপস্থাপন করে (ডিফল্টভাবে গত বারো মাসের জন্য যেভাবে উপলব্ধ);
ডেটা না থাকলে মানnull- monthটাইপ: integer | null
মাস
- searchটাইপ: integer | null
_volume গড় মাসিক সার্চ ভলিউম হার
- yearটাইপ: integer | null
বছর
- searchটাইপ: boolean | null
_partners রেসপন্সে পার্টনার নেটওয়ার্কের ডেটা অন্তর্ভুক্ত আছে কি না তা নির্দেশ করে
- searchটাইপ: integer | null ফরম্যাট: int64
_volume গড় মাসিক সার্চ ভলিউম হার;
ব্যবহারকারীর টার্গেটিংয়ের উপর নির্ভর করে google.com-এ বা google.com ও পার্টনার-এ প্রদত্ত কীওয়ার্ড আইডিয়ার জন্য সার্চের (আনুমানিক) সংখ্যা উপস্থাপন করে;
ডেটা না থাকলে মানnull - spellটাইপ: string | 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/keywords_data/google_ads/search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"keywords": [
"buy laptop",
"cheap laptops for sale",
"purchase laptop"
],
"date_from": "2021-08-01",
"search_partners": true
}
]'
{
"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,
"spell": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"competition": null,
"competition_index": null,
"search_volume": null,
"low_top_of_page_bid": null,
"high_top_of_page_bid": null,
"cpc": null,
"monthly_searches": [
{
"year": null,
"month": null,
"search_volume": null
}
]
}
]
}
]
}