‘Search Volume’ লাইভ টাস্ক সেট করা

Felo API Support

MIT

সার্ভার

https://openapi.felo.ai

ক্লায়েন্ট লাইব্রেরি

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO অপারেশন

post/v1/beta/dataforseo/keywords_data/bing/search_volume/live

‘Search Volume’ লাইভ টাস্ক সেট করা

keywords তালিকার জন্য Bing সার্চ ভলিউম। keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories ও monthly_searches ফেরত দেয় — লক্ষ করুন categories আছে যা Google-এর সমতুল্য ফেরত দেয় না, আর competition_index নেই। DataForSEO-এর এনভেলপে মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ — প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। Google-এর সমতুল্য post_dataforseo_keywords_gads_search_volume_live; audience শুধু Google-এ না হলে দুটোই চালান। এই এন্ডপয়েন্টের submit ও fetch টুইন একই কাজ অ্যাসিঙ্ক্রোনাসভাবে, একই মূল্যে করে — এমন ব্যাচের জন্য যেগুলোর জন্য অপেক্ষা করা সম্ভব নয়।

মূল্য রেফারেন্স

মিটারিং: রিপোর্ট করা রেসপন্স খরচ
রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.09
রেফারেন্স গ্রাহক গুণক: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কে এটি আবার প্রয়োগ করবেন না।

এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।

বডি

application/json

টাইপ: array (object | null)[]
- date_from
  টাইপ: string | null
  
  সময়সীমার শুরুর তারিখ
  ঐচ্ছিক ফিল্ড
  সর্বনিম্ন মান: আজকের তারিখ থেকে 24 মাস;
  এই ফিল্ড উল্লেখ না করলে গত 12 মাসের ডেটা দেওয়া হবে;
  সর্বনিম্ন মান: আজকের তারিখ থেকে দুই বছর আগে;
  যদি Status endpoint actual_data ফিল্ডে false ফেরত দেয়, তাহলে date_from গত মাসের আগের মাস ও তার আগের সময়ে সেট করা যাবে;
  যদি Status endpoint actual_data ফিল্ডে true ফেরত দেয়, তাহলে date_from গত মাস ও তার আগের সময়ে সেট করা যাবে;
  তারিখের ফরম্যাট: "yyyy-mm-dd"
  উদাহরণ:
  "2020-01-01"নোট: গত বছরের তারিখগুলোর জন্য কাস্টম সময়সীমা ব্যবহার করার পরামর্শ দিই না
- date_to
  টাইপ: string | null
  
  সময়সীমার শেষ তারিখ
  ঐচ্ছিক ফিল্ড
  এই ফিল্ড উল্লেখ না করলে গত 12 মাসের ডেটা দেওয়া হবে;
  সর্বনিম্ন মান: আজকের তারিখ থেকে দুই বছর আগে;
  সর্বোচ্চ মান: আজকের তারিখ থেকে এক মাস;
  নোট: গত বছরের তারিখগুলোর জন্য কাস্টম সময়সীমা ব্যবহার করার পরামর্শ দিই না;
  তারিখের ফরম্যাট: "yyyy-mm-dd"
  উদাহরণ:
  "2020-03-15"নোট: গত বছরের তারিখগুলোর জন্য কাস্টম সময়সীমা ব্যবহার করার পরামর্শ দিই না
- device
  টাইপ: string | null
  
  ডিভাইসের ধরন
  ঐচ্ছিক ফিল্ড
  নির্দিষ্ট ডিভাইস ধরনের ডেটা চাইলে এই ফিল্ড নির্দিষ্ট করুন;
  সম্ভাব্য মান: all, mobile, desktop, tablet
  ডিফল্ট মান: all
- keywords
  টাইপ: array string[]
  
  keywords
  আবশ্যক ফিল্ড
  সর্বোচ্চ কতগুলো কীওয়ার্ড নির্দিষ্ট করতে পারবেন: 1000
  প্রতিটি কীওয়ার্ডের জন্য সর্বোচ্চ অক্ষর: 100
  নির্দিষ্ট কীওয়ার্ড lowercase ফরম্যাটে রূপান্তরিত হবে, ডেটা আলাদা অ্যারেতে দেওয়া হবে DataForSEO API-তে keyword ও keywords ফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে আরও জানুন
- language_code
  টাইপ: string
  
  সার্চ ইঞ্জিন ভাষা কোড
  language_name নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  আপনি এই ফিল্ড ব্যবহার করলে language_name নির্দিষ্ট করার প্রয়োজন নেই
  সমর্থিত ভাষা:
  en, fr, de
- language_name
  টাইপ: string
  
  সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
  language_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  আপনি এই ফিল্ড ব্যবহার করলে language_code নির্দিষ্ট করার প্রয়োজন নেই
  সমর্থিত ভাষা:
  English, French, German
- location_code
  টাইপ: integer
  
  সার্চ ইঞ্জিন অবস্থান কোড
  location_name বা location_coordinate নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
  আপনি location_code-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/keywords_data/bing/locations-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  উদাহরণ:
  2840
- location_coordinate
  টাইপ: string
  
  অবস্থানের GPS স্থানাঙ্ক
  location_name বা location_code নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  আপনি এই ফিল্ড ব্যবহার করলে location_name বা location_code নির্দিষ্ট করার প্রয়োজন নেই
  location_coordinate প্যারামিটার "latitude,longitude" ফরম্যাটে নির্দিষ্ট করতে হবে
  নির্দিষ্ট স্থানাঙ্ক যে দেশের অন্তর্গত সেই দেশের জন্য ডেটা দেওয়া হবে
  উদাহরণ:
  52.6178549,-155.352142
- location_name
  টাইপ: string
  
  সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
  location_code বা location_coordinate নির্দিষ্ট না করলে আবশ্যক ফিল্ড
  আপনি এই ফিল্ড ব্যবহার করলে location_code বা location_coordinate নির্দিষ্ট করার প্রয়োজন নেই
  আপনি location_name-সহ সার্চ ইঞ্জিনের উপলব্ধ অবস্থানের তালিকা https://api.dataforseo.com/v3/keywords_data/bing/locations-এ আলাদা রিকোয়েস্ট পাঠিয়ে পেতে পারেন
  উদাহরণ:
  London,England,United Kingdom
- search_partners
  টাইপ: boolean | null
  
  Bing সার্চ পার্টনার টাইপ
  ঐচ্ছিক ফিল্ড
  আপনি true নির্দিষ্ট করলে Bing, Yahoo, AOL এবং Bing, AOL ও Yahoo সার্চ হোস্ট করা পার্টনার সাইটজুড়ে মালিকানাধীন, পরিচালিত ও সিন্ডিকেটেড নেটওয়ার্কের জন্য ফলাফল দেওয়া হবে।
  ডিফল্ট মান: false - Bing, AOL ও Yahoo সার্চ নেটওয়ার্কের জন্য ফলাফল ফেরত দেওয়া হয়
- sort_by
  টাইপ: string | null
  
  ফলাফল সর্টিং প্যারামিটার
  ঐচ্ছিক ফিল্ড
  ফলাফলগুলো search_volume, cpc, competition বা relevance অনুযায়ী অবরোহী ক্রমে সর্ট করতে এই প্যারামিটারগুলো ব্যবহার করুন
  ডিফল্ট মান: relevance
- tag
  টাইপ: string | null
  
  ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
  ঐচ্ছিক ফিল্ড
  অক্ষরসীমা 255
  এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
  নির্দিষ্ট tag মান response-এর data অবজেক্টে পাবেন

রেসপন্স

200
টাইপ: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeLiveResponseInfo
cost
টাইপ: number | null ফরম্যাট: double

টাস্কের মোট খরচ, USD

status_code
টাইপ: integer | null

সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন

status_message
টাইপ: string | null

সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন

tasks
টাইপ: array (object | null)[] | null

টাস্কের অ্যারে

টাইপ: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeLiveTaskInfo
cost
টাইপ: number | null ফরম্যাট: double

টাস্কের মোট খরচ, USD

data
টাইপ: object | null

এতে POST রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে

propertyName
টাইপ: object | null
id
টাইপ: string | null

টাস্ক আইডেন্টিফায়ার আমাদের সিস্টেমে অনন্য টাস্ক আইডেন্টিফায়ার, UUID ফরম্যাটে

path
টাইপ: array (string | null)[] | null

URL পাথ

result
টাইপ: array (object | null)[] | null

ফলাফলের অ্যারে

categories
টাইপ: array (string | null)[] | null

পণ্য ও সেবার বিভাগ
আমাদের API এই endpoint-এর জন্য বিভাগ ফেরত দেয় না: প্যারামিটারটি সবসময় null-এর সমান হবে

competition
টাইপ: number | null

প্রতিযোগিতা
শুধুমাত্র পেইড SERP-এ প্রদত্ত কীওয়ার্ডের সঙ্গে সম্পর্কিত আপেক্ষিক প্রতিযোগিতার পরিমাণ উপস্থাপন করে। এই মানটি Bing Ads ডেটার উপর ভিত্তি করে
সম্ভাব্য মান: 0.1, 0.5,0.90.1 - কম প্রতিযোগিতা,
0.5 - মাঝারি প্রতিযোগিতা,
0.9 - উচ্চ প্রতিযোগিতা;
ডেটা না থাকলে মান null

cpc
টাইপ: number | null

প্রতি ক্লিকে খরচ
কীওয়ার্ডের জন্য ঐতিহাসিকভাবে প্রদত্ত গড় প্রতি ক্লিকে খরচ (USD) উপস্থাপন করে
ডেটা না থাকলে মান null

device
টাইপ: string | null

POST অ্যারেতে ডিভাইসের ধরন
ডেটা না থাকলে মান null

keyword
টাইপ: string | null

POST অ্যারেতে কীওয়ার্ড

language_code
টাইপ: string | null

POST অ্যারেতে ভাষা কোড
ডেটা না থাকলে মান হয় null

location_code
টাইপ: integer | null

POST অ্যারেতে অবস্থান কোড
ডেটা না থাকলে মান হয় null

monthly_searches
টাইপ: array (object | null)[] | null

মাসিক সার্চ
নির্দিষ্ট ভৌগোলিক অবস্থানকে লক্ষ্য করে এই কীওয়ার্ড আইডিয়ায় সার্চের (আনুমানিক) সংখ্যা উপস্থাপন করে (গত বারো মাসের জন্য যেভাবে উপলব্ধ)
ডেটা না থাকলে মান null

month
টাইপ: integer | null

মাস

search_volume
টাইপ: integer | null

গড় মাসিক সার্চ ভলিউম হার

year
টাইপ: integer | null

বছর

search_partners
টাইপ: boolean | null

রেসপন্সে পার্টনার নেটওয়ার্কের ডেটা অন্তর্ভুক্ত আছে কি না তা নির্দেশ করে

search_volume
টাইপ: integer | null ফরম্যাট: int64

গড় মাসিক সার্চ ভলিউম হার
ব্যবহারকারীর টার্গেটিংয়ের উপর নির্ভর করে Bing সার্চ ইঞ্জিনে প্রদত্ত কীওয়ার্ড আইডিয়ার জন্য সার্চের (আনুমানিক) সংখ্যা উপস্থাপন করে;
সার্চ ভলিউম নিকটতম দশকে রাউন্ড করা হয়;
ডেটা না থাকলে মান null

result_count
টাইপ: integer | null ফরম্যাট: int64

result অ্যারেতে এলিমেন্টের সংখ্যা

status_code
টাইপ: integer | null

টাস্কের স্ট্যাটাস কোড DataForSEO কর্তৃক তৈরি, যা নিম্নলিখিত পরিসরে হতে পারে: 10000-60000 সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন

status_message
টাইপ: string | null

টাস্কের তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন

time
টাইপ: string | null

সম্পাদনের সময়, সেকেন্ড

tasks_count
টাইপ: integer | null ফরম্যাট: int64

tasks অ্যারেতে টাস্কের সংখ্যা

tasks_error
টাইপ: integer | null ফরম্যাট: int64

ত্রুটিসহ ফেরত দেওয়া tasks অ্যারেতে টাস্কের সংখ্যা

time
টাইপ: string | null

মোট সম্পাদন সময়, সেকেন্ড

version
টাইপ: string | null

API-এর বর্তমান সংস্করণ
application/json
400

রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
401

একটি বৈধ Felo API key আবশ্যক।
402

বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
403

অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
429

রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
502

পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
503

API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
504

রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
default

ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

application/json

post/v1/beta/dataforseo/keywords_data/bing/search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

স্কিমা দেখান

{
  "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,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

সফল অপারেশন

‘Search Volume’ লাইভ টাস্ক সেট করা

প্রমাণীকরণRequired

DataForSEO

‘Search Volume’ লাইভ টাস্ক সেট করা

মূল্য রেফারেন্স