DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
پیوندها
هر پیوندی که در طول خزش پیدا شده، بر اساس id. با page_from و page_to فیلتر کنید تا پیوندهای خارج‌شده از یک صفحه یا واردشده به آن را بگیرید. total_items_count، items_count، items و search_after_token برای صفحه‌بندی را برمی‌گرداند — از آن به‌جای offset پس از صفحه‌های اول استفاده کنید. خزش تکمیل‌شده را می‌خواند، بنابراین به id از post_dataforseo_on_page_submit نیاز دارد و crawl_progress را همراه با crawl_status شامل max_crawl_pages، pages_in_queue و pages_crawled برمی‌گرداند — پیش از اعتماد به نتیجه کوچک این‌ها را بررسی کنید، چون خزشی که هنوز در حال اجراست طبیعتاً کمتر گزارش می‌دهد. 💰 رایگان از سمت بالادست: پرس‌وجو درباره خزش تکمیل‌شده هزینه‌ای ندارد، فقط خود خزش.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.012 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید یک عملگر منطقیandیاorبین شرط‌ها تنظیم کنید
عملگرهای زیر پشتیبانی می‌شوند:regex،not_regex،=،<>،in،not_in،like،not_like
می‌توانید از عملگر%همراه باlikeوnot_likeبرای مطابقت با هر رشته‌ای از صفر یا چند کاراکتر استفاده کنید
مثال:["direction","=","external"][["domain_to","<>","example.com"],
"and",
["link_from","not_like","%example.com/blog%"]][["direction","=","external"],
"and",
[["link_from","like","%example.com/blog%"],"or",["link_from","like","%example.com/help%"]]]شیء خالی - idنوع: string
- limitنوع: integer | null
حداکثر تعداد پیوندهای برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - offsetنوع: integer | null
آفست در آرایه نتایج پیوندهای برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
حداکثر مقدار:2000000
اگر مقدار10را مشخص کنید، ده پیوند نخست در آرایه نتایج حذف می‌شود و داده‌ها برای پیوندهای بعدی ارائه می‌شود - pageنوع: string | null
_from نشانی URL نسبی صفحه
فیلد اختیاری
اگر از این فیلد استفاده کنید، پاسخ API فقط شامل پیوندهای صفحه مشخص‌شده خواهد بود
توجه کنید که در این فیلد فقط می‌توانید نشانی‌های URL نسبی مشخص کنید - pageنوع: string | null
_to نشانی URL نسبی صفحه
فیلد اختیاری
اگر از این فیلد استفاده کنید، پاسخ API فقط شامل پیوندهای داخلی به صفحه مشخص‌شده خواهد بود
توجه کنید که در این فیلد فقط می‌توانید نشانی‌های URL نسبی مشخص کنید - searchنوع: string | null
_after _token توکن برای درخواست‌های بعدی
فیلد اختیاری
در فیلد یکسان پاسخ هر درخواست ارائه می‌شود؛
از این پارامتر برای جلوگیری از وقفه زمانی هنگام تلاش برای دریافت بیش از20,000نتیجه در یک درخواست استفاده کنید؛
با مشخص کردن مقدار یکتایsearch_after_tokenاز آرایه پاسخ، نتایج بعدی وظیفه اولیه را دریافت می‌کنید؛
مقادیرsearch_after_tokenبرای هر وظیفه بعدی یکتا هستند؛
نکته: اگرsearch_after_tokenدر درخواست مشخص شود، همه پارامترهای دیگر باید با درخواست قبلی یکسان باشند - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_OnPageLinksTaskInfo
- 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
_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 تعداد صفحه‌هایی که در حال حاضر در صف خزش قرار دارند
- currentنوع: integer | null
_offset Integer numbers.
- itemsنوع: array (object | null)[] | null
آرایه آیتم‌ها
- directionنوع: string | null
جهت پیوند
مقادیر ممکن:internal،external - dofollowنوع: boolean | null
نشان می‌دهد آیا پیوند dofollow است
اگر مقدارtrueباشد، پیوند ویژگیrel="nofollow"ندارد - domainنوع: string | null
_from دامنه ارجاع‌دهنده
پیوند در این دامنه پیدا شد - domainنوع: string | null
_to دامنه ارجاع‌شده
پیوند به این دامنه اشاره می‌کند - isنوع: boolean | null
_broken پیوند شکسته است
نشان می‌دهد آیا یک پیوند به صفحه یا منبع شکسته اشاره می‌کند - isنوع: boolean | null
_link _relation _conflict نشان می‌دهد که پیوند ممکن است با پیوند دیگری تعارض داشته باشد
اگرtrueباشد، دست‌کم یک پیوند که بهlink_toاشاره می‌کند ویژگیrel="nofollow"دارد و دست‌کم یکی dofollow است - linkنوع: string | null
_from صفحه ارجاع‌دهنده
نشانی URL مطلق صفحه‌ای که پیوند در آن پیدا شد - linkنوع: string | null
_to صفحه ارجاع‌شده
نشانی URL مطلق صفحه‌ای که پیوند به آن اشاره می‌کند - pageنوع: string | null
_from صفحه ارجاع‌دهنده
نشانی URL نسبی صفحه‌ای که پیوند در آن پیدا شد - pageنوع: string | null
_from _scheme - pageنوع: string | null
_to صفحه ارجاع‌شده
نشانی URL نسبی صفحه‌ای که پیوند به آن اشاره می‌کند - pageنوع: string | null
_to _scheme - pageنوع: integer | null
_to _status _code کد وضعیت صفحه ارجاع‌شده
کد وضعیت صفحه‌ای که پیوند به آن اشاره می‌کند - typeنوع: string | null
نوع عنصر
- itemsنوع: integer | null قالب: int64
_count تعداد آیتم‌های آرایه نتایج
- searchنوع: string | null
_after _token - totalنوع: integer | null قالب: int64
_items _count شمار کل موارد مرتبط در پایگاه داده
- 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/links \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"page_from": "/apis/google-trends-api",
"filters": [
[
"dofollow",
"=",
true
],
"and",
[
"direction",
"=",
"external"
]
],
"limit": 10
}
]'
{
"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
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"domain_to": null,
"page_from": null,
"page_to": null,
"link_from": null,
"link_to": null,
"dofollow": null,
"page_from_scheme": null,
"page_to_scheme": null,
"direction": null,
"is_broken": null,
"is_link_relation_conflict": null,
"page_to_status_code": null
}
]
}
]
}
]
}