v0.2.0-beta

OpenAPI 3.1.0

لائیو Google Organic SERP HTML

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/organic/live/html

لائیو Google Organic SERP HTML

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

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- depth
  قسم: integer | null
  
  پارسنگ ڈیپتھ
  
  اختیاری فیلڈ
  
  SERP میں نتائج کی تعداد
  
  ڈیفالٹ قدر: 10
  
  زیادہ سے زیادہ قدر: 200
  
  آپ کے اکاؤنٹ سے ہر اس SERP کے لیے بل لیا جائے گا جس میں زیادہ سے زیادہ 10 نتائج ہوں؛
  10 سے زیادہ ڈیپتھ مقرر کرنے پر اضافی چارجز آ سکتے ہیں اگر سرچ انجن 10 سے زیادہ نتائج واپس کرے؛
  
  لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔
- device
  قسم: string | null
  
  ڈیوائس کی قسم
  
  اختیاری فیلڈ
  
  مخصوص ڈیوائس کی قسم کے لیے نتائج واپس کریں
  
  یہ اقدار لے سکتا ہے: desktop، mobile
  
  ڈیفالٹ قدر: desktop
- expand_ai_overview
  قسم: boolean | null
  
  AI جائزہ پھیلائیں
  
  اختیاری فیلڈ
  
  true پر سیٹ کریں تاکہ ai_overview آئٹم پھیلایا جا سکے؛
  
  ڈیفالٹ قدر: false
- find_targets_in
  قسم: array string[] | null
  
  ہدف کے لیے جانچنے والی SERP عناصر کی اقسام
  
  اختیاری فیلڈ
  
  یہ پیرامیٹر فعال کرنے کے لیے stop_crawl_on_match بھی فعال ہونا چاہیے
  
  متعین کرتا ہے کہ ہدف کے مطابقات کے لیے کون سی SERP عناصر کی اقسام جانچی جائیں
  
  اگر متعین نہ ہو تو url اور domain فیلڈز والے تمام فرسٹ لیول عناصر ہدف کے لیے جانچے جاتے ہیں
  
  ممکنہ اقدار: organic، paid، local_pack، featured_snippet، events، google_flights، images، jobs، knowledge_graph، local_service، map، scholarly_articles، third_party_reviews، twitter
  
  نوٹ: ignore_targets_in جیسی ہی عناصر کی اقسام شامل نہیں کر سکتا
  
  مثال:
  
  "find_targets_in": ["organic", "featured_snippet"]
  
  اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں
- ignore_targets_in
  قسم: array string[] | null
  
  ہدف کی تلاش سے خارج کرنے والی SERP عناصر کی اقسام
  
  اختیاری فیلڈ
  
  یہ پیرامیٹر فعال کرنے کے لیے stop_crawl_on_match بھی فعال ہونا چاہیے
  
  متعین کرتا ہے کہ ہدف کے مطابقات تلاش کرتے وقت کون سی SERP عناصر کی اقسام خارج کی جائیں
  
  ممکنہ اقدار: organic، paid، local_pack، featured_snippet، events، google_flights، images، jobs، knowledge_graph، local_service، map، scholarly_articles، third_party_reviews، twitter
  
  نوٹ: find_targets_in جیسی ہی عناصر کی اقسام شامل نہیں کر سکتا
  
  مثال:
  
  "ignore_targets_in": ["paid", "images"]
  
  اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں
- keyword
  قسم: string
  
  کی ورڈ
  
  درکار فیلڈ
  
  آپ keyword فیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
  
  تمام %## ڈی کوڈ ہوں گے (نیز '+' حرف اسپیس حرف میں ڈی کوڈ ہو جائے گا)
  
  اگر آپ کو اپنے keyword کے لیے "%" حرف استعمال کرنا ہو تو اسے "%25" کے طور پر متعین کریں؛
  
  اگر آپ کو اپنے keyword کے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں؛
  
  اگر اس فیلڈ میں 'allinanchor:'، 'allintext:'، 'allintitle:'، 'allinurl:'، ‘cache:’، 'define:'، 'filetype:'، 'id:'، 'inanchor:'، 'info:'، 'intext:'، 'intitle:'، 'inurl:'، 'link:'، 'related:'، 'site:' جیسے پیرامیٹرز شامل ہوں تو فی ٹاسک چارج 5 گنا بڑھ جائے گا
- language_code
  قسم: string
  
  سرچ انجن زبان کا کوڈ
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ language_name
  
  اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/google/languages سے حاصل کر سکتے ہیں
  
  مثال:
  
  en
- language_name
  قسم: string
  
  سرچ انجن زبان کا پورا نام
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ language_code
  
  اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجن کی دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/google/languages سے حاصل کر سکتے ہیں
  
  مثال:
  
  English
- load_async_ai_overview
  قسم: boolean | null
  
  غیر متزامن AI جائزہ لوڈ کریں
  
  اختیاری فیلڈ
  
  true پر سیٹ کریں تاکہ SERPs میں ai_overview آئٹمز حاصل ہوں چاہے وہ غیر متزامن طور پر لوڈ ہوں؛
  
  اگر false پر سیٹ کریں تو آپ صرف کیشے سے ai_overview آئٹمز حاصل کریں گے؛
  
  ڈیفالٹ قدر: false
  
  نوٹ آپ کے اکاؤنٹ سے ہر درخواست کے لیے اضافی $0.002 بل لیا جائے گا؛
  
  اگر عنصر موجود نہ ہو یا اس میں "asynchronous_ai_overview": false ہو تو تمام اضافی چارجز آپ کے اکاؤنٹ بیلنس میں واپس کر دیے جائیں گے
- location_code
  قسم: integer
  
  سرچ انجن مقام کا کوڈ
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ location_name یا location_coordinate
  
  اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
  
  آپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/google/locations سے حاصل کر سکتے ہیں
  
  مثال:
  
  2840
- location_coordinate
  قسم: string
  
  مقام کے GPS کوآرڈینیٹس
  
  اگر آپ location_name یا location_code متعین نہ کریں تو درکار فیلڈ
  
  اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_code متعین کرنے کی ضرورت نہیں
  
  location_coordinate پیرامیٹر "latitude,longitude,radius" فارمیٹ میں متعین کرنا چاہیے
  
  "latitude" اور "longitude" کے لیے اعشاریہ ہندسوں کی زیادہ سے زیادہ تعداد: 7
  
  "radius" کی کم از کم قدر: 199 (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/google/locations سے حاصل کر سکتے ہیں
  
  مثال:
  
  London,England,United Kingdom
- match_type
  قسم: string
  
  ہدف میچ کی قسم
  
  اگر stop_crawl_on_match متعین ہو تو درکار فیلڈ
  
  match_value کے لیے میچ کی قسم
  
  ممکنہ اقدار:
  
  domain – مخصوص ڈومین یا سب ڈومین
  
  with_subdomains – مرکزی ڈومین اور سب ڈومینز
  
  wildcard – وائلڈ کارڈ پیٹرن
- match_value
  قسم: string
  
  ہدف ڈومین، سب ڈومین یا وائلڈ کارڈ قدر
  
  اگر stop_crawl_on_match متعین ہو تو درکار فیلڈ
  
  ہدف ڈومین، سب ڈومین یا وائلڈ کارڈ قدر متعین کریں؛
  
  نوٹ: ڈومین یا سب ڈومین درخواست پروٹوکول کے بغیر متعین کرنا چاہیے؛
  
  مثال: "match_value": "dataforseo.com"،
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  قسم: integer | null
  
  پیج کرال کی حد
  
  اختیاری فیلڈ
  
  کرال کیے جانے والے سرچ نتائج کے صفحات کی تعداد
  
  زیادہ سے زیادہ قدر: 100
  
  نوٹ: آپ سے ہر کرال کیے گئے صفحے کے لیے چارج لیا جائے گا (فی صفحہ 10 organic نتائج)؛
  
  لاگت کے بارے میں ہمارے Pricing صفحے پر مزید جانیں؛
  
  نوٹ #2: max_crawl_pages اور depth پیرامیٹرز ایک دوسرے کی تکمیل کرتے ہیں؛
  
  ہمارے help center پر مزید جانیں
- os
  قسم: string | null
  
  ڈیوائس آپریٹنگ سسٹم
  
  اختیاری فیلڈ
  
  اگر آپ desktop کو device فیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں: windows، macos
  
  ڈیفالٹ قدر: windows
  
  اگر آپ mobile کو device فیلڈ میں متعین کریں تو درج ذیل اقدار میں سے انتخاب کریں: android، ios
  
  ڈیفالٹ قدر: android
- se_domain
  قسم: string | null
  
  سرچ انجن ڈومین
  
  اختیاری فیلڈ
  
  ہم آپ کے متعین کردہ مقام اور زبان کے مطابق متعلقہ سرچ انجن ڈومین خودکار طور پر منتخب کرتے ہیں
  
  تاہم آپ اس فیلڈ میں حسب ضرورت سرچ انجن ڈومین متعین کر سکتے ہیں
  
  مثال:
  
  google.co.uk, google.com.au, google.de, etc.
- search_param
  قسم: string | null
  
  سرچ کوئری کے اضافی پیرامیٹرز
  
  اختیاری فیلڈ
  
  دستیاب پیرامیٹرز کی فہرست اور مزید تفصیلات یہاں حاصل کریں
  
  نوٹ: درج ذیل سرچ انجن پیرامیٹرز تعاون یافتہ نہیں ہیں اور متعین کیے جانے پر خودکار طور پر غیر سیٹ ہو جائیں گے: lr، cr، as_qdr، as_sitesearch، as_occt، as_filetype۔
- stop_crawl_on_match
  قسم: array (object | null)[] | null
  
  کرالنگ روکنے کے لیے اہداف کی صف اختیاری فیلڈ اگر متعین کیا جائے تو جواب میں متعین کردہ match_value تک اور اس سمیت SERP نتائج شامل ہوں گے؛ آپ اس صف میں زیادہ سے زیادہ 10 ہدف اقدار متعین کر سکتے ہیں مثال: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api آپ کے اکاؤنٹ سے متعین کردہ اہداف کے ذریعے کرال کیے گئے ہر SERP پر بل لیا جائے گا
  
  match_type
  قسم: string | null
  
  ہدف میچ کی قسم اگر stop_crawl_on_match متعین کیا جائے تو درکار فیلڈ؛ match_value کے لیے میچ کی قسم ممکنہ اقدار: domain, with_subdomains, wildcard
  
  match_value
  قسم: string | null
  
  ہدف ڈومین یا وائلڈ کارڈ قدر اگر stop_crawl_on_match متعین کیا جائے تو درکار فیلڈ؛ ہدف ڈومین یا وائلڈ کارڈ قدر متعین کریں؛ نوٹ: ڈومین نام درخواست پروٹوکول کے بغیر متعین کرنا ہوگا؛ مثال: dataforseo.com
- tag
  قسم: string | null
  
  صارف کی متعین کردہ ٹاسک شناخت
  
  اختیاری فیلڈ
  
  حروف کی حد 255 ہے
  
  آپ اس پیرامیٹر کو ٹاسک کی شناخت اور اسے نتیجے سے ملانے کے لیے استعمال کر سکتے ہیں
  
  آپ کو متعین کردہ tag قدر جواب کے data آبجیکٹ میں ملے گی
- target_search_mode
  قسم: string | null
  
  ہدف میچنگ موڈ
  
  اختیاری فیلڈ
  
  اس پیرامیٹر کو فعال کرنے کے لیے stop_crawl_on_match بھی فعال ہونا چاہیے
  
  یہ متعین کرتا ہے کہ stop_crawl_on_match میں متعدد اہداف متعین ہونے پر کرال کیسے رکنا چاہیے
  
  ممکنہ اقدار: all، any
  
  all – کرال صرف اس وقت رکتا ہے جب تمام متعین اہداف مل جائیں
  
  any – کرال اس وقت رکتا ہے جب کوئی ایک ہدف مل جائے
  
  ڈیفالٹ قدر: any
  
  اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں
- url
  قسم: string | null
  
  سرچ کوئری کا براہ راست URL
  
  اختیاری فیلڈ
  
  آپ براہ راست URL متعین کر سکتے ہیں اور ہم اسے ضروری فیلڈز میں تقسیم کر دیں گے۔ نوٹ کریں کہ یہ طریقہ ہماری API کے لیے سب سے مشکل ہے اور اس کے لیے URL میں درست زبان اور مقام متعین کرنا بھی ضروری ہے۔ زیادہ تر صورتوں میں ہم یہ طریقہ استعمال کرنے کی سفارش نہیں کرتے۔
  
  مثال:
  
  https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
  
  نوٹ: درج ذیل سرچ انجن پیرامیٹرز تعاون یافتہ نہیں ہیں اور URL میں متعین کیے جانے پر خودکار طور پر غیر سیٹ ہو جائیں گے: lr، cr، as_qdr، as_sitesearch، as_occt، as_filetype۔

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

نتائج کی صف

datetime
قسم: string | null

وہ تاریخ اور وقت جب نتیجہ موصول ہوا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

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

SERP میں پائے جانے والے تلاش کے نتائج کے عناصر

date
قسم: string | null

وہ تاریخ اور وقت جب HTML صفحہ اسکین کیا گیا
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

html
قسم: string | null

HTML صفحہ

page
قسم: integer | null

واپس کیے گئے HTML صفحے کا سیریل نمبر

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

items صف میں واپس کیے گئے نتائج کی تعداد

keyword
قسم: string | null

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

language_code
قسم: string | null

POST صف میں زبان کا کوڈ

location_code
قسم: integer | null

POST صف میں مقام کا کوڈ

se_domain
قسم: string | null

POST صف میں سرچ انجن کا ڈومین

type
قسم: string | 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/organic/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html \
  --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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

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

لائیو Google Organic SERP HTML

توثیقRequired

DataForSEO

لائیو Google Organic SERP HTML

قیمت کا حوالہ