v0.2.0-beta

OpenAPI 3.1.0

Google News SERP ٹاسکس سیٹ کرنا

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/serp/google/news/task_post

Google News SERP ٹاسکس سیٹ کرنا

Google پر کسی کی ورڈ کے لیے خبروں کے نتائج کو قطار میں ڈالتا ہے اور tasks[0].id میں ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ لائیو ہم منصب فوراً جواب دیتا ہے اور ایک ہی کوئری کے لیے آسان ہے؛ جب بیچ ٹول کال سے زیادہ طویل ہو تو قطار میں ڈالیں۔

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- browser_screen_height
  قسم: integer | null
  
  براؤزر اسکرین کی اونچائی
  
  اختیاری فیلڈ
  
  آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین کی اونچائی سیٹ کر سکتے ہیں؛
  
  بطور ڈیفالٹ پیرامیٹر 1080 پر سیٹ ہوتا ہے؛
  
  نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں
- browser_screen_resolution_ratio
  قسم: integer | null
  
  براؤزر اسکرین ریزولوشن کا تناسب
  
  اختیاری فیلڈ
  
  آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین ریزولوشن کا تناسب سیٹ کر سکتے ہیں؛
  
  بطور ڈیفالٹ پیرامیٹر 1 پر سیٹ ہوتا ہے؛
  
  نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں
- browser_screen_width
  قسم: integer | null فارمیٹ: int64
  
  براؤزر اسکرین کی چوڑائی
  
  اختیاری فیلڈ
  
  آپ کسی مخصوص ڈیوائس کے لیے پکسل رینکنگ شمار کرنے کے لیے حسب ضرورت براؤزر اسکرین کی چوڑائی سیٹ کر سکتے ہیں؛
  
  بطور ڈیفالٹ پیرامیٹر 1920 پر سیٹ ہوتا ہے؛
  
  نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے calculate_rectangles کو true پر سیٹ کریں
- calculate_rectangles
  قسم: boolean | null
  
  ایڈوانسڈ نتائج میں SERP عناصر کے لیے پکسل رینکنگ شمار کریں
  
  اختیاری فیلڈ
  
  پکسل رینکنگ سے مراد نتیجے کے اسنیپٹ اور اسکرین کے اوپری بائیں کونے کے درمیان فاصلہ ہے؛
  
  مزید جاننے کے لیے Help Center ملاحظہ کریں>>
  
  بطور ڈیفالٹ، پیرامیٹر 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:’ پیرامیٹر والی کوئریز تعاون یافتہ نہیں ہیں اور توثیقی خرابی واپس کریں گی
  
  DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں
- language_code
  قسم: string
  
  سرچ انجن زبان کا کوڈ
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ language_name
  
  اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages سے حاصل کر سکتے ہیں
  
  مثال:
  
  en
- language_name
  قسم: string
  
  سرچ انجن زبان کا پورا نام
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ language_code
  
  اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages سے حاصل کر سکتے ہیں
  
  مثال:
  
  English
- location_code
  قسم: integer
  
  سرچ انجن مقام کا کوڈ
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ location_name یا location_coordinate
  
  اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations سے حاصل کر سکتے ہیں
  
  مثال:
  
  2840
- location_coordinate
  قسم: string
  
  مقام کے 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_name
  قسم: string
  
  سرچ انجن مقام کا پورا نام
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ 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_crawl_pages
  قسم: integer | null
  
  پیج کرال کی حد
  
  اختیاری فیلڈ
  
  کرال کیے جانے والے سرچ نتائج کے صفحات کی تعداد
  
  زیادہ سے زیادہ قدر: 100
  
  نوٹ: max_crawl_pages اور depth پیرامیٹرز ایک دوسرے کی تکمیل کرتے ہیں؛
  
  ہمارے help center پر مزید جانیں
- os
  قسم: string | null
  
  ڈیوائس آپریٹنگ سسٹم
  
  اختیاری فیلڈ
  
  نوٹ کریں کہ یہ API صرف ڈیسک ٹاپ کے لیے نتائج فراہم کرتی ہے
  
  درج ذیل اقدار میں سے انتخاب کریں: windows، macos
  
  ڈیفالٹ قدر: windows
- 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 میں خصوصی حروف urlencode ہوں گے؛
  
  یعنی # حرف %23 میں انکوڈ ہو جائے گا
  
  ہمارے Help Center پر مزید جانیں
- postback_data
  قسم: string
  
  postback_url ڈیٹا ٹائپ
  
  اگر آپ postback_url متعین کریں تو درکار فیلڈ
  
  اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا
  
  ممکنہ اقدار:
  
  advanced، html
- 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 میں خصوصی حروف urlencode ہوں گے؛
  
  یعنی # حرف %23 میں انکوڈ ہو جائے گا
  
  ہمارے Help Center پر مزید جانیں
- priority
  قسم: integer | null
  
  ٹاسک کی ترجیح
  
  اختیاری فیلڈ
  
  درج ذیل اقدار لے سکتا ہے:
  
  1 – معمول کی عمل درآمد کی ترجیح (ڈیفالٹ طور پر سیٹ)
  
  2 – اعلیٰ عمل درآمد کی ترجیح
  
  اعلیٰ عمل درآمد کی ترجیح والے ٹاسکس پر آپ سے اضافی چارج لیا جائے گا۔
  لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔
- se_domain
  قسم: string | null
  
  سرچ انجن ڈومین
  
  اختیاری فیلڈ
  
  ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
  
  تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
  
  مثال:
  
  google.co.uk, google.com.au, google.de, etc.
- search_param
  قسم: string | null
  
  سرچ کوئری کے اضافی پیرامیٹرز
  
  اختیاری فیلڈ
  
  دستیاب پیرامیٹرز کی فہرست اور مزید تفصیلات یہاں حاصل کریں
- tag
  قسم: string | null
  
  صارف کی متعین کردہ ٹاسک شناخت
  
  اختیاری فیلڈ
  
  حروف کی حد 255 ہے
  
  آپ اس پیرامیٹر کو ٹاسک کی شناخت اور اسے نتیجے سے ملانے کے لیے استعمال کر سکتے ہیں
  
  آپ کو متعین کردہ tag قدر جواب کے 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

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

post/v1/beta/dataforseo/serp/google/news/task_post

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

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

Google News SERP ٹاسکس سیٹ کرنا

توثیقRequired

DataForSEO

Google News SERP ٹاسکس سیٹ کرنا

قیمت کا حوالہ