Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

لائیو 'Google Ads 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 آپریشنز

لائیو '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 واپس کرتا ہے، اور جب Google نے اصطلاح درست کی ہو تو spell بھی۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ یہ کلاسیکی تلاش کے حجم کا عدد ہے؛ لوگ اس کے بجائے کسی اسسٹنٹ سے کتنی بار پوچھتے ہیں، اس کے لیے post_dataforseo_ai_keyword_volume_live استعمال کریں۔ اس endpoint کے submit اور fetch ہم منصب یہی کام async طریقے سے، اسی قیمت پر کرتے ہیں، ان بیچز کے لیے جو انتظار کے لیے بہت بڑے ہوں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.09۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی
application/json
  • قسم: array (object | null)[]
    • date_from
      قسم: string | null

      وقت کی حد کی شروعاتی تاریخ
      اختیاری فیلڈ
      تاریخ کی شکل: "yyyy-mm-dd"
      کم از کم قدر: موجودہ تاریخ سے 4 سال
      ڈیفالٹ طور پر ڈیٹا پچھلے 12 ماہ کے لیے واپس کیا جاتا ہے؛
      نوٹ: متعین کردہ تاریخ date_to اور/یا کل کی تاریخ سے بڑی نہیں ہو سکتی؛اگر Status endpoint actual_data فیلڈ میں false واپس کرے تو date_from گزشتہ سے پچھلے مہینے اور اس سے پہلے تک مقرر کیا جا سکتا ہے؛
      اگر Status endpoint actual_data فیلڈ میں true واپس کرے تو date_from گزشتہ مہینے اور اس سے پہلے تک مقرر کیا جا سکتا ہے

    • date_to
      قسم: string | null

      وقت کی حد کی آخری تاریخ
      اختیاری فیلڈ
      نوٹ: متعین کردہ تاریخ گزشتہ مہینے سے آگے نہیں ہو سکتی، Google Ads موجودہ مہینے کا ڈیٹا واپس نہیں کرتا؛
      اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر کل کی تاریخ استعمال ہوگی
      تاریخ کی شکل: "yyyy-mm-dd"
      مثال:
      "2022-11-30"

    • include_adult_keywords
      قسم: boolean | null

      بالغ مواد سے وابستہ کی ورڈز شامل کریں
      اختیاری فیلڈ
      اگر_true پر سیٹ کریں تو جواب میں بالغ کی ورڈز شامل ہوں گی
      ڈیفالٹ قدر:_false
      نوٹ_کریں کہ Google Ads پابندیوں_کی وجہ سے API ایسی کی ورڈز کے لیے کوئی ڈیٹا واپس نہیں کر سکتاn

    • keywords
      قسم: array string[]

      کی ورڈز
      درکار فیلڈ
      آپ زیادہ سے زیادہ کتنے کی ورڈز متعین کر سکتے ہیں: 1000
      ہر کی ورڈ کے لیے زیادہ سے زیادہ حروف: 80
      ہر کی ورڈ فریز کے لیے زیادہ سے زیادہ الفاظ: 10
      آپ کی متعین کردہ کی ورڈز کو لوئر کیس فارمیٹ میں تبدیل کر دیا جائے گا
      نوٹ #1: Google Ads بعض کی ورڈ گروپس کے لیے کوئی ڈیٹا واپس نہیں کر سکتا؛
      نوٹ #2: Google Ads ملتے جلتے کی ورڈز کے گروپس کے لیے مشترکہ سرچ والیوم قدریں فراہم کرتا ہے
      ملتے جلتے کی ورڈز کے لیے سرچ والیوم حاصل کرنے کے لیے ہم تجویز دیتے ہیں کہ ایسی کی ورڈز الگ الگ درخواستوں میں جمع کرائیں؛
      نوٹ #3: Google Ads کچھ علامات اور حروف (مثلاً UTF علامات، ایموجی) استعمال کرنے کی اجازت نہیں دیتا، اس لیے ٹاسک سیٹ کرتے وقت آپ انہیں استعمال نہیں کر سکتے؛
      یہ جاننے کے لیے کہ کون سی علامات اور حروف استعمال کیے جا سکتے ہیں، یہ مضمون دیکھیں

      DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں

    • language_code
      قسم: string | null

      سرچ انجن زبان کا کوڈ
      اختیاری فیلڈ
      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ https://api.dataforseo.com/v3/keywords_data/google_ads/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      en

    • language_name
      قسم: string | null

      سرچ انجن زبان کا پورا نام
      اختیاری فیلڈ
      آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ https://api.dataforseo.com/v3/keywords_data/google_ads/languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      English

    • location_code
      قسم: integer | null

      سرچ انجن مقام کا کوڈ
      اختیاری فیلڈ
      اگر آپ مقام متعین نہ کریں تو آپ کو عالمی نتائج ملیں گے، یعنی تمام دستیاب مقامات کے لیے؛
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں؛
      آپ سرچ انجنوں کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ https://api.dataforseo.com/v3/keywords_data/google_ads/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      2840

    • location_coordinate
      قسم: string | null

      مقام کے GPS نقاط
      اختیاری فیلڈ
      اگر آپ مقام متعین نہ کریں تو آپ کو عالمی نتائج ملیں گے، یعنی تمام دستیاب مقامات کے لیے؛
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_code متعین کرنے کی ضرورت نہیں؛
      location_coordinate پیرامیٹر "latitude,longitude" کی شکل میں متعین کرنا چاہیے؛
      ڈیٹا اس ملک کے لیے فراہم کیا جائے گا جس سے متعین نقاط تعلق رکھتے ہیں؛
      مثال:
      52.6178549,-155.352142

    • location_name
      قسم: string | null

      سرچ انجن مقام کا پورا نام
      اختیاری فیلڈ
      اگر آپ مقام متعین نہ کریں تو آپ کو عالمی نتائج ملیں گے، یعنی تمام دستیاب مقامات کے لیے؛
      اگر آپ یہ فیلڈ استعمال کریں تو location_code یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ https://api.dataforseo.com/v3/keywords_data/google_ads/locations پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      London,England,United Kingdom

    • search_partners
      قسم: boolean | null

      Google سرچ پارٹنرز شامل کریں
      اختیاری فیلڈ
      اگر آپ true متعین کریں تو نتائج Google اور ان پارٹنر سائٹس کے ملکیتی، چلائے جانے والے اور سنڈیکیٹ شدہ نیٹ ورکس کے لیے فراہم کیے جائیں گے جو Google تلاش کی میزبانی کرتی ہیں؛
      ڈیفالٹ قدر: false - نتائج Google سرچ سائٹس کے لیے واپس کیے جاتے ہیں

    • sort_by
      قسم: string | null

      نتائج کی ترتیب کے پیرامیٹرز
      اختیاری فیلڈ
      نتائج کو relevance، search_volume، competition_index، low_top_of_page_bid یا high_top_of_page_bid کے حساب سے نزولی ترتیب میں ترتیب دینے کے لیے یہ پیرامیٹرز استعمال کریں
      ڈیفالٹ قدر: relevance

    • tag
      قسم: string | null

      صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
      اختیاری فیلڈ
      حروف کی حد 255 ہے
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
      آپ جواب کے data صف میں متعین کردہ tag قدر دیکھیں گے

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

      عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
        • 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

          نتائج کی صف

          • competition
            قسم: string | null

            مقابلہ
            صرف ادا شدہ SERP میں دیے گئے کی ورڈ سے وابستہ مقابلے کی نسبتی مقدار کی نمائندگی کرتا ہے؛
            یہ قدر Google Ads ڈیٹا پر مبنی ہے اور درج ذیل اقدار لے سکتی ہے: HIGH، MEDIUM، LOW؛
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے؛
            اس میٹرک کے بارے میں اس help center مضمون میں مزید جانیں

          • competition_index
            قسم: integer | null

            مقابلہ
            صرف ادا شدہ SERP میں دیے گئے کی ورڈ سے وابستہ مقابلے کی نسبتی مقدار کی نمائندگی کرتا ہے؛
            یہ قدر Google Ads ڈیٹا پر مبنی ہے اور 0 سے 100 کے درمیان (شامل) ہو سکتی ہے؛
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے؛
            اس میٹرک کے بارے میں اس help center مضمون میں مزید جانیں

          • cpc
            قسم: number | null

            فی کلک لاگت
            دیے گئے کی ورڈ کے لیے دکھائے گئے اشتہار پر ہر کلک کے لیے ادا کی گئی رقم (USD) بتاتا ہے

          • high_top_of_page_bid
            قسم: number | null

            پہلے صفحے کے اوپری حصے میں اشتہار دکھانے کے لیے زیادہ سے زیادہ بولی
            ان سب سے کم بولیوں کے تقریباً 80% سے زیادہ قدر بتاتا ہے جن پر اشتہارات دکھائے گئے (اشتہار دہندگان کے لیے Google Ads اعداد و شمار کی بنیاد پر)؛
            قدر POST درخواست میں متعین مقام کے لحاظ سے مختلف ہو سکتی ہے

          • keyword
            قسم: string | null

            کی ورڈ
            کی ورڈ ڈی کوڈ شدہ %## کے ساتھ واپس کیا جاتا ہے ('+' پلس حرف کو اسپیس حرف میں ڈی کوڈ کیا جائے گا)

          • language_code
            قسم: string | null

            POST صف میں زبان کا کوڈ
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے

          • location_code
            قسم: integer | null

            POST صف میں لوکیشن کوڈ
            اگر ڈیٹا نہ ہو تو قدر null ہوتی ہے

          • low_top_of_page_bid
            قسم: number | null

            پہلے صفحے کے اوپری حصے میں اشتہار دکھانے کے لیے کم از کم بولی
            ان سب سے کم بولیوں کے تقریباً 20% سے زیادہ قدر بتاتا ہے جن پر اشتہارات دکھائے گئے (اشتہار دہندگان کے لیے Google Ads اعداد و شمار کی بنیاد پر)؛
            قدر POST درخواست میں متعین مقام کے لحاظ سے مختلف ہو سکتی ہے

          • monthly_searches
            قسم: array (object | null)[] | null

            ماہانہ تلاشیں
            اس کی ورڈ آئیڈیا پر (گزشتہ بارہ مہینوں کے لیے بطور ڈیفالٹ دستیاب) تلاشوں کی (تقریباً) تعداد کی نمائندگی کرتا ہے، جو متعین جغرافیائی مقامات کے لیے ہدف بنائی گئی ہیں؛
            اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

            • month
              قسم: integer | null

              مہینہ

            • search_volume
              قسم: integer | null

              ماہانہ اوسط سرچ والیوم کی شرح

            • year
              قسم: integer | null

              سال

          • search_partners
            قسم: boolean | null

            بتاتا ہے کہ جواب میں پارٹنر نیٹ ورکس کا ڈیٹا شامل ہے یا نہیں

          • search_volume
            قسم: integer | null فارمیٹ: int64

            ماہانہ اوسط سرچ والیوم شرح؛
            صارف کی ٹارگٹنگ کے لحاظ سے دیے گئے کی ورڈ آئیڈیا کے لیے یا تو google.com پر یا google.com اور پارٹنرز پر (تقریباً) تلاشوں کی تعداد کی نمائندگی کرتا ہے؛
            اگر ڈیٹا نہ ہو تو قدر is_nulln ہوتی ہے

          • spell
            قسم: string | null

            کی ورڈ کے درست ہجے
            نوٹ:اگر POST صف میں کی ورڈ کی ہجے غلط معلوم ہو تو درست ہجے والے کی ورڈ کے لیے ڈیٹا واپس کیا جائے گا؛
            ہم کی ورڈز کے ہجے جانچنے اور درست کرنے کے لیے Google Ads API کی فعالیت استعمال کرتے ہیں، اس لنک سے مزید جانیں

        • result_count
          قسم: integer | null فارمیٹ: int64

          result صف میں عناصر کی تعداد

        • status_code
          قسم: integer | null

          ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

        • 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 کلید درکار ہے۔

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

    application/json
Request Example for post/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live
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
            }
          ]
        }
      ]
    }
  ]
}

کامیاب آپریشن

Setting Live ‘Google Ads Search Volume’ Tasks