DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API خلاصہ
ایک کرال کی حالت اور اہم میٹرکس، id کے ذریعے۔ crawl_progress، crawl_status، crawl_gateway_address، crawl_stop_reason، domain_info اور page_metrics واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ کرال کے مکمل ہونے کا پتہ لگانے کا یہی طریقہ بھی ہے - یہاں کوئی دوسرا endpoint پڑھنے سے پہلے اسے پول کریں جب تک crawl_progress کی قدر finished نہ ہو، ورنہ آپ جزوی نتائج پڑھیں گے جو حقیقی لگتے ہیں۔ 💰 اپ اسٹریم مفت: مکمل شدہ کرال سے استفسار کرنے کی کوئی لاگت نہیں، لاگت صرف خود کرال کی ہے۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.012۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: array (object | null)[] | null
نتائج کی صف
- crawlقسم: string | null
_gateway _address - crawlقسم: string | null
_progress کرالنگ سیشن کی حیثیت
ممکنہ اقدار:in_progress,finished - crawlقسم: object | null · Response36Afe1097B20_CrawlStatusInfo
_status کرالنگ سیشن کی تفصیلات
- maxقسم: integer | null فارمیٹ: int64
_crawl _pages کرال کی جانے والی صفحات کی زیادہ سے زیادہ تعداد ٹاسک سیٹ کرتے وقت آپ کے متعین کردہ max_crawl_pages کی حد بتاتا ہے
- pagesقسم: integer | null فارمیٹ: int64
_crawled کرال شدہ صفحات کی تعداد
- pagesقسم: integer | null فارمیٹ: int64
_in _queue اس وقت کرالنگ قطار میں موجود صفحات کی تعداد
- crawlقسم: string | null
_stop _reason کرالنگ رکنے کی وجہ
کرالنگ کا عمل کیوں رکا، اس بارے میں معلومات؛
ممکنہ اقدار:limit_exceeded-max_crawl_pagesمیں متعین حد سے تجاوز کر دیا گیا؛empty_queue- قطار میں موجود تمام URLs کرال کر لیے گئے؛force_stopped- کرالنگ کا عمل On Page API Force Stop فنکشن کے ذریعے روک دیا گیا؛unexpected_exception-targetکو کرال کرتے وقت اندرونی خرابی پیش آئی، مزید معلومات کے لیے سپورٹ سے رابطہ کریں - domainقسم: object | null · Response36Afe1097B20_DomainInfo
_info ڈومین بھر کی معلومات
ہدف ڈومین اور کرالنگ کے عمل کے بارے میں on-page معلومات- canonicalizationقسم: integer | null
_status _code canonicalized صفحے کی جانب سے واپس کردہ اسٹیٹس کوڈ
سرور کے رویے کی جانچ جب ہمارا کرالر IP کے ذریعے ویب سائٹ تک رسائی کی کوشش کرتا ہے؛
زیادہ تر معاملات میں سفارش کی جاتی ہے کہ canonicalized صفحات301یا302اسٹیٹس کوڈ کے ساتھ جواب دیں - checksقسم: object | null
ویب سائٹ کی جانچ
ویب سائٹ سے متعلق دیگر on-page جانچ- propertyقسم: boolean | null
Name
- cmsقسم: string | null
مواد کا نظامِ انتظام
ویب سائٹ پر شناخت شدہ مواد کا نظامِ انتظامgeneratorمیٹا ٹیگ کا مواد
ڈیٹا پہلے بے ترتیب صفحے سے لیا جاتا ہے جو 200 رسپانس کوڈ واپس کرتا ہے
اگر ہمارا کرالر CMS کی شناخت نہ کر سکا تو قدرnulln ہوگی - crawlقسم: string | null
_end کرالنگ کے ختم ہونے کا وقت
تاریخ اور وقت جب کرالنگ مکمل ہوئی
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00
نوٹ: صرف اسی صورت میں معلوماتی جب"crawl_progress""finished"ہو
اگر"crawl_progress"in_progressہو تو قدرnullہوگی - crawlقسم: string | null
_start کرالنگ کے شروع ہونے کا وقت
تاریخ اور وقت جب ویب سائٹ کرالنگ کے لیے بھیجی گئی
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - directoryقسم: integer | null
_browsing _status _code ڈائریکٹری کی جانب سے واپس کردہ اسٹیٹس کوڈ
ہدف ویب سائٹ کے ڈائریکٹری صفحے کی جانب سے واپس کردہ اسٹیٹس کوڈ
زیادہ تر معاملات میں سفارش کی جاتی ہے کہ ڈائریکٹریز403یا401اسٹیٹس کوڈ کے ساتھ جواب دیں - extendedقسم: string | null
_crawl _status کرال کی حیثیت اور خرابیاں
وجہ بتاتا ہے کہ ویب سائٹ کیوں کرال نہیں کی گئی؛
درج ذیل اقدار اختیار کر سکتا ہے:no_errors- کرالنگ کی کوئی خرابی نہیں پائی گئی؛site_unreachable- ہمارا کرالر ویب سائٹ تک نہیں پہنچ سکا اور اس لیے اسٹیٹس کوڈ حاصل نہیں کر سکا؛invalid_page_status_code- پہلے کرال شدہ صفحے کا اسٹیٹس کوڈ >= 400؛forbidden_meta_tag- پہلے کرال شدہ صفحے میں <meta robots="noindex"> ٹیگ موجود ہے؛forbidden_robots- robots.txt صفحے کی کرالنگ منع کرتا ہے؛forbidden_http_header- صفحے کے HTTP ہیڈر میں "X-Robots-Tag: noindex" موجود ہے ؛too_many_redirects- پہلے کرال شدہ صفحے میں 10 سے زیادہ ری ڈائریکٹس ہیں؛unknown- وجہ نامعلوم ہے - ipقسم: string | null
ڈومین کا IP ایڈریس
- mainقسم: string | null
_domain بنیادی ڈومین نام
- nameقسم: string | null
ڈومین نام
- pageقسم: integer | null
_not _found _status _code غیر موجود صفحے کی جانب سے واپس کردہ اسٹیٹس کوڈ
زیادہ تر معاملات میں سفارش کی جاتی ہے کہ سرور 404 رسپانس کوڈ واپس کرے - serverقسم: string | null
ویب سائٹ سرور
ویب سائٹ پر پائے جانے والے سرور کا ورژنserverہیڈر کا مواد
یہ معلومات پہلے صفحے سے لی جاتی ہیں جس کا رسپانس کوڈ 200 ہے - sslقسم: object | null · Response36Afe1097B20_SslInfo
_info SSL سرٹیفکیٹ کی معلومات
ویب سائٹ پر پائے جانے والے Secure Sockets Layer پروٹوکول کے بارے میں معلومات- certificateقسم: string | null
_expiration _date SSL سرٹیفکیٹ کی میعاد ختم ہونے کی تاریخ
وہ تاریخ اور وقت جب SSL سرٹیفکیٹ کی میعاد ختم ہوتی ہے
UTC فارمیٹ میں: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - certificateقسم: string | null
_hash SSL سرٹیفکیٹ ہیش
SSL سرٹیفکیٹ کے ہیش فنکشن کا ورژن - certificateقسم: string | null
_issuer SSL سرٹیفکیٹ اتھارٹی
وہ ہستی جس نے شناخت شدہ SSL سرٹیفکیٹ جاری کیا - certificateقسم: string | null
_subject SSL سرٹیفکیٹ سبجیکٹ
عوامی کلید سے منسلک ہستی - certificateقسم: integer | null
_version - validقسم: boolean | null
_certificate SSL سرٹیفکیٹ کی معتبریت
ظاہر کرتا ہے کہ ویب سائٹ پر شناخت شدہ SSL سرٹیفکیٹ میعاد ختم شدہ، معطل، منسوخ یا غلط نہیں ہے
- totalقسم: integer | null فارمیٹ: int64
_pages کل کرال شدہ صفحات
کرال شدہ صفحات کی کل تعداد - totalقسم: integer | null فارمیٹ: int64
_uncrawlable _resources کل ناقابلِ کرال ریسورسز
ان ریسورسز کی کل تعداد جنہیں کرال نہیں کیا جا سکا؛
ریسورس کو ناقابلِ کرال سمجھا جاتا ہے جب ریسورس کا اصل مواد کی قسم کرالر کی متوقع مواد کی قسم سے مطابقت نہ رکھے - wwwقسم: integer | null
_redirect _status _code ری ڈائریکٹ اسٹیٹس کوڈ
www سے غیر www ری ڈائریکٹ کا اسٹیٹس کوڈ
زیادہ تر معاملات میں سفارش کی جاتی ہے کہ ری ڈائریکٹ301اسٹیٹس کوڈ واپس کرے
- pageقسم: object | null · Response36Afe1097B20_PageMetrics
_metrics صفحے سے متعلق معلومات
ہدف ویب سائٹ کے صفحات پر میٹرکس کی معلومات- brokenقسم: integer | null
_links ٹوٹے ہوئے لنکس کی تعداد
ہدف ویب سائٹ کے تمام کرال شدہ صفحات میں ٹوٹے ہوئے لنکس کی تعداد - brokenقسم: integer | null
_resources ٹوٹے ہوئے ریسورسز کی تعداد
ٹوٹے ہوئے لنکس والی تصاویر اور دیگر ریسورسز کی تعداد - checksقسم: object | null
صفحے کے مخصوص آن پیج چیک اپ
- propertyقسم: integer | null فارمیٹ: int64
Name Signed 64-bit integers (long type).
- duplicateقسم: integer | null
_content نقل شدہ مواد والے صفحات کی تعداد
- duplicateقسم: integer | null
_description نقل شدہ تفصیلات والے صفحات کی تعداد
- duplicateقسم: integer | null
_title نقل شدہ عنوانات والے صفحات کی تعداد
- linksقسم: integer | null
_external بیرونی لنکس کی تعداد
دوسری ویب سائٹس کی طرف اشارہ کرنے والے لنکس کی تعداد - linksقسم: integer | null
_internal اندرونی لنکس کی تعداد
ہدف ویب سائٹ کے اندر دیگر صفحات کی طرف اشارہ کرنے والے لنکس کی تعداد - linksقسم: integer | null
_relation _conflict ہدف ویب سائٹ پر موجود ان لنکس کی تعداد جن میں تضاد ہو سکتا ہے
مثال کے طور پر، اگر"links_relation_conflict": 2ہو تو ہدف ویب سائٹ کم از کم ایک اندرونی لنک کے ذریعے جس میںrel="nofollow"ایٹریبیوٹ ہو اور کم از کم ایک dofollow لنک کے ذریعے ایک ہی ماخذ کی طرف اشارہ کر رہی ہے - nonقسم: integer | null
_indexable - onpageقسم: number | null
_score دکھاتا ہے کہ ویب سائٹ 100 پوائنٹ کے پیمانے پر کتنی بہتر بنائی گئی ہے
یہ فیلڈ بتاتا ہے کہ اہم آن پیج مسائل اور پتہ چلنے والی وارننگز کو مدنظر رکھتے ہوئے ویب سائٹ کتنی بہتر بنائی گئی ہے؛100سب سے زیادہ ممکنہ اسکور ہے جس کا مطلب ہے کہ ویب سائٹ میں کوئی اہم آن پیج مسئلہ اور کوئی اہم وارننگ نہیں ہے؛
نوٹ کہ یہ قدر کرال شدہ صفحات کی تعداد پر منحصر ہے؛
اس میٹرک کے حساب کے بارے میں مزید جانیں اس ہیلپ سینٹر مضمون میں - redirectقسم: integer | null
_loop ان ری ڈائریکٹ چینز کی تعداد جو ایک ہی URL پر شروع اور ختم ہوتی ہیں
ان ری ڈائریکٹ چینز کی تعداد جن میں منزل کا URL اصل URL پر واپس ری ڈائریکٹ ہوتا ہے
- resultقسم: integer | null فارمیٹ: int64
_count result صف میں عناصر کی تعداد
- statusقسم: integer | null
_code ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- statusقسم: string | null
_message ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- timeقسم: string | null
عمل درآمد کا وقت، سیکنڈز
- قسم: integer | null فارمیٹ: int64tasks
_count tasks صف میں ٹاسکس کی تعداد
- قسم: integer | null فارمیٹ: int64tasks
_error خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد
- قسم: string | nulltime
کل عمل درآمد کا وقت، سیکنڈ
- قسم: string | nullversion
API کا موجودہ ورژن
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"crawl_gateway_address": null,
"crawl_stop_reason": null,
"domain_info": {
"name": null,
"cms": null,
"ip": null,
"server": null,
"crawl_start": null,
"crawl_end": null,
"extended_crawl_status": null,
"ssl_info": "[Max Depth Exceeded]",
"checks": null,
"total_pages": null,
"total_uncrawlable_resources": null,
"page_not_found_status_code": null,
"canonicalization_status_code": null,
"directory_browsing_status_code": null,
"www_redirect_status_code": null,
"main_domain": null
},
"page_metrics": {
"links_external": null,
"links_internal": null,
"duplicate_title": null,
"duplicate_description": null,
"duplicate_content": null,
"broken_links": null,
"broken_resources": null,
"links_relation_conflict": null,
"redirect_loop": null,
"onpage_score": null,
"non_indexable": null,
"checks": null
}
}
]
}
]
}