v0.2.0-beta

OpenAPI 3.1.0

OnPage ٹاسکس سیٹ کرنا

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/on_page/task_post

OnPage ٹاسکس سیٹ کرنا

target کا کرال شروع کرتا ہے اور tasks[0].id میں ٹاسک id واپس کرتا ہے - یہی id وہ ہینڈل ہے جس کی اس خاندان کے ہر دوسرے ٹول کو ضرورت ہے، اسے سنبھال کر رکھیں۔ max_crawl_pages کرال کی حد مقرر کرتا ہے، start_url، max_crawl_depth، priority_urls اور crawl_delay اسے شکل دیتے ہیں، اور store_raw_html طے کرتا ہے کہ post_dataforseo_on_page_raw_html کے پاس بعد میں دینے کو کچھ ہوگا یا نہیں۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ ⚠️ یہ معمول کا submit/fetch جوڑا نہیں: کرال ایک سیشن ہے جس سے درجن بھر دوسرے ٹولز بعد میں id کے ذریعے استفسار کرتے ہیں۔ get_dataforseo_on_page_summary کو پول کریں جب تک crawl_progress finished نہ پڑھے؛ example.com کا ایک صفحے کا کرال ایک منٹ سے کافی کم میں مکمل ہوا۔

قیمت کا حوالہ

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

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

باڈی

application/json

قسم: array (object | null)[]
- accept_language
 قسم: string | null
 
 ویب سائٹ تک رسائی کے لیے زبان کا ہیڈر
 اختیاری فیلڈ
 تمام لوکیل فارمیٹس معاون ہیں (xx, xx-XX, xxx-XX, وغیرہ)
 نوٹ: اگر آپ یہ پیرامیٹر متعین نہ کریں تو کچھ ویب سائٹس رسائی سے انکار کر سکتی ہیں؛ ایسی صورت میں صفحات جوابی صف میں "type":"broken کے ساتھ واپس کیے جائیں گے
- allow_subdomains
 قسم: boolean | null
 
 سب ڈومینز کے صفحات شامل کریں
 اختیاری فیلڈ
 اگر آپ ہدف ویب سائٹ کے تمام سب ڈومینز کرال کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false
- allowed_subdomains
 قسم: array string[] | null
 
 کرال کیے جانے والے سب ڈومینز
 اختیاری فیلڈ
 وہ سب ڈومینز متعین کریں جنہیں آپ کرال کرنا چاہتے ہیں
 مثال: ["blog.site.com", "my.site.com", "shop.site.com"]
 نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے allow_subdomains پیرامیٹر کو false پر سیٹ کرنا چاہیے؛
 بصورت دیگر allowed_subdomains فیلڈ کا مواد نظر انداز کر دیا جائے گا اور نتائج تمام سب ڈومینز کے لیے واپس کیے جائیں گے
- browser_preset
 قسم: string | null
 
 براؤزر اسکرین پیرامیٹرز کے لیے پیش سیٹ
 اختیاری فیلڈ
 اگر آپ یہ فیلڈ استعمال کریں تو آپ کو browser_screen_width، browser_screen_height، browser_screen_scale_factor متعین کرنے کی ضرورت نہیں۔ ممکنہ اقدار:
 desktop، mobile، tablet۔ desktop پیش سیٹ درج ذیل اقدار لاگو کرے گا: browser_screen_width: 1920
 browser_screen_height: 1080
 browser_screen_scale_factor: 1۔ mobile پیش سیٹ درج ذیل اقدار لاگو کرے گا: browser_screen_width: 390
 browser_screen_height: 844
 browser_screen_scale_factor: 3۔ tablet پیش سیٹ درج ذیل اقدار لاگو کرے گا: browser_screen_width: 1024
 browser_screen_height: 1366
 browser_screen_scale_factor: 2
 نوٹ: اس پیرامیٹر کو استعمال کرنے کے لیے enable_javascript یا enable_browser_rendering کو true پر سیٹ کریں
- browser_screen_height
 قسم: integer | null
 
 براؤزر اسکرین کی اونچائی
 اختیاری فیلڈ
 آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین کی اونچائی سیٹ کر سکتے ہیں؛
 اگر آپ یہ فیلڈ استعمال کریں تو آپ کو browser_preset بتانے کی ضرورت نہیں کیونکہ اسے نظر انداز کر دیا جائے گا؛
 نوٹ: اس پیرامیٹر کو استعمال کرنے کے لیے enable_javascript یا enable_browser_rendering کو true پر سیٹ کریں۔ کم از کم قدر، پکسلز میں: 240
 زیادہ سے زیادہ قدر، پکسلز میں: 9999
- browser_screen_scale_factor
 قسم: number | null
 
 براؤزر اسکرین اسکیل فیکٹر
 اختیاری فیلڈ
 آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین ریزولوشن کا تناسب سیٹ کر سکتے ہیں؛
 اگر آپ یہ فیلڈ استعمال کریں تو آپ کو browser_preset بتانے کی ضرورت نہیں کیونکہ اسے نظر انداز کر دیا جائے گا؛
 نوٹ: اس پیرامیٹر کو استعمال کرنے کے لیے enable_javascript یا enable_browser_rendering کو true پر سیٹ کریں۔ کم از کم قدر: 0.5
 زیادہ سے زیادہ قدر: 3
- browser_screen_width
 قسم: integer | null فارمیٹ: int64
 
 براؤزر اسکرین کی چوڑائی
 اختیاری فیلڈ
 آپ کسی مخصوص ڈیوائس کے لیے آڈٹ کرنے کے لیے حسب ضرورت براؤزر اسکرین کی چوڑائی سیٹ کر سکتے ہیں؛
 اگر آپ یہ فیلڈ استعمال کریں تو آپ کو browser_preset بتانے کی ضرورت نہیں کیونکہ اسے نظر انداز کر دیا جائے گا؛
 نوٹ: اس پیرامیٹر کو استعمال کرنے کے لیے enable_javascript یا enable_browser_rendering کو true پر سیٹ کریں۔ کم از کم قدر، پکسلز میں: 240
 زیادہ سے زیادہ قدر، پکسلز میں: 9999
- calculate_keyword_density
 قسم: boolean | null
 
 ہدف ڈومین کے لیے کی ورڈ ڈینسٹی شمار کریں
 اختیاری فیلڈ
 اگر آپ ویب سائٹ کے صفحات کے لیے کی ورڈ ڈینسٹی شمار کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کریں تو اضافی چارجز لاگو ہوں گے؛ اس پیرامیٹر والے ٹاسکس کی لاگت کے بارے میں ہمارے help مضمون میں مزید جانیں
 کرال مکمل ہونے کے بعد آپ Keyword Density endpoint کے ذریعے کی ورڈ ڈینسٹی کی قدریں حاصل کر سکتے ہیں
- check_spell
 قسم: boolean | null
 
 ہجے جانچیں
 اختیاری فیلڈ
 ویب سائٹ پر Hunspell لائبریری استعمال کر کے ہجے جانچنے کے لیے true پر سیٹ کریں
 ڈیفالٹ قدر: false
- check_spell_exceptions
 قسم: array string[] | null
 
 سپیل چیک سے مستثنیٰ الفاظ
 اختیاری فیلڈ
 وہ الفاظ متعین کریں جنہیں آپ سپیل چیک سے مستثنیٰ کرنا چاہتے ہیں
 زیادہ سے زیادہ لفظ کی لمبائی: 100 حروف
 زیادہ سے زیادہ الفاظ کی تعداد: 1000
 مثال: "SERP", "minifiers", "JavaScript"
- check_spell_language
 قسم: string | null
 
 سپیل چیک کی زبان
 اختیاری فیلڈ
 معاون زبانیں: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
 نوٹ: اگر کوئی زبان متعین نہ کی جائے تو یہ صفحے کے مواد کی بنیاد پر خود بخود سیٹ ہو جائے گی
- checks_threshold
 قسم: object | null
 
 چیکس کے لیے حسب ضرورت حد کی قدریں
 اختیاری فیلڈ
 آپ OnPage API جوابات کے checks آبجیکٹ میں شامل پیرامیٹرز کے لیے حسب ضرورت حد کی قدریں متعین کر سکتے ہیں؛
 نوٹ: صرف عددی (integer) حد کی قدریں تبدیل کی جا سکتی ہیں؛
 مثلاً، high_loading_time اور large_page_size پیرامیٹرز بطور ڈیفالٹ بالترتیب 3 سیکنڈ اور 1 میگا بائٹ پر سیٹ ہیں؛
 اگر آپ ان حدود کو 1 سیکنڈ اور 1000 kbytes میں تبدیل کرنا چاہتے ہیں تو درج ذیل اسنیپٹ استعمال کریں:
 "checks_threshold": { "high_loading_time": 1, "large_page_size": 1000 }
 ڈیفالٹ قدروں کے ساتھ دستیاب قابل تخصیص پیرامیٹرز:
 "title_too_short", default value: 30, type: "int" "title_too_long", default value: 65, type: "int" "small_page_size", default value: 1024, type: "int" "large_page_size", default value: 1048576 (1024 * 1024), type: "int" "low_character_count", default value: 1024, type: "int" "high_character_count", default value: 256000 (250 * 1024), type: "int" "low_content_rate", default value: 0.1, type: "float" "high_content_rate", default value: 0.9, type: "float" "high_loading_time", default value: 3000, type: "int" "high_waiting_time", default value: 1500, type: "int" "low_readability_rate", default value: 15.0, type: "float" "irrelevant_description", default value: 0.2, type: "float" "irrelevant_title", default value: 0.3, type: "float" "irrelevant_meta_keywords", default value: 0.6, type: "float"
 
 propertyName
 قسم: integer | null فارمیٹ: int64
 
 Signed 64-bit integers (long type).
- crawl_delay
 قسم: integer | null
 
 ہٹس کے درمیان تاخیر، ملی سیکنڈز
 اختیاری فیلڈ
 سرور پر کرالر ہٹس کے درمیان حسب ضرورت تاخیر
 ڈیفالٹ قدر: 2000
- crawl_sitemap_only
 قسم: boolean | null
 
 صرف sitemap میں بتائے گئے صفحات کرال کریں
 اختیاری فیلڈ
 اگر آپ صرف sitemap میں بتائے گئے صفحات کرال کرنا چاہتے ہیں تو true پر سیٹ کریں
 اگر آپ یہ پیرامیٹر true پر سیٹ کریں اور custom_sitemap متعین نہ کریں تو ہم ڈیفالٹ sitemap کرال کریں گے
 ڈیفالٹ قدر: false
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کرنا چاہتے ہیں تو respect_sitemap کو true ہونا چاہیے
- custom_js
 قسم: string | null
 
 حسب ضرورت javascript
 اختیاری فیلڈ
 نوٹ کریں کہ یہاں درج اسکرپٹ کا عمل درآمد کا وقت زیادہ سے زیادہ 700 ms ہونا چاہیے، مثال کے طور پر آپ یہ JS اسنیپٹ استعمال کر سکتے ہیں تاکہ جانچا جا سکے کہ ویب سائٹ میں Google Tag Manager بطور scr ایٹریبیوٹ موجود ہے:
 let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;واپس کی گئی قدر اس پر منحصر ہے کہ آپ نے اس فیلڈ میں کیا متعین کیا۔ مثلاً، اگر آپ درج ذیل اسکرپٹ متعین کریں:
 meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
 تو جواب میں آپ کو درج ذیل ڈیٹا ملے گا:
 "custom_js_response": { "url": "https://dataforseo.com/", "test": "test" }
 نوٹ: آپ کے درج کردہ اسکرپٹ کی لمبائی 2000 حروف سے زیادہ نہیں ہونی چاہیے
- custom_robots_txt
 قسم: string | null
 
 حسب ضرورت robots.txt سیٹنگز
 اختیاری فیلڈ
 مثال: Disallow: /directory1/
- custom_sitemap
 قسم: string | null
 
 حسب ضرورت sitemap url
 اختیاری فیلڈ
 اس صفحے کا URL جہاں متبادل sitemap موجود ہے
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کرنا چاہتے ہیں تو respect_sitemap کو true ہونا چاہیے
- custom_user_agent
 قسم: string | null
 
 حسب ضرورت user agent
 اختیاری فیلڈ
 ویب سائٹ کرال کرنے کے لیے حسب ضرورت user agent
 مثال: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
 ڈیفالٹ قدر: Mozilla/5.0 (compatible; RSiteAuditor)
- disable_cookie_popup
 قسم: boolean | null
 
 کوکی پاپ اپ غیر فعال کریں
 اختیاری فیلڈ
 اگر آپ صارف سے کوکی رضامندی طلب کرنے والا پاپ اپ غیر فعال کرنا چاہتے ہیں تو true پر سیٹ کریں؛
 ڈیفالٹ قدر:
 false
- disable_page_checks
 قسم: array string[] | null
 
 صفحے کے مخصوص چیکس کو چلنے سے روکیں
 اختیاری فیلڈ
 مخصوص checks متعین کریں تاکہ وہ چل نہ سکیں اور onpage_score پر اثر نہ ڈالیں۔ مثال:
 "disable_page_checks": ["is_5xx_code", "is_4xx_code"]
- disable_sitewide_checks
 قسم: array string[] | null
 
 سائٹ بھر کے مخصوص چیکس کو چلنے سے روکیں
 اختیاری فیلڈ
 درج ذیل checks متعین کریں تاکہ وہ target ویب سائٹ پر چل نہ سکیں:
 "test_page_not_found"
 "test_canonicalization"
 "test_https_redirect"
 "test_directory_browsing"مثال:
 "disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]ہمارے help center پر مزید جانیں
- disallowed_subdomains
 قسم: array string[] | null
 
 سب ڈومینز جنہیں کرال نہیں کرنا
 اختیاری فیلڈ
 وہ سب ڈومینز متعین کریں جنہیں آپ کرال کرنا نہیں چاہتے
 مثال: ["status.site.com", "docs.site.com"]
 نوٹ: یہ پیرامیٹر استعمال کرنے کے لیے allow_subdomains پیرامیٹر کو true پر سیٹ کرنا چاہیے
- enable_browser_rendering
 قسم: boolean | null
 
 Core Web Vitals پیمانے کے لیے براؤزر رینڈرنگ کی نقل کریں
 اختیاری فیلڈ
 یہ پیرامیٹر استعمال کر کے آپ ویب صفحہ لوڈ کرتے وقت براؤزر کی نقل کر سکیں گے؛
 enable_browser_rendering صفحے پر اسٹائلز، تصاویر، فونٹس، اینیمیشنز، ویڈیوز اور دیگر ریسورسز لوڈ کرتا ہے؛
 ڈیفالٹ قدر: false
 جواب میں Core Web Vitals (FID, CLS, LCP) میٹرکس حاصل کرنے کے لیے true پر سیٹ کریں؛
 اگر آپ یہ فیلڈ استعمال کریں تو enable_javascript اور load_resources پیرامیٹرز true پر سیٹ ہونے چاہئیں
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کریں تو اضافی چارجز لاگو ہوں گے؛ اس پیرامیٹر والے ٹاسکس کی لاگت کے بارے میں ہمارے help مضمون میں مزید جانیں؛ لاگت Pricing Page پر شمار کی جا سکتی ہے
- enable_content_parsing
 قسم: boolean | null
 
 کرال شدہ صفحات کا مواد پارس کریں
 اختیاری فیلڈ
 OnPage Content Parsing endpoint استعمال کرنے کے لیے true پر سیٹ کریں
 ڈیفالٹ قدر: false
- enable_javascript
 قسم: boolean | null
 
 صفحے پر javascript لوڈ کریں
 اختیاری فیلڈ
 اگر آپ صفحے پر دستیاب اسکرپٹس لوڈ کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کریں تو اضافی چارجز لاگو ہوں گے؛ اس پیرامیٹر والے ٹاسکس کی لاگت کے بارے میں ہمارے help مضمون میں مزید جانیں؛ لاگت Pricing Page پر شمار کی جا سکتی ہے
- enable_www_redirect_check
 قسم: boolean | null
 
 جانچیں کہ ڈومین نے www ری ڈائریکشن نافذ کی ہے یا نہیں
 اختیاری فیلڈ
 اگر آپ جانچنا چاہتے ہیں کہ درخواست کردہ ڈومین نے www سے non-www یا non-www سے www ری ڈائریکشن نافذ کی ہے تو true پر سیٹ کریں؛
 ڈیفالٹ قدر: false
- enable_xhr
 قسم: boolean | null
 
 صفحے پر XMLHttpRequest فعال کریں
 اختیاری فیلڈ
 اگر آپ چاہتے ہیں کہ ہمارا کرالر XMLHttpRequest آبجیکٹ استعمال کر کے ویب سرور سے ڈیٹا طلب کرے تو true پر سیٹ کریں
 ڈیفالٹ قدر: false؛ اگر آپ یہ فیلڈ استعمال کریں تو enable_javascript true پر سیٹ ہونا چاہیے؛
- force_sitewide_checks
 قسم: boolean | null
 
 ایک صفحہ کرال کرتے وقت سائٹ بھر کے چیکس فعال کریں
 اختیاری فیلڈ
 ایک صفحہ کرال کرتے وقت سائٹ بھر کے چیکس کا ڈیٹا حاصل کرنے کے لیے true پر سیٹ کریں؛
 ڈیفالٹ قدر: false
- load_resources
 قسم: boolean | null
 
 ریسورسز لوڈ کریں
 اختیاری فیلڈ
 اگر آپ تصاویر، اسٹائل شیٹس، اسکرپٹس اور ٹوٹے ہوئے ریسورسز لوڈ کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false
 نوٹ: اگر آپ یہ پیرامیٹر استعمال کریں تو اضافی چارجز لاگو ہوں گے؛ اس پیرامیٹر والے ٹاسکس کی لاگت کے بارے میں ہمارے help مضمون میں مزید جانیں؛ لاگت Pricing Page پر شمار کی جا سکتی ہے
- max_crawl_depth
 قسم: integer | null
 
 کرال کی گہرائی
 اختیاری فیلڈ
 کرال کیے جانے والے صفحات کی لنکنگ گہرائی؛
 مثلاً، کرال کا شروعاتی صفحہ سطح 0 ہے، اس صفحے سے لنکس رکھنے والے صفحات سطح 1 ہیں، وغیرہ۔
- max_crawl_pages
 قسم: integer
 
 کرال شدہ صفحات کی حد
 درکار فیلڈ
 متعین کردہ ڈومین پر کرال کیے جانے والے صفحات کی تعداد
 نوٹ:
 اگر آپ max_crawl_pages کو 1 پر سیٹ کریں اور start_url متعین نہ کریں یا اس میں ہوم پیج سیٹ کریں تو درج ذیل سائٹ بھر کے چیکس غیر فعال ہو جائیں گے:
 test_canonicalization، enable_www_redirect_check، test_hidden_server_signature، test_page_not_found، test_directory_browsing، test_https_redirect
 بہرحال انہیں فعال کرنے کے لیے force_sitewide_checks کو true پر سیٹ کریں۔ اگر آپ max_crawl_pages کو 1 پر سیٹ کریں اور ہوم پیج کے علاوہ کوئی start_url متعین کریں تو تمام سائٹ بھر کے چیکس غیر فعال ہو جائیں گے؛
 بہرحال انہیں فعال کرنے کے لیے force_sitewide_checks کو true پر سیٹ کریں
- pingback_url
 قسم: string | null
 
 مکمل شدہ ٹاسک کا نوٹیفکیشن URL
 اختیاری فیلڈ
 ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے
 آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے۔
 مثال:
 http://your-server.com/pingscript?id=$id
 http://your-server.com/pingscript?id=$id&tag=$tag
 نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
 یعنی، # حرف %23 میں انکوڈ ہو جائے گا
 
 ہمارے Help Center پر مزید جانیں
- priority_urls
 قسم: array string[] | null
 
 قطار کو نظر انداز کر کے کرال کیے جانے والے urls
 اختیاری فیلڈ
 اس صف میں متعین URLs کرالنگ قطار کو نظر انداز کر کے سب سے پہلے کرال کیے جائیں گے؛
 نوٹ: آپ کو مطلق URL متعین کرنا چاہیے؛
 آپ زیادہ سے زیادہ 20 URLs متعین کر سکتے ہیں؛
 صف میں تمام URLs کا تعلق target ڈومین سے ہونا چاہیے؛
 سب ڈومینز نظر انداز کر دیے جائیں گے الا یہ کہ allow_subdomains پیرامیٹر true پر سیٹ ہو۔ مثال:
 "priority_urls": [ "https://dataforseo.com/apis/serp-api", "https://dataforseo.com/contact" ]
- respect_sitemap
 قسم: boolean | null
 
 کرال کرتے وقت sitemap کی پاسداری کریں
 اختیاری فیلڈ
 اگر آپ کرال کرتے وقت بنیادی sitemap میں بتائے گئے صفحات کی ترتیب کی پیروی کرنا چاہتے ہیں تو true پر سیٹ کریں؛
 ڈیفالٹ قدر: false
 نوٹ: اگر true پر سیٹ کیا جائے تو API جواب میں click_depth قدر 0 کے برابر ہوگی؛
 درخواست کا max_crawl_depth فیلڈ نظر انداز کر دیا جائے گا، آپ max_crawl_pages پیرامیٹر استعمال کر کے کرال کیے جانے والے صفحات کی تعداد متعین کر سکتے ہیں
- return_despite_timeout
 قسم: boolean | null
 
 ٹائم آؤٹ خرابی کے باوجود صفحات کا ڈیٹا واپس کریں
 اختیاری فیلڈ
 اگر true ہو تو ان صفحات کا ڈیٹا فراہم کیا جائے گا جو 120 سیکنڈ کے اندر لوڈ نہ ہو سکے اور ٹائم آؤٹ خرابی واپس کریں؛
 ڈیفالٹ قدر: false
- robots_txt_merge_mode
 قسم: string | null
 
 robots.txt سیٹنگز کے ساتھ ضم کریں یا انہیں اوور رائیڈ کریں
 اختیاری فیلڈ
 ممکنہ اقدار: merge، override؛
 اگر آپ ویب سائٹ کی کرالنگ پابندیاں اور دیگر robots.txt سیٹنگز نظر انداز کرنا چاہتے ہیں تو override پر سیٹ کریں
 ڈیفالٹ قدر: merge؛
 نوٹ: اگر override پر سیٹ کریں تو custom_robots_txt پیرامیٹر متعین کریں
- start_url
 قسم: string | null
 
 کرال کیے جانے والا پہلا url
 اختیاری فیلڈ
 نوٹ: آپ کو مطلق URL متعین کرنا چاہیے
 اگر آپ ایک ہی صفحہ کرال کرنا چاہتے ہیں تو اس کا URL اس فیلڈ میں متعین کریں اور اضافی طور پر max_crawl_pages پیرامیٹر کو 1 پر سیٹ کریں
 آپ صفحے سے متعلق ڈیٹا حاصل کرنے کے لیے live Instant Pages endpoint بھی استعمال کر سکتے ہیں
- store_raw_html
 قسم: boolean | null
 
 کرال شدہ صفحات کا HTML محفوظ کریں
 اختیاری فیلڈ
 اگر آپ OnPage Raw HTML endpoint استعمال کر کے صفحے کا HTML حاصل کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false
- support_cookies
 قسم: boolean | null
 
 کرال شدہ صفحات پر کوکیز کی معاونت کریں
 اختیاری فیلڈ
 صفحات کرال کرتے وقت کوکیز کی معاونت کے لیے true پر سیٹ کریں
 ڈیفالٹ قدر: false
- switch_pool
 قسم: boolean | null
 
 پراکسی پول تبدیل کریں
 اختیاری فیلڈ
 اگر true ہو تو مطلوبہ ڈیٹا حاصل کرنے کے لیے اضافی پراکسی پول استعمال کیے جائیں گے؛
 یہ پیرامیٹر اس صورت میں استعمال کیا جا سکتا ہے جب ایک ساتھ کئی ٹاسکس سیٹ کیے جائیں، جس کے نتیجے میں کبھی کبھار rate-limit اور/یا site_unreachable خرابیاں آ سکتی ہیں
- tag
 قسم: string | null
 
 صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
 اختیاری فیلڈ
 حروف کی حد 255 ہے
 آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
 آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے
- target
 قسم: string
 
 ہدف ڈومین
 درکار فیلڈ
 ڈومین نام https:// اور www. کے بغیر متعین کرنا چاہیے
 اگر آپ صفحے کا URL متعین کریں تو نتائج URL میں شامل ڈومین کے لیے واپس کیے جائیں گے
- validate_micromarkup
 قسم: boolean | null
 
 مائیکرو ڈیٹا کی توثیق فعال کریں
 اختیاری فیلڈ
 اگر آپ OnPage API Microdata endpoint استعمال کرنا چاہتے ہیں تو true پر سیٹ کریں
 ڈیفالٹ قدر: false

جوابات

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

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

status_code
قسم: integer | null

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

status_message
قسم: string | null

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

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

ٹاسکس کی صف

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

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

data
قسم: object | null

وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

propertyName
قسم: object | null
id
قسم: string | null

ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ

path
قسم: array (string | null)[] | null

URL پاتھ

result
قسم: object | null

نتائج کی صف
اس صورت میں قدر null ہوگی

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/on_page/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "max_crawl_pages": 10,
    "load_resources": true,
    "enable_javascript": true,
    "custom_js": "meta = {}; meta.url = document.URL; meta;",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

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

{
  "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": null
    }
  ]
}

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

OnPage ٹاسکس سیٹ کرنا

توثیقRequired

DataForSEO

OnPage ٹاسکس سیٹ کرنا

قیمت کا حوالہ