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/historical_rank_overview/live

تاریخی رینک کا جائزہ

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

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- correlate
  قسم: boolean | null
  
  ڈیٹا کو پہلے حاصل کردہ ڈیٹاسیٹس سے منسلک کریں
  اختیاری فیلڈ
  ڈیفالٹ قدر: true
  اگر آپ یہ پیرامیٹر استعمال کریں تو ہمارا سسٹم آپ کے اب حاصل کردہ ڈیٹا کو پہلے حاصل کردہ ڈیٹاسیٹس سے منسلک کرے گا
  یہ پیرامیٹر ہمارے ڈیٹابیس میں تبدیلیوں سے پیدا ہونے والی کسی بھی عدم مطابقت کو کم کرنے کے لیے ہے
  ہم تجویز دیتے ہیں کہ correlate کو ہمیشہ true پر سیٹ کریں
- date_from
  قسم: string | null
  
  وقت کی رینج کی شروعاتی تاریخ
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیٹا پچھلے 6 ماہ کے لیے فراہم کیا جائے گا
  کم از کم ممکنہ قدر: 2020-10-01
  تاریخ کا فارمیٹ: "yyyy-mm-dd"
- date_to
  قسم: string | null
  
  وقت کی رینج کی آخری تاریخ
  اختیاری فیلڈ
  اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر آج کی تاریخ استعمال ہوگی
  تاریخ کا فارمیٹ: "yyyy-mm-dd"
  مثال:
  "2021-04-01"
- ignore_synonyms
  قسم: boolean | null
  
  انتہائی مشابہ کی ورڈز نظر انداز کریں
  اختیاری فیلڈ
  اگر true پر سیٹ کریں تو صرف بنیادی کی ورڈز پر مبنی ڈیٹا واپس کیا جائے گا، تمام انتہائی مشابہ کی ورڈز کا ڈیٹا خارج کر دیا جائے گا؛
  ڈیفالٹ قدر: false
- include_clickstream_data
  قسم: boolean | null
  
  نتیجے میں کلک اسٹریم پر مبنی میٹرکس کا ڈیٹا شامل کریں یا خارج کریں
  اختیاری فیلڈ
  اگر پیرامیٹر true پر سیٹ ہو تو آپ کو جواب میں کلک اسٹریم ڈیٹا کے ساتھ clickstream_etv، clickstream_gender_distribution اور clickstream_age_distribution فیلڈز ملیں گی؛
  ڈیفالٹ قدر: false؛
  
  نوٹ: تاریخی کلک اسٹریم ڈیٹا 2024/05 (مئی 2024) سے دستیاب ہے؛
  یہ پیرامیٹر فعال ہونے پر درخواست کی قیمت دوگنی وصول کی جائے گی؛
  کلک اسٹریم پر مبنی میٹرکس کا حساب کیسے لگایا جاتا ہے، اس help center مضمون میں مزید جانیں
- language_code
  قسم: string | null
  
  زبان کا کوڈ
  اگر آپ language_name متعین نہ کریں تو درکار فیلڈ
  نوٹ: language_name یا language_code میں سے ایک متعین کرنا لازمی ہے
  آپ دستیاب مقامات کی فہرست ان کے language_code کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  مثال:
  en
- language_name
  قسم: string
  
  زبان کا پورا نام
  اگر آپ language_code متعین نہ کریں تو درکار فیلڈ
  نوٹ: language_name یا language_code میں سے ایک متعین کرنا لازمی ہے
  آپ دستیاب مقامات کی فہرست ان کے language_name کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  مثال:
  English
- location_code
  قسم: integer
  
  مقام کا کوڈ
  اگر آپ location_name متعین نہ کریں تو درکار فیلڈ
  نوٹ: location_name یا location_code میں سے ایک متعین کرنا لازمی ہے
  آپ دستیاب مقامات کی فہرست ان کے location_code کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  مثال:
  2840
- location_name
  قسم: string
  
  مقام کا پورا نام
  اگر آپ location_code متعین نہ کریں تو درکار فیلڈ
  نوٹ: location_name یا location_code میں سے ایک متعین کرنا لازمی ہے
  آپ دستیاب مقامات کی فہرست ان کے location_name کے ساتھ
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages پر الگ درخواست بھیج کر حاصل کر سکتے ہیں
  مثال:
  United Kingdom
- tag
  قسم: string | null
  
  صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
  اختیاری فیلڈ
  حروف کی حد 255 ہے
  آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
  آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- target
  قسم: string
  
  ڈومین
  درکار فیلڈ
  ہدف ویب سائٹ کا ڈومین نام
  ڈومین https:// اور www. کے بغیر متعین کرنا چاہیے

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

قسم: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
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 رینک رکھتا ہے

month
قسم: integer | null

وہ مہینہ جس کے لیے ڈیٹا فراہم کیا گیا ہے

se_type
قسم: string | null

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

year
قسم: integer | null

وہ سال جس کے لیے ڈیٹا فراہم کیا گیا ہے

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

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

language_code
قسم: string | null

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

location_code
قسم: integer | null

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

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/historical_rank_overview/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

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

{
  "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,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

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

تاریخی رینک کا جائزہ

توثیقRequired

DataForSEO

تاریخی رینک کا جائزہ

قیمت کا حوالہ