การตั้งงาน 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

เริ่ม crawl target และคืน id ของงานใน tasks[0].id — id นั้นคือ handle ที่ทุกเครื่องมืออื่นในตระกูลนี้ต้องใช้ จึงควรเก็บไว้ max_crawl_pages จำกัดขอบเขตการ crawl ส่วน start_url, max_crawl_depth, priority_urls และ crawl_delay กำหนดรูปร่าง และ store_raw_html ตัดสินว่า post_dataforseo_on_page_raw_html จะมีอะไรให้บริการภายหลังหรือไม่ ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 ⚠️ นี่ไม่ใช่คู่ submit/fetch ตามปกติ: การ crawl คือเซสชันที่เครื่องมืออื่นอีกราวสิบกว่าตัวจะสอบถามตาม id โพล get_dataforseo_on_page_summary จนกว่า crawl_progress จะอ่านได้ว่า finished การ crawl example.com หนึ่งหน้าใช้เวลาไม่ถึงหนึ่งนาที

ข้อมูลอ้างอิงราคา

การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
ค่าประมาณคำขออ้างอิง: USD 0.003
ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- accept_language
 ประเภท: string | null
 
 เฮดเดอร์ภาษาสำหรับเข้าถึงเว็บไซต์
 ฟิลด์ไม่บังคับ
 รองรับรูปแบบ locale ทั้งหมด (xx, xx-XX, xxx-XX เป็นต้น)
 หมายเหตุ: หากไม่ระบุพารามิเตอร์นี้ เว็บบางแห่งอาจปฏิเสธการเข้าถึง; ในกรณีนี้ หน้าต่างๆ จะถูกส่งกลับพร้อม "type":"broken ในอาร์เรย์การตอบกลับ
- allow_subdomains
 ประเภท: boolean | null
 
 รวมหน้าเว็บบนซับโดเมน
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการ crawl ซับโดเมนทั้งหมดของเว็บไซต์เป้าหมาย
 ค่าเริ่มต้น: false
- allowed_subdomains
 ประเภท: array string[] | null
 
 ซับโดเมนที่จะ crawl
 ฟิลด์ไม่บังคับ
 ระบุซับโดเมนที่คุณต้องการ crawl
 ตัวอย่าง: ["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, tabletdesktop พรีเซ็ตจะใช้ค่าต่อไปนี้:browser_screen_width: 1920
 browser_screen_height: 1080
 browser_screen_scale_factor: 1mobile พรีเซ็ตจะใช้ค่าต่อไปนี้:browser_screen_width: 390
 browser_screen_height: 844
 browser_screen_scale_factor: 3tablet พรีเซ็ตจะใช้ค่าต่อไปนี้:browser_screen_width: 1024
 browser_screen_height: 1366
 browser_screen_scale_factor: 2
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ ให้ตั้ง enable_javascript หรือ enable_browser_rendering เป็น true
- browser_screen_height
 ประเภท: integer | null
 
 ความสูงหน้าจอเบราว์เซอร์
 ฟิลด์ไม่บังคับ
 คุณสามารถตั้งความสูงหน้าจอเบราว์เซอร์แบบกำหนดเองเพื่อทำ audit สำหรับอุปกรณ์เฉพาะ;
 หากใช้ฟิลด์นี้ คุณไม่จำเป็นต้องระบุ browser_preset เพราะจะถูกเพิกเฉย;
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ ให้ตั้ง enable_javascript หรือ enable_browser_rendering เป็น trueค่าต่ำสุด (พิกเซล): 240
 ค่าสูงสุด (พิกเซล): 9999
- browser_screen_scale_factor
 ประเภท: number | null
 
 ตัวคูณสเกลหน้าจอเบราว์เซอร์
 ฟิลด์ไม่บังคับ
 คุณสามารถตั้งอัตราส่วนความละเอียดหน้าจอเบราว์เซอร์แบบกำหนดเองเพื่อทำ audit สำหรับอุปกรณ์เฉพาะ;
 หากใช้ฟิลด์นี้ คุณไม่จำเป็นต้องระบุ browser_preset เพราะจะถูกเพิกเฉย;
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ ให้ตั้ง enable_javascript หรือ enable_browser_rendering เป็น trueค่าต่ำสุด: 0.5
 ค่าสูงสุด: 3
- browser_screen_width
 ประเภท: integer | null รูปแบบ: int64
 
 ความกว้างหน้าจอเบราว์เซอร์
 ฟิลด์ไม่บังคับ
 คุณสามารถตั้งความกว้างหน้าจอเบราว์เซอร์แบบกำหนดเองเพื่อทำ audit สำหรับอุปกรณ์เฉพาะ;
 หากใช้ฟิลด์นี้ คุณไม่จำเป็นต้องระบุ browser_preset เพราะจะถูกเพิกเฉย;
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ ให้ตั้ง enable_javascript หรือ enable_browser_rendering เป็น trueค่าต่ำสุด (พิกเซล): 240
 ค่าสูงสุด (พิกเซล): 9999
- calculate_keyword_density
 ประเภท: boolean | null
 
 คำนวณความหนาแน่นของคีย์เวิร์ดสำหรับโดเมนเป้าหมาย
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการคำนวณความหนาแน่นของคีย์เวิร์ดสำหรับหน้าเว็บของเว็บไซต์
 ค่าเริ่มต้น: false
 หมายเหตุ: หากใช้พารามิเตอร์นี้ จะมีค่าใช้จ่ายเพิ่มเติม; ศึกษาข้อมูลเพิ่มเติมเกี่ยวกับค่าใช้จ่ายของงานที่มีพารามิเตอร์นี้ ในบทความช่วยเหลือของเรา
 เมื่อ crawl เสร็จสิ้น คุณสามารถรับค่าความหนาแน่นของคีย์เวิร์ดได้ด้วย endpoint Keyword Density
- check_spell
 ประเภท: boolean | null
 
 ตรวจตัวสะกด
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true เพื่อตรวจตัวสะกดบนเว็บไซต์โดยใช้ไลบรารี Hunspell
 ค่าเริ่มต้น: 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
 
 ค่าเกณฑ์กำหนดเองสำหรับการตรวจสอบ
 ฟิลด์ไม่บังคับ
 คุณสามารถระบุค่าเกณฑ์กำหนดเองสำหรับพารามิเตอร์ที่รวมอยู่ในออบเจ็กต์ checks ของการตอบกลับ OnPage API;
 หมายเหตุ: แก้ไขได้เฉพาะค่าเกณฑ์ที่เป็นจำนวนเต็มเท่านั้น;
 ตัวอย่างเช่น พารามิเตอร์ high_loading_time และ large_page_size ถูกตั้งเป็น 3 วินาทีและ 1 เมกะไบต์ตามลำดับโดยค่าเริ่มต้น;
 หากต้องการเปลี่ยนเกณฑ์เหล่านี้เป็น 1 วินาทีและ 1000 กิโลไบต์ ให้ใช้โค้ดต่อไปนี้:
 "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
 
 ระยะหน่วงระหว่างการเรียกต่อครั้ง (ms)
 ฟิลด์ไม่บังคับ
 ระยะหน่วงแบบกำหนดเองระหว่างการเรียกของ crawler ไปยังเซิร์ฟเวอร์
 ค่าเริ่มต้น: 2000
- crawl_sitemap_only
 ประเภท: boolean | null
 
 crawl เฉพาะหน้าที่ระบุใน sitemap
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการ crawl เฉพาะหน้าที่ระบุใน sitemap
 หากตั้งพารามิเตอร์นี้เป็น true และไม่ได้ระบุ custom_sitemap ระบบจะ crawl 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
 
 URL ของ sitemap แบบกำหนดเอง
 ฟิลด์ไม่บังคับ
 URL ของหน้าที่มี sitemap ทางเลือกอยู่
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ respect_sitemap ต้องเป็น true
- custom_user_agent
 ประเภท: string | null
 
 user agent แบบกำหนดเอง
 ฟิลด์ไม่บังคับ
 user agent แบบกำหนดเองสำหรับ crawl เว็บไซต์
 ตัวอย่าง: 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
 
 ซับโดเมนที่ไม่ต้องการ crawl
 ฟิลด์ไม่บังคับ
 ระบุซับโดเมนที่คุณไม่ต้องการ crawl
 ตัวอย่าง: ["status.site.com", "docs.site.com"]
 หมายเหตุ: หากต้องการใช้พารามิเตอร์นี้ พารามิเตอร์ allow_subdomains ต้องตั้งเป็น true
- enable_browser_rendering
 ประเภท: boolean | null
 
 จำลองการเรนเดอร์เบราว์เซอร์เพื่อวัด Core Web Vitals
 ฟิลด์ไม่บังคับ
 เมื่อใช้พารามิเตอร์นี้ คุณจะสามารถจำลองเบราว์เซอร์ขณะโหลดหน้าเว็บได้;
 enable_browser_rendering โหลดสไตล์ รูปภาพ ฟอนต์ แอนิเมชัน วิดีโอ และทรัพยากรอื่นๆ บนหน้าเว็บ;
 ค่าเริ่มต้น: false
 ตั้งเป็น true เพื่อรับเมตริก Core Web Vitals (FID, CLS, LCP) ในการตอบกลับ;
 หากใช้ฟิลด์นี้ พารามิเตอร์ enable_javascript และ load_resources ต้องตั้งเป็น true
 หมายเหตุ: หากใช้พารามิเตอร์นี้ จะมีค่าใช้จ่ายเพิ่มเติม; ศึกษาข้อมูลเพิ่มเติมเกี่ยวกับค่าใช้จ่ายของงานที่มีพารามิเตอร์นี้ ในบทความช่วยเหลือของเรา; คำนวณค่าใช้จ่ายได้ที่ หน้า Pricing
- enable_content_parsing
 ประเภท: boolean | null
 
 แยกวิเคราะห์เนื้อหาบนหน้าที่ crawl
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true เพื่อใช้ endpoint OnPage Content Parsing
 ค่าเริ่มต้น: false
- enable_javascript
 ประเภท: boolean | null
 
 โหลด javascript บนหน้าเว็บ
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการโหลดสคริปต์ที่มีอยู่บนหน้าเว็บ
 ค่าเริ่มต้น: false
 หมายเหตุ: หากใช้พารามิเตอร์นี้ จะมีค่าใช้จ่ายเพิ่มเติม; ศึกษาข้อมูลเพิ่มเติมเกี่ยวกับค่าใช้จ่ายของงานที่มีพารามิเตอร์นี้ ในบทความช่วยเหลือของเรา; คำนวณค่าใช้จ่ายได้ที่ หน้า Pricing
- enable_www_redirect_check
 ประเภท: boolean | null
 
 ตรวจสอบว่าโดเมนใช้การเปลี่ยนเส้นทาง www หรือไม่
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการตรวจสอบว่าโดเมนที่ร้องขอทำการเปลี่ยนเส้นทางจาก www ไป non-www หรือ non-www ไป www หรือไม่;
 ค่าเริ่มต้น: false
- enable_xhr
 ประเภท: boolean | null
 
 เปิดใช้ XMLHttpRequest บนหน้าเว็บ
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการให้ crawler ของเราขอข้อมูลจากเว็บเซิร์ฟเวอร์โดยใช้ออบเจ็กต์ XMLHttpRequest
 ค่าเริ่มต้น: false;หากใช้ฟิลด์นี้ enable_javascript ต้องตั้งเป็น true;
- force_sitewide_checks
 ประเภท: boolean | null
 
 เปิดใช้การตรวจสอบระดับไซต์เมื่อ crawl หน้าเว็บเดียว
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true เพื่อรับข้อมูลการตรวจสอบระดับไซต์เมื่อ crawl หน้าเว็บเดียว;
 ค่าเริ่มต้น: false
- load_resources
 ประเภท: boolean | null
 
 โหลดทรัพยากร
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการโหลดรูปภาพ สไตล์ชีต สคริปต์ และทรัพยากรที่เสียหาย
 ค่าเริ่มต้น: false
 หมายเหตุ: หากใช้พารามิเตอร์นี้ จะมีค่าใช้จ่ายเพิ่มเติม; ศึกษาข้อมูลเพิ่มเติมเกี่ยวกับค่าใช้จ่ายของงานที่มีพารามิเตอร์นี้ ในบทความช่วยเหลือของเรา; คำนวณค่าใช้จ่ายได้ที่ หน้า Pricing
- max_crawl_depth
 ประเภท: integer | null
 
 ความลึกในการ crawl
 ฟิลด์ไม่บังคับ
 ความลึกของการเชื่อมโยงของหน้าที่จะ crawl;
 ตัวอย่างเช่น หน้าเริ่มต้นของการ crawl คือระดับ 0 หน้าที่มีลิงก์จากหน้านั้นคือระดับ 1 เป็นต้น
- max_crawl_pages
 ประเภท: integer
 
 ขีดจำกัดจำนวนหน้าที่ crawl
 ฟิลด์ที่จำเป็น
 จำนวนหน้าที่จะ crawl บนโดเมนที่ระบุ
 หมายเหตุ:
 หากตั้ง 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 แจ้งเตือนเมื่องานเสร็จสิ้น
 ฟิลด์ไม่บังคับ
 เมื่องานเสร็จสิ้น เราจะแจ้งให้คุณทราบผ่านคำขอ GET ที่ส่งไปยัง URL ที่คุณระบุ
 คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร $id และ ‘$tag’ เป็นตัวแปร $tag ที่เข้ารหัส URL ได้ เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ
 ตัวอย่าง:
 http://your-server.com/pingscript?id=$id
 http://your-server.com/pingscript?id=$id&tag=$tag
 หมายเหตุ: อักขระพิเศษใน pingback_url จะถูกเข้ารหัส URL;
 กล่าวคือ อักขระ # จะถูกเข้ารหัสเป็น %23
 
 ดูข้อมูลเพิ่มเติมได้ที่Help Center ของเรา
- priority_urls
 ประเภท: array string[] | null
 
 URL ที่จะ crawl โดยข้ามคิว
 ฟิลด์ไม่บังคับ
 URL ที่ระบุในอาร์เรย์นี้จะถูก crawl ก่อนเป็นอันดับแรก โดยข้ามคิวการ crawl;
 หมายเหตุ: ควรระบุ URL แบบสัมบูรณ์;
 ระบุได้สูงสุด 20 URL;
 URL ทั้งหมดในอาร์เรย์ต้องอยู่ในโดเมน target;
 ซับโดเมนจะถูกเพิกเฉย เว้นแต่ตั้งพารามิเตอร์ allow_subdomains เป็น trueตัวอย่าง:
 "priority_urls": [ "https://dataforseo.com/apis/serp-api", "https://dataforseo.com/contact" ]
- respect_sitemap
 ประเภท: boolean | null
 
 ปฏิบัติตาม sitemap เมื่อ crawl
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการทำตามลำดับหน้าที่ระบุใน sitemap หลักเมื่อ crawl;
 ค่าเริ่มต้น: false
 หมายเหตุ: หากตั้งเป็น true ค่า click_depth ในการตอบกลับของ API จะเท่ากับ 0;
 ฟิลด์ max_crawl_depth ของคำขอจะถูกเพิกเฉย และระบุจำนวนหน้าที่จะ crawl ได้ด้วยพารามิเตอร์ max_crawl_pages
- return_despite_timeout
 ประเภท: boolean | null
 
 คืนข้อมูลหน้าเว็บแม้เกิดข้อผิดพลาด timeout
 ฟิลด์ไม่บังคับ
 หากเป็น true ข้อมูลจะถูกจัดหาให้สำหรับหน้าที่โหลดไม่สำเร็จภายใน 120 วินาทีและตอบกลับด้วยข้อผิดพลาด timeout;
 ค่าเริ่มต้น: false
- robots_txt_merge_mode
 ประเภท: string | null
 
 รวมหรือแทนที่การตั้งค่า robots.txt
 ฟิลด์ไม่บังคับ
 ค่าที่เป็นไปได้: merge, override;
 ตั้งเป็น override หากต้องการเพิกเฉยต่อข้อจำกัดการ crawl เว็บไซต์และการตั้งค่า robots.txt อื่นๆ
 ค่าเริ่มต้น: merge;
 หมายเหตุ: หากตั้งเป็น override ให้ระบุพารามิเตอร์ custom_robots_txt
- start_url
 ประเภท: string | null
 
 URL แรกที่จะ crawl
 ฟิลด์ไม่บังคับ
 หมายเหตุ: ควรระบุ URL แบบสัมบูรณ์
 หากต้องการ crawl หน้าเว็บเดียว ให้ระบุ URL ของหน้านั้นในฟิลด์นี้และตั้งพารามิเตอร์ max_crawl_pages เป็น 1 เพิ่มเติม
 ยังใช้ endpoint Instant Pages แบบ live เพื่อรับข้อมูลเฉพาะหน้าเว็บได้
- store_raw_html
 ประเภท: boolean | null
 
 จัดเก็บ HTML ของหน้าที่ crawl
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการรับ HTML ของหน้าเว็บโดยใช้ endpoint OnPage Raw HTML
 ค่าเริ่มต้น: false
- support_cookies
 ประเภท: boolean | null
 
 รองรับคุกกี้บนหน้าที่ crawl
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true เพื่อรองรับคุกกี้เมื่อ crawl หน้าเว็บ
 ค่าเริ่มต้น: false
- switch_pool
 ประเภท: boolean | null
 
 สลับพูลพร็อกซี่
 ฟิลด์ไม่บังคับ
 หากเป็น true พูลพร็อกซี่เพิ่มเติมจะถูกใช้เพื่อรับข้อมูลที่ร้องขอ;
 พารามิเตอร์นี้ใช้ได้เมื่อตั้งงานจำนวนมากพร้อมกัน ทำให้เกิดข้อผิดพลาด rate-limit และ/หรือ site_unreachable เป็นครั้งคราว
- tag
 ประเภท: string | null
 
 ตัวระบุงานที่ผู้ใช้กำหนด
 ฟิลด์ไม่บังคับ
 จำกัด 255 อักขระ
 ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
 คุณจะพบค่า tag ที่ระบุในออบเจ็กต์ data ของการตอบกลับ
- target
 ประเภท: string
 
 โดเมนเป้าหมาย
 ฟิลด์ที่จำเป็น
 ชื่อโดเมนต้องระบุโดยไม่มี https:// และ www.
 หากระบุ URL ของหน้าเว็บ ผลลัพธ์จะถูกส่งคืนสำหรับโดเมนที่อยู่ใน URL
- validate_micromarkup
 ประเภท: boolean | null
 
 เปิดใช้การตรวจสอบ microdata
 ฟิลด์ไม่บังคับ
 ตั้งเป็น true หากต้องการใช้ endpoint OnPage API Microdata
 ค่าเริ่มต้น: 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

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
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

ข้อมูลอ้างอิงราคา