DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API में रिसोर्स
crawl को मिली गैर-पेज एसेट्स — इमेज, स्क्रिप्ट, स्टाइलशीट — उनके स्टेटस कोड और आकार के साथ। पेजिंग search_after_token से होती है। यह पूर्ण हो चुके crawl से पढ़ता है, इसलिए इसे post_dataforseo_on_page_submit से मिला id चाहिए और यह crawl_progress के साथ crawl_status लौटाता है जिसमें max_crawl_pages, pages_in_queue और pages_crawled होते हैं — छोटे परिणाम पर भरोसा करने से पहले इन्हें जाँचें, क्योंकि चल रहे crawl के पास रिपोर्ट करने को कम होता है। जिन एसेट्स तक क्रॉलर पहुँच ही नहीं सका, उनके लिए post_dataforseo_on_page_uncrawlable_resources का उपयोग करें। 💰 अपस्ट्रीम मुफ़्त: पूर्ण हो चुके crawl को क्वेरी करने का कोई खर्च नहीं, खर्च केवल crawl का ही है।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 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के साथ कर सकते हैं
उदाहरण:["resource_type","=","stylesheet"][["resource_type","=","image"],
"and",["checks.is_https","=",false]][["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]खाली ऑब्जेक्ट - idटाइप: string
- limitटाइप: integer | null
लौटाए जाने वाले रिसोर्स की अधिकतम संख्या
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:100
अधिकतम मान:1000 - offsetटाइप: integer | null
लौटाए गए रिसोर्स के परिणाम ऐरे में ऑफ़सेट
वैकल्पिक फ़ील्ड
डिफ़ॉल्ट मान:0
अधिकतम मान:2000000
यदि आप10मान निर्दिष्ट करते हैं, तो परिणाम ऐरे में पहले दस रिसोर्स छोड़ दिए जाएँगे और डेटा आगामी रिसोर्स के लिए प्रदान किया जाएगा - orderटाइप: array string[] | null
_by परिणाम क्रमबद्ध करने के नियम
वैकल्पिक फ़ील्ड
परिणाम क्रमबद्ध करने के लिए आपfiltersऐरे में उपयोग किए गए समान मान उपयोग कर सकते हैं
संभावित क्रमबद्धता प्रकार:asc- परिणाम आरोही क्रम में क्रमबद्ध किए जाएँगेdesc- परिणाम अवरोही क्रम में क्रमबद्ध किए जाएँगे
क्रमबद्धता प्रकार सेट करने के लिए आपको comma का उपयोग करना चाहिए
उदाहरण:["size,desc"]
ध्यान दें कि आप एक request में अधिकतम तीन क्रमबद्धता नियम सेट कर सकते हैं
कई क्रमबद्धता नियमों को अलग करने के लिए आपको comma का उपयोग करना चाहिए
उदाहरण:["size,desc","fetch_timing.fetch_end,desc"] - relevantटाइप: array string[] | null
_pages _filters संबंधित पेजों के अनुसार रिसोर्स फ़िल्टर करें
वैकल्पिक फ़ील्ड
आप परिभाषित पैरामीटर से मेल खाने वाले पेजों से रिसोर्स प्राप्त करने के लिए यह फ़ील्ड उपयोग कर सकते हैं
यहाँ आप वही फ़िल्टर लागू कर सकते हैं जो pages endpoint के लिए उपलब्ध हैं
आप एक साथ कई फ़िल्टर जोड़ सकते हैं (अधिकतम 8 फ़िल्टर)
आपको शर्तों के बीच लॉजिकल ऑपरेटरand,orसेट करना चाहिए
निम्नलिखित ऑपरेटर समर्थित हैं:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like
आप शून्य या अधिक अक्षरों वाले किसी भी स्ट्रिंग से मिलान करने के लिए%ऑपरेटर का उपयोगlikeऔरnot_likeके साथ कर सकते हैं
उदाहरण:["checks.no_image_title","=",true] - searchटाइप: string | null
_after _token बाद के रिक्वेस्ट के लिए टोकन
वैकल्पिक फ़ील्ड
प्रत्येक रिक्वेस्ट के रिस्पॉन्स के समान फ़ील्ड में प्रदान किया जाता है;
एक ही रिक्वेस्ट में20,000से अधिक परिणाम प्राप्त करते समय टाइमआउट से बचने के लिए इस पैरामीटर का उपयोग करें;
रिस्पॉन्स सरणी से अद्वितीयsearch_after_tokenमान निर्दिष्ट करके आपको प्रारंभिक टास्क के बाद के परिणाम मिलेंगे;search_after_tokenमान प्रत्येक बाद के टास्क के लिए अद्वितीय होते हैं ;
नोट: यदि रिक्वेस्ट मेंsearch_after_tokenनिर्दिष्ट है, तो अन्य सभी पैरामीटर पिछली रिक्वेस्ट के समान होने चाहिए - tagटाइप: string | null
उपयोगकर्ता-परिभाषित टास्क आइडेंटिफ़ायर
वैकल्पिक फ़ील्ड
अक्षर सीमा 255 है
आप इस पैरामीटर से टास्क पहचान सकते हैं और उसे परिणाम से मिला सकते हैं
निर्दिष्टtagमान response केdataऑब्जेक्ट में मिलेगा - urlटाइप: string | null
पेज URL
वैकल्पिक फ़ील्ड
यदि आप किसी विशिष्ट पेज के लिए रिसोर्स प्राप्त करना चाहते हैं, तो यह फ़ील्ड निर्दिष्ट करें
ध्यान दें कि किसी विशिष्ट URL से रिसोर्स काmetaप्राप्त करने के लिए, आपको यह URL इस फ़ील्ड में निर्दिष्ट करना चाहिए;
यदि टास्क सेट करते समय आपurlनिर्दिष्ट नहीं करते, तो परिणामों में रिसोर्स काmetaउस पेज के डेटा के आधार पर लौटाया जाएगा जहाँ हमारे crawler ने रिसोर्स को पहली बार देखा था
- टाइप: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- टाइप: number | null फ़ॉर्मेट: doublecost
टास्क की कुल लागत, USD
- टाइप: integer | nullstatus
_code सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है
- टाइप: string | nullstatus
_message सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है
- टाइप: array (object | null)[] | nulltasks
टास्क का ऐरे
- टाइप: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- costटाइप: number | null फ़ॉर्मेट: double
टास्क की कुल लागत, USD
- dataटाइप: object | null
इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे
- 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
items ऐरे
- cacheटाइप: object | null · Response36Afe1097B20_CacheControl
_control कैशिंग के निर्देश
- cachableटाइप: boolean | null
दर्शाता है कि पेज कैश करने योग्य है या नहीं
- ttlटाइप: integer | null
time to live वह समय जितनी देर ब्राउज़र किसी संसाधन को कैश करता है
- checksटाइप: object | null
वेबसाइट जाँच, पेज से संबंधित ऑन-पेज जाँच-पड़ताल
- propertyटाइप: boolean | null
Name
- contentटाइप: string | null
_encoding एन्कोडिंग का प्रकार
- encodedटाइप: integer | null
_size एन्कोडिंग के बाद पेज का आकारएन्कोड किए गए पेज का आकार बाइट में दर्शाता है
- fetchटाइप: string | null
_time वह तारीख और समय जब कोई संसाधन प्राप्त किया गयाUTC प्रारूप में: “yyyy-mm-dd hh-mm-ss +00:00”उदाहरण:2019-11-15 12:57:46 +00:00
- lastटाइप: object | null · Response36Afe1097B20_LastModified
_modified संसाधन से जुड़े परिवर्तनों का डेटा शामिल हैयदि कोई डेटा न हो, तो मान null होगा
- headerटाइप: string | null
वह दिनांक और समय जब हेडर को अंतिम बार संशोधित किया गया था UTC प्रारूप में: "yyyy-mm-dd hh-mm-ss +00:00" उदाहरण: 2019-11-15 12:57:46 +00:00 यदि कोई डेटा नहीं है, तो मान null होगा
- metaटाइप: string | null
_tag वह दिनांक और समय जब मेटा टैग को अंतिम बार संशोधित किया गया था UTC प्रारूप में: "yyyy-mm-dd hh-mm-ss +00:00" उदाहरण: 2019-11-15 12:57:46 +00:00 यदि कोई डेटा नहीं है, तो मान null होगा
- sitemapटाइप: string | null
वह दिनांक और समय जब साइटमैप को अंतिम बार संशोधित किया गया था UTC प्रारूप में: "yyyy-mm-dd hh-mm-ss +00:00" उदाहरण: 2019-11-15 12:57:46 +00:00 यदि कोई डेटा नहीं है, तो मान null होगा
- locationटाइप: string | null
location हेडरकिसी पेज को रीडायरेक्ट करने के लिए URL दर्शाता है
- mediaटाइप: string | null
_type पेज प्रदर्शित करने के लिए उपयोग किए जाने वाले मीडिया के प्रकार
- resourceटाइप: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors संसाधन त्रुटियाँ और चेतावनियाँ
- errorsटाइप: array (object | null)[] | null
संसाधन त्रुटियाँ
- columnटाइप: integer | null
वह कॉलम जहाँ त्रुटि मिली
- lineटाइप: integer | null
वह पंक्ति जहाँ त्रुटि मिली
- messageटाइप: string | null
त्रुटि का टेक्स्ट संदेशसंभावित HTML त्रुटियों की पूरी सूची यहाँ मिल सकती है
- statusटाइप: integer | null
_code सामान्य स्टेटस कोडresponse कोड की पूरी सूची यहाँ देखी जा सकती हैनोट: हम दृढ़ता से अनुशंसा करते हैं कि संबंधित असामान्य या त्रुटि स्थितियों को संभालने के लिए आवश्यक सिस्टम डिज़ाइन करें
- warningsटाइप: array (object | null)[] | null
संसाधन चेतावनियाँ
- columnटाइप: integer | null
वह कॉलम जहाँ त्रुटि मिली
- lineटाइप: integer | null
वह पंक्ति जहाँ त्रुटि मिली
- messageटाइप: string | null
त्रुटि का टेक्स्ट संदेशसंभावित HTML त्रुटियों की पूरी सूची यहाँ मिल सकती है
- statusटाइप: integer | null
_code सामान्य स्टेटस कोडresponse कोड की पूरी सूची यहाँ देखी जा सकती हैनोट: हम दृढ़ता से अनुशंसा करते हैं कि संबंधित असामान्य या त्रुटि स्थितियों को संभालने के लिए आवश्यक सिस्टम डिज़ाइन करें
- resourceटाइप: string | null
_type एलिमेंट का प्रकार
- serverटाइप: string | null
सर्वर संस्करण
- sizeटाइप: integer | null
संसाधन का आकारकिसी दिए गए पेज का आकार बाइट में दर्शाता है
- statusटाइप: integer | null
_code सामान्य स्टेटस कोडresponse कोड की पूरी सूची यहाँ देखी जा सकती हैनोट: हम दृढ़ता से अनुशंसा करते हैं कि संबंधित असामान्य या त्रुटि स्थितियों को संभालने के लिए आवश्यक सिस्टम डिज़ाइन करें
- totalटाइप: integer | null फ़ॉर्मेट: int64
_transfer _size संपीड़ित पेज का आकारकिसी दिए गए पेज का संपीड़ित आकार दर्शाता है
- urlटाइप: string | null
पेज URL
- 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 response कोड की पूरी सूची यहाँ देखी जा सकती है
- 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
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"filters": [
[
"resource_type",
"=",
"image"
],
"and",
[
"size",
">",
100000
]
],
"order_by": [
"size,desc"
],
"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": [
{
"resource_type": null,
"status_code": null,
"location": null,
"url": null,
"resource_errors": "[Max Depth Exceeded]",
"size": null,
"encoded_size": null,
"total_transfer_size": null,
"fetch_time": null,
"cache_control": "[Max Depth Exceeded]",
"checks": null,
"content_encoding": null,
"media_type": null,
"server": null,
"last_modified": "[Max Depth Exceeded]"
}
]
}
]
}
]
}