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 برمی‌گرداند. این همچنین راه فهمیدن پایان خزش است — پیش از خواندن هر نقطه پایانی دیگر اینجا آن را مکرراً بررسی کنید تا crawl_progress برابر finished شود، وگرنه نتایج جزئی می‌خوانید که واقعی به نظر می‌رسند. 💰 رایگان از سمت بالادست: پرس‌وجو درباره خزش تکمیل‌شده هزینه‌ای ندارد، فقط خود خزش.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.012 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- 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- همه URLهای صف خزش شده‌اند؛force_stopped- فرایند خزش با تابع On Page API Force Stop متوقف شده است؛unexpected_exception- هنگام خزشtargetخطای داخلی رخ داده است، برای اطلاعات بیشتر با پشتیبانی تماس بگیرید - domainنوع: object | null · Response36Afe1097B20_DomainInfo
_info اطلاعات در سطح دامنه
اطلاعات درون‌صفحه‌ای درباره دامنه هدف و فرایند خزش- canonicalizationنوع: integer | null
_status _code کد وضعیت برگردانده‌شده توسط صفحه کانونیکال‌شده
بررسی رفتار سرور هنگام تلاش خزنده ما برای دسترسی به وب‌سایت از طریق IP
در بیشتر موارد توصیه می‌شود صفحه‌های کانونیکال‌شده کد وضعیت301یا302برگردانند - checksنوع: object | null
بررسی‌های وب‌سایت
سایر بررسی‌های درون‌صفحه‌ای مرتبط با وب‌سایت- propertyنوع: boolean | null
Name
- cmsنوع: string | null
سیستم مدیریت محتوا
سیستم مدیریت محتوای شناسایی‌شده در وب‌سایت
محتوای تگ متایgenerator
داده‌ها از نخستین صفحه تصادفی که کد پاسخ 200 برمی‌گرداند گرفته می‌شوند
اگر خزنده ما نتواند سیستم مدیریت محتوا را شناسایی کند، مقدارnullخواهد بود - 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- کد وضعیت نخستین صفحه خزش‌شده >= 400forbidden_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 به non-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
یک کلید API معتبر Felo لازم است.
- 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
}
}
]
}
]
}