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

'Ad Traffic By Keywords' ٹاسکس سیٹ کرنا

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

'Ad Traffic By Keywords' ٹاسکس سیٹ کرنا

​

دی گئی bid اور match قسم پر keywords کے لیے کلکس، ایمپریشنز اور اخراجات کی پیش گوئی قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ search_partners میں Google کا پارٹنر نیٹ ورک شامل ہوتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ یہاں یہ واحد Google Ads endpoint ہے جس کا کوئی لائیو متغیر نہیں - پیش گوئی ہمیشہ قطار میں جاتی ہے۔ get_dataforseo_keywords_gads_ad_traffic_fetch سے حاصل کریں۔

قیمت کا حوالہ

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

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

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

      زیادہ سے زیادہ حسب ضرورت بولی
      درکار فیلڈ
      جمع کیا گیا ڈیٹا اس قدر کی بنیاد پر ہوگا
      یہ اس قیمت کو ظاہر کرتا ہے جو آپ کسی اشتہار کے لیے ادا کرنے کو تیار ہیں؛ یہاں جتنی زیادہ قدر متعین کریں گے، واپس کیے گئے میٹرکس میں اتنی ہی زیادہ قدریں ملیں گی
      اس help center مضمون میں مزید جانیں

    • date_from
      قسم: string

      پیش گوئی کی وقت کی حد کی شروعاتی تاریخ
      اگر آپ date_to متعین کریں تو درکار فیلڈ
      اگر آپ date_from اور date_to متعین کریں تو date_interval متعین کرنے کی ضرورت نہیں
      کم از کم قدر کل کی تاریخ ہے
      date_from میں متعین کردہ قدر date_to سے آگے نہیں ہونی چاہیے
      تاریخ کی شکل: "yyyy-mm-dd"
      مثال:
      "2021-10-30"اگر Status endpoint actual_data فیلڈ میں false واپس کرے تو date_from گزشتہ سے پچھلے مہینے اور اس سے پہلے تک مقرر کیا جا سکتا ہے؛
      اگر Status endpoint actual_data فیلڈ میں true واپس کرے تو date_from گزشتہ مہینے اور اس سے پہلے تک مقرر کیا جا سکتا ہے

    • date_interval
      قسم: string | null

      پیش گوئی کی تاریخ کا وقفہ
      اختیاری فیلڈ
      اگر آپ date_interval متعین کریں تو date_from اور date_to متعین کرنے کی ضرورت نہیں
      ممکنہ اقدار: next_week, next_month, next_quarter
      ڈیفالٹ قدر: next_month

    • date_to
      قسم: string

      پیش گوئی کی وقت کی حد کی آخری تاریخ
      اگر آپ date_from متعین کریں تو درکار فیلڈ
      اگر آپ date_from اور date_to متعین کریں تو date_interval متعین کرنے کی ضرورت نہیں
      کم از کم قدر date_from +1 دن ہے
      زیادہ سے زیادہ قدر اگلے سال کا موجودہ دن اور مہینہ ہے
      تاریخ کی شکل: "yyyy-mm-dd"
      مثال:
      "2022-10-30"

    • 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

    • match
      قسم: string

      کی ورڈز کا میچ ٹائپ
      درکار فیلڈ
      درج ذیل اقدار لے سکتا ہے: exact, broad, phrase

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا نوٹیفکیشن URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • postback_url
      قسم: string | null

      ٹاسک کے نتائج بھیجنے کے لیے URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو gzip فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
      مثال:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      نوٹ: postback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • sort_by
      قسم: string | null

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

    • tag
      قسم: string | null

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

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

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

    • status_code
      قسم: integer | null

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

    • status_message
      قسم: string | null

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

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

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

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

        • data
          قسم: object | null

          وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

          • propertyName
            قسم: object | null
        • id
          قسم: string | null

          ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

        • path
          قسم: array (string | null)[] | null

          URL پاتھ

        • result
          قسم: object | null

          نتائج کی صف
          اس صورت میں قدر null ہوگی

        • 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/ad_traffic_by_keywords/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

{
  "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
    }
  ]
}

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

Setting ‘Ad Traffic By Keywords’ Tasks