v0.2.0-beta

OpenAPI 3.1.0

متعلقہ صفحات

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/dataforseo_labs/google/relevant_pages/live

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- filters
  قسم: array (object | null)[] | null
  
  نتائج کی صف کے فلٹرنگ پیرامیٹرز
  اختیاری فیلڈ
  آپ ایک ساتھ کئی فلٹرز شامل کر سکتے ہیں (زیادہ سے زیادہ 8 فلٹرز)
  شرائط کے درمیان آپ کو منطقی آپریٹر and، or سیٹ کرنا چاہیے
  درج ذیل آپریٹرز معاون ہیں:
  regex، not_regex، <، <=، >، >=، =، <>، in، not_in
  
  مثال:
  ["metrics.paid.count",">",0]
  
  [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]
  
  [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
  فلٹرز کے بارے میں مزید معلومات کے لیے Dataforseo Labs - Filters یا یہ help center گائیڈ دیکھیں
  
  خالی آبجیکٹ
- historical_serp_mode
  قسم: string | null
  
  ڈیٹا جمع کرنے کا موڈ
  اختیاری فیلڈ
  آپ نتائج فلٹر کرنے کے لیے یہ فیلڈ استعمال کر سکتے ہیں؛
  ممکنہ فلٹرنگ اقسام:
  live — ان SERPs کے لیے میٹرکس واپس کریں جن میں مخصوص target کے فی الحال درجہ بندی کے نتائج موجود ہوں؛
  lost — ان SERPs کے لیے میٹرکس واپس کریں جن میں مخصوص target کے پہلے درجہ بندی کے نتائج موجود تھے، مگر آخری جانچ کے دوران موجود نہیں تھے؛
  all — دونوں قسم کے SERPs کے لیے میٹرکس واپس کریں۔
  ڈیفالٹ قدر: live
- ignore_synonyms
  قسم: boolean | null
  
  انتہائی مشابہ کی ورڈز نظر انداز کریں
  اختیاری فیلڈ
  اگر true پر سیٹ کریں تو صرف بنیادی کی ورڈز واپس کیے جائیں گے، تمام انتہائی مشابہ کی ورڈز خارج کر دیے جائیں گے؛
  ڈیفالٹ قدر: false
- include_clickstream_data
  قسم: boolean | null
  
  نتیجے میں کلک اسٹریم پر مبنی میٹرکس کا ڈیٹا شامل کریں یا خارج کریں
  اختیاری فیلڈ
  اگر پیرامیٹر true پر سیٹ ہو تو آپ کو جواب میں کلک اسٹریم ڈیٹا کے ساتھ clickstream_etv، clickstream_gender_distribution اور clickstream_age_distribution فیلڈز ملیں گی
  ڈیفالٹ قدر: false
  یہ پیرامیٹر فعال ہونے پر درخواست کی قیمت دوگنی وصول کی جائے گی
  
  کلک اسٹریم پر مبنی میٹرکس کا حساب کیسے لگایا جاتا ہے، اس help center مضمون میں مزید جانیں
- item_types
  قسم: array string[] | null
  
  آئٹم کی قسم کے مطابق نتائج دکھائیں
  اختیاری فیلڈ
  جواب میں شامل تلاش کے نتائج کی قسم بتاتا ہے
  
  نوٹ: اگر item_types صف میں organic سے مختلف آئٹم اقسام شامل ہوں تو نتائج صف میں پہلی آئٹم قسم کے مطابق ترتیب دیے جائیں گے؛ آپ ان تلاش کے نتائج کی اقسام کے مطابق نتائج کی ترتیب اور فلٹر نہیں کر سکیں گے جو جواب میں شامل نہیں ہیں؛
  
  ممکنہ اقدار:
  ["organic", "paid", "featured_snippet", "local_pack"]
  ڈیفالٹ قدر:
  ["organic", "paid"]
- language_code
  قسم: string | null
  
  زبان کا کوڈ
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں
  آپ دستیاب زبانوں کی فہرست ان کے language_code کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  تمام دستیاب زبانوں کے نتائج حاصل کرنے کے لیے اس فیلڈ کو نظر انداز کریں
  مثال:
  en
- language_name
  قسم: string | null
  
  زبان کا پورا نام
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
  آپ دستیاب زبانوں کی فہرست ان کے language_name کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  تمام دستیاب زبانوں کے نتائج حاصل کرنے کے لیے اس فیلڈ کو نظر انداز کریں
  مثال:
  English
- limit
  قسم: integer | null
  
  واپس کیے جانے والے صفحات کی زیادہ سے زیادہ تعداد
  اختیاری فیلڈ
  ڈیفالٹ قدر: 100
  زیادہ سے زیادہ قدر: 1000
- location_code
  قسم: integer | null
  
  مقام کا کوڈ
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ استعمال کریں تو location_name متعین کرنے کی ضرورت نہیں
  آپ دستیاب مقامات کی فہرست ان کے location_code کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  تمام دستیاب مقامات کے نتائج حاصل کرنے کے لیے اس فیلڈ کو نظر انداز کریں
  مثال:
  2840
- location_name
  قسم: string | null
  
  مقام کا پورا نام
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ استعمال کریں تو location_code متعین کرنے کی ضرورت نہیں
  آپ دستیاب مقامات کی فہرست ان کے location_name کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  تمام دستیاب مقامات کے نتائج حاصل کرنے کے لیے اس فیلڈ کو نظر انداز کریں
  مثال:
  United Kingdom
- offset
  قسم: integer | null
  
  واپس کیے گئے صفحات کی نتائج صف میں آفسیٹ
  اختیاری فیلڈ
  ڈیفالٹ قدر: 0
  اگر آپ قدر 10 متعین کریں تو نتائج کی صف میں پہلے دس صفحات چھوڑ دیے جائیں گے اور ڈیٹا اگلے صفحات کے لیے فراہم کیا جائے گا
- order_by
  قسم: array string[] | null
  
  نتائج کی ترتیب کے قواعد
  اختیاری فیلڈ
  آپ نتائج کی ترتیب کے لیے filters صف کی طرح وہی اقدار استعمال کر سکتے ہیں
  ممکنہ ترتیب کی اقسام:
  asc - نتائج صعودی ترتیب میں ترتیب دیے جائیں گے
  desc - نتائج نزولی ترتیب میں ترتیب دیے جائیں گے
  ترتیب کی قسم متعین کرنے کے لیے کوما استعمال کریں
  مثال:
  ["metrics.paid.etv,asc"]
  نوٹ: آپ ایک درخواست میں زیادہ سے زیادہ تین ترتیب کے قواعد مقرر کر سکتے ہیں
  کئی ترتیب کے قواعد کو الگ کرنے کے لیے کوما استعمال کریں
  مثال:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  ڈیفالٹ قاعدہ:
  ["metrics.organic.count,desc"]
  نوٹ: اگر item_types صف میں organic سے مختلف آئٹم اقسام شامل ہوں تو نتائج صف میں پہلی آئٹم قسم کے مطابق ترتیب دیے جائیں گے
- tag
  قسم: string | null
  
  صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
  اختیاری فیلڈ
  حروف کی حد 255 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- target
  قسم: string
  
  ڈومین
  درکار فیلڈ
  ہدف ویب سائٹ کا ڈومین نام
  ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

نتائج کی صف

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

متعلقہ صفحات اور متعلقہ ڈیٹا

metrics
قسم: object | null

متعلقہ صفحے کے رینکنگ اور ٹریفک میٹرکس

propertyName
قسم: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
قسم: object | null

عمر کے لحاظ سے کلک اسٹریم پر مبنی میٹرکس کی تقسیم
اس فیلڈ کے نتائج حاصل کرنے کے لیے پیرامیٹر include_clickstream_data کو true پر سیٹ کرنا ضروری ہے
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center مضمون میں مزید جانیں

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

Signed 64-bit integers (long type).

clickstream_etv
قسم: number | null فارمیٹ: double

کلک اسٹریم ڈیٹا پر مبنی تخمینی ٹریفک والیوم
اسے ڈومین جن کی ورڈز پر درجہ رکھتا ہے، ان سب کے کلک تھرو ریٹ اور کلک اسٹریم سرچ والیوم اقدار کی حاصل ضرب کے طور پر شمار کیا جاتا ہے
اس فیلڈ کے نتائج حاصل کرنے کے لیے پیرامیٹر include_clickstream_data کو true پر سیٹ کرنا ضروری ہے
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center مضمون میں مزید جانیں

clickstream_gender_distribution
قسم: object | null

جنس کے لحاظ سے تخمینی کلک اسٹریم پر مبنی میٹرکس کی تقسیم
اس فیلڈ کے نتائج حاصل کرنے کے لیے پیرامیٹر include_clickstream_data کو true پر سیٹ کرنا ضروری ہے
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center مضمون میں مزید جانیں

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

Signed 64-bit integers (long type).

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

ان نامیاتی SERPs کی کل تعداد جن میں ڈومین یا ذیلی ڈومین موجود ہے

estimated_paid_traffic_cost
قسم: number | null

نامیاتی سرچ ٹریفک کو ادا شدہ میں بدلنے کی تخمینی لاگت
اس زمرے کے ان تمام کی ورڈز کے لیے اشتہارات چلانے کی تخمینی ماہانہ لاگت (USD) کو ظاہر کرتا ہے جن پر ڈومین یا ذیلی ڈومین درجہ رکھتا ہے
یہ میٹرک نامیاتی etv اور ادا شدہ cpc اقدار کی حاصل ضرب کے طور پر شمار ہوتا ہے اور Google Search میں PPC اشتہارات کے ذریعے تخمینی ماہانہ نامیاتی ٹریفک والیوم لانے کی لاگت بتاتا ہے
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center مضمون میں مزید جانیں

etv
قسم: number | null

تخمینی ٹریفک والیوم
ڈومین یا ذیلی ڈومین کی طرف تخمینی نامیاتی ماہانہ ٹریفک
اسے CTR (کلک تھرو ریٹ) اور اس زمرے کے ان تمام کی ورڈز کے سرچ والیوم اقدار کی حاصل ضرب کے طور پر شمار کیا جاتا ہے جن پر ڈومین یا ذیلی ڈومین درجہ رکھتا ہے
یہ میٹرک کیسے شمار ہوتا ہے، اس Help Center مضمون میں مزید جانیں

is_down
قسم: integer | null

رینک نیچے گیا
بتاتا ہے کہ اشارہ کردہ ہدف کے کتنے درجہ بند عناصر نیچے گئے

is_lost
قسم: integer | null

گم شدہ درجہ بند عناصر
بتاتا ہے کہ اشارہ کردہ ہدف کے کتنے درجہ بند عناصر پہلے SERPs میں موجود تھے مگر آخری جانچ کے دوران نہیں ملے

is_new
قسم: integer | null

نئے درجہ بند عناصر کی تعداد
بتاتا ہے کہ اشارہ کردہ ہدف کے لیے کتنے نئے درجہ بند عناصر ملے

is_up
قسم: integer | null

رینک اوپر گیا
بتاتا ہے کہ اشارہ کردہ ہدف کے کتنے درجہ بند عناصر اوپر گئے

pos_1
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #1 رینک رکھتا ہے

pos_11_20
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #11-20 رینک رکھتا ہے

pos_2_3
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #2-3 رینک رکھتا ہے

pos_21_30
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #21-30 رینک رکھتا ہے

pos_31_40
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #31-40 رینک رکھتا ہے

pos_4_10
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #4-10 رینک رکھتا ہے

pos_41_50
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #41-50 رینک رکھتا ہے

pos_51_60
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #51-60 رینک رکھتا ہے

pos_61_70
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #61-70 رینک رکھتا ہے

pos_71_80
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #71-80 رینک رکھتا ہے

pos_81_90
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #81-90 رینک رکھتا ہے

pos_91_100
قسم: integer | null

ان نامیاتی SERPs کی تعداد جن میں ڈومین یا ذیلی ڈومین #91-100 رینک رکھتا ہے

page_address
قسم: string | null

متعلقہ صفحے کا مطلق URL

se_type
قسم: string | null

سرچ انجن کی قسم

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

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

language_code
قسم: string | null

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

location_code
قسم: integer | null

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

se_type
قسم: string | null

سرچ انجن کی قسم

target
قسم: string | null

POST صف میں ہدف ڈومین

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

آپ کی درخواست سے متعلقہ ہمارے ڈیٹابیس میں نتائج کی کل تعداد

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/dataforseo_labs/google/relevant_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ],
    "limit": 3
  }
]'

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

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

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

متعلقہ صفحات

توثیقRequired

DataForSEO

متعلقہ صفحات

قیمت کا حوالہ