v0.2.0-beta

OpenAPI 3.1.0

لائیو Google Autocomplete Advanced

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/autocomplete/live/advanced

لائیو Google Autocomplete Advanced

Google پر کوئری ٹائپ ہوتے ہی Google جو تجاویز پیش کرتا ہے، انہیں ہم وقت واپس کرتا ہے۔ keyword، type، se_domain، location_code، language_code، check_url، datetime، spell، refinement_chips، item_types، items_count اور items واپس کرتا ہے۔ advanced ڈیفالٹ انتخاب ہے؛ regular تب لیں جب صرف درجہ بند فہرست اہم ہو، اور html صرف یہ دیکھنے کے لیے کہ پارسر نے کیا چھوڑا۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- client
  قسم: string | null
  
  آٹو کمپلیٹ کے لیے سرچ کلائنٹ
  
  اختیاری فیلڈ
  
  آٹو کمپلیٹ نتائج سرچ کلائنٹ کے لحاظ سے مختلف ہو سکتے ہیں؛
  
  ممکنہ اقدار:
  
  chrome — جب google search google chrome میں کھولی جائے تو استعمال ہوتا ہے؛
  
  chrome-omni — chrome میں ایڈریس بار میں استعمال ہوتا ہے؛
  
  gws-wiz — google search ہوم پیج میں استعمال ہوتا ہے؛
  
  gws-wiz-serp — google search انجن نتائج کے صفحے میں استعمال ہوتا ہے؛
  
  safari — جب google search safari براؤزر میں کھولی جائے تو استعمال ہوتا ہے؛
  
  firefox — جب google search firefox براؤزر میں کھولی جائے تو استعمال ہوتا ہے؛
  
  psy-ab — جب google search google chrome براؤزر میں کھولی جائے تو استعمال ہو سکتا ہے؛
  
  toolbar — XML واپس کرتا ہے؛
  
  youtube — JSONP واپس کرتا ہے؛
  
  gws-wiz-local — google local میں استعمال ہوتا ہے؛
  
  img — google کی امیج تلاش میں استعمال ہوتا ہے؛
  
  products-cc — google shopping تلاش میں استعمال ہوتا ہے
- cursor_pointer
  قسم: integer | null
  
  سرچ بار کرسر پوائنٹر
  
  اختیاری فیلڈ
  
  سرچ بار میں کی ورڈ کے اندر کرسر پوائنٹر کی افقی عددی پوزیشن؛
  
  کرسر پوائنٹر کی پوزیشن تبدیل کر کے آپ ایک ہی بیج کی ورڈ کے لیے مختلف آٹو کمپلیٹ تجاویز حاصل کریں گے؛
  
  کم سے کم قدر: 0
  
  ڈیفالٹ قدر: متعین کردہ keyword کے آخری حرف کا نمبر
  
  مثال:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  قسم: string
  
  کی ورڈ
  
  درکار فیلڈ
  
  آپ keyword فیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
  
  تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف اسپیس حرف میں ڈی کوڈ ہو جائے گا)
  
  اگر آپ کو اپنے keyword کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛
  
  اگر آپ کو اپنے keyword کے لیے “+” حرف استعمال کرنا ہو تو اسے “%2B” کے طور پر متعین کریں؛
  
  DataForSEO APIs میں keyword اور keywords فیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں
- 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
- location_code
  قسم: integer
  
  سرچ انجن مقام کا کوڈ
  
  اگر آپ متعین نہ کریں تو درکار فیلڈ location_name؛
  
  آپ سرچ انجنز کے دستیاب مقامات کی فہرست ان کے location_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/google/locations سے حاصل کر سکتے ہیں
  
  مثال:
  
  2840
- location_name
  قسم: string
  
  سرچ انجن مقام کا پورا نام
  
  اگر آپ location_code متعین نہ کریں تو درکار فیلڈ
  
  اگر آپ یہ فیلڈ استعمال کریں تو location_code متعین کرنے کی ضرورت نہیں؛
  
  آپ سرچ انجن کے دستیاب مقامات کی فہرست ان کے location_name کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/serp/google/autocomplete/locations سے حاصل کر سکتے ہیں
  
  مثال:
  
  London,England,United Kingdom
- tag
  قسم: string | null
  
  صارف کی متعین کردہ ٹاسک شناخت
  
  اختیاری فیلڈ
  
  حروف کی حد 255 ہے
  
  آپ اس پیرامیٹر کو ٹاسک کی شناخت اور اسے نتیجے سے ملانے کے لیے استعمال کر سکتے ہیں
  
  آپ کو متعین کردہ tag قدر جواب کے data آبجیکٹ میں ملے گی

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

نتائج کی صف

check_url
قسم: string | null

سرچ انجن نتائج کا براہ راست URL
آپ اسے یقینی بنانے کے لیے استعمال کر سکتے ہیں کہ ہم نے درست نتائج فراہم کیے ہیں

datetime
قسم: string | null

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

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

SERP میں تلاش کے نتائج کی اقسام
SERP میں پائے جانے والے تلاش کے نتائج (items) کی اقسام شامل ہیں۔
ممکنہ آئٹم اقسام:
autocomplete

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

عنصر کے آئٹمز

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

آٹو کمپلیٹ میں نمایاں کی ورڈز
سرچ بار میں نمایاں کی گئی google آٹو کمپلیٹ تجاویز کی فہرست شامل ہے؛
نوٹ: صف صرف درج ذیل client کے لیے دستیاب ہے:
gws-wiz
psy-ab
gws-wiz-local

rank_absolute
قسم: integer | null

SERP میں مطلق درجہ
SERP کے تمام عناصر کے درمیان مطلق پوزیشن

rank_group
قسم: integer | null

SERP میں گروپ رینک
یکساں type اقدار والے عناصر کے گروپ کے اندر پوزیشن
مختلف type اقدار والے عناصر کی پوزیشنز rank_group سے خارج ہوتی ہیں

relevance
قسم: integer | null

تجویز کردہ کی ورڈ کی مطابقت
آٹو کمپلیٹ تجویز کی ہدف کی ورڈ سے مطابقت ظاہر کرتا ہے
قدریں 500 سے 2000 تک ہو سکتی ہیں
قدر جتنی زیادہ ہوگی، تجویز اتنی ہی زیادہ متعلقہ ہوگی
نوٹ: صرف درج ذیل client کے لیے دستیاب ہے:
chrome/chrome-omni

search_query_url
قسم: string | null

تلاش نتائج کا url
google آٹو کمپلیٹ تجویز سے متعلق تلاش نتائج کا url

suggestion
قسم: string | null

google آٹو کمپلیٹ کی ورڈ تجویز

suggestion_type
قسم: string | null

google آٹو کمپلیٹ تجویز کی قسم
نوٹ: صرف درج ذیل client کے لیے دستیاب ہے:
chrome/chrome-omni

thumbnail_url
قسم: string | null

تھمب نیل تصویر کا url
google آٹو کمپلیٹ تجویز کی تھمب نیل تصویر کا url
نوٹ: صرف درج ذیل client کے لیے دستیاب ہے:
gws-wiz
gws-wiz-serp

type
قسم: string | null

عنصر کی قسم

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

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

keyword
قسم: string | null

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

language_code
قسم: string | null

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

location_code
قسم: integer | null

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

refinement_chips
قسم: object | null · Response36Afe1097B20_RefinementChipsInfo

تلاش کی باریکی کے چپس

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

عنصر کے آئٹمز

domain
قسم: string | null

SERP میں ڈومین

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

مزید تلاش کی باریکی کے مزید اختیارات

domain
قسم: string | null

SERP میں ڈومین

title
قسم: string | null

عنصر کا عنوان

type
قسم: string | null

عنصر کی قسم

url
قسم: string | null

ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL

title
قسم: string | null

عنصر کا عنوان

type
قسم: string | null

عنصر کی قسم

url
قسم: string | null

ریفائنمنٹ پیرامیٹرز کے ساتھ تلاش کا URL

type
قسم: string | null

عنصر کی قسم

xpath
قسم: string | null

عنصر کا XPath

se_domain
قسم: string | null

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

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

SERP میں نتائج کی کل تعداد

spell
قسم: object | null · Response36Afe1097B20_SpellInfo

سرچ انجن کی خودکار تصحیح
اگر سرچ انجن نے کسی ایسے کی ورڈ کے لیے نتائج فراہم کیے جو درست کیا گیا تھا، تو ہم سرچ انجن کی درست کردہ کی ورڈ اور خودکار تصحیح کی قسم بتائیں گے؛
اس صورت میں null کے برابر ہوگا

keyword
قسم: string | null

سرچ انجن کی خودکار تصحیح کے نتیجے میں حاصل کردہ کی ورڈ نتائج درست کیے گئے کی ورڈ کے لیے فراہم کیے جائیں گے

type
قسم: string | null

خودکار تصحیح کی قسم ممکنہ اقدار: did_you_mean, showing_results_for, no_results_found_for, including_results_for نوٹ: Yahoo اور Yandex صرف درج ذیل خودکار تصحیح کی قسم معاون کرتے ہیں: including_results_for

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/autocomplete/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "client": "gws-wiz-serp"
  }
]'

اسکیما دکھائیں

{
  "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,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "relevance": null,
              "suggestion": null,
              "suggestion_type": null,
              "search_query_url": null,
              "thumbnail_url": null,
              "highlighted": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

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

لائیو Google Autocomplete Advanced

توثیقRequired

DataForSEO

لائیو Google Autocomplete Advanced

قیمت کا حوالہ