DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ทรัพยากรใน OnPage API
แอสเซ็ตที่ไม่ใช่หน้าเว็บซึ่งการ crawl พบ ได้แก่ รูปภาพ สคริปต์ และสไตล์ชีต พร้อมสถานะและขนาด แบ่งหน้าด้วย search_after_token อ่านการ crawl ที่เสร็จแล้ว จึงต้องใช้ id จาก post_dataforseo_on_page_submit และคืนค่า crawl_progress พร้อม crawl_status ซึ่งเป็น max_crawl_pages, pages_in_queue และ pages_crawled — ตรวจสอบค่าเหล่านี้ก่อนเชื่อผลลัพธ์ที่มีขนาดเล็ก เพราะการ crawl ที่ยังทำงานอยู่ย่อมมีข้อมูลให้รายงานน้อยกว่า สำหรับแอสเซ็ตที่ตัว crawl เข้าถึงไม่ได้เลย ให้ใช้ post_dataforseo_on_page_uncrawlable_resources 💰 ต้นทางฟรี: การ query crawl ที่เสร็จแล้วไม่มีค่าใช้จ่าย มีแต่ตัว crawl เองเท่านั้นที่มีค่าใช้จ่าย
ข้อมูลอ้างอิงราคา
- การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
- ค่าประมาณคำขออ้างอิง: 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- ผลลัพธ์จะถูกเรียงลำดับจากมากไปน้อย
คุณควรใช้เครื่องหมายจุลภาคเพื่อกำหนดประเภทการเรียงลำดับ
ตัวอย่าง:["size,desc"]
โปรดทราบว่าคุณสามารถตั้งกฎการเรียงลำดับได้ไม่เกินสามข้อในคำขอเดียว
คุณควรใช้เครื่องหมายจุลภาคเพื่อแยกกฎการเรียงลำดับหลายข้อ
ตัวอย่าง:["size,desc","fetch_timing.fetch_end,desc"] - relevantประเภท: array string[] | null
_pages _filters กรองทรัพยากรตามหน้าเว็บที่เกี่ยวข้อง
ฟิลด์ไม่บังคับ
คุณสามารถใช้ฟิลด์นี้เพื่อรับทรัพยากรจากหน้าเว็บที่ตรงกับพารามิเตอร์ที่กำหนด
คุณสามารถใช้ตัวกรองเดียวกับที่มีให้สำหรับ endpoint pages
คุณสามารถเพิ่มตัวกรองหลายรายการพร้อมกันได้ (สูงสุด 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 โทเคนสำหรับคำขอถัดไป
ฟิลด์ที่ไม่บังคับ
มีให้ในฟิลด์ identical ของการตอบกลับในแต่ละคำขอ;
ใช้พารามิเตอร์นี้เพื่อหลีกเลี่ยงการหมดเวลาเมื่อพยายามรับผลลัพธ์เกิน20,000รายการในคำขอเดียว;
เมื่อระบุค่าsearch_after_tokenที่ไม่ซ้ำจากอาร์เรย์ผลลัพธ์ จะได้ผลลัพธ์ถัดไปของงานเริ่มต้น;
ค่าsearch_after_tokenไม่ซ้ำสำหรับงานถัดไปแต่ละงาน ;
หมายเหตุ: หากระบุsearch_after_tokenในคำขอ พารามิเตอร์อื่นทั้งหมดต้องเหมือนกับคำขอก่อนหน้า - tagประเภท: string | null
ตัวระบุงานที่ผู้ใช้กำหนด
ฟิลด์ไม่บังคับ
จำกัด 255 อักขระ
ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
คุณจะพบค่าtagที่ระบุในออบเจ็กต์dataของการตอบกลับ - urlประเภท: string | null
URL ของหน้าเว็บ
ฟิลด์ไม่บังคับ
ระบุฟิลด์นี้หากต้องการรับทรัพยากรสำหรับหน้าเว็บเฉพาะ
โปรดทราบว่าเพื่อให้ได้metaของทรัพยากรจาก URL เฉพาะ คุณควรระบุ URL ในฟิลด์นี้;
หากไม่ได้ระบุurlเมื่อตั้งงานmetaของทรัพยากรในผลลัพธ์จะถูกส่งคืนตามข้อมูลจากหน้าที่ crawler ของเราพบทรัพยากรเป็นครั้งแรก
- ประเภท: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- ประเภท: number | null รูปแบบ: doublecost
ค่าใช้จ่ายรวมของงาน, USD
- ประเภท: integer | nullstatus
_code รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่
- ประเภท: string | nullstatus
_message ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่
- ประเภท: array (object | null)[] | nulltasks
อาร์เรย์ของงาน
- ประเภท: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
- costประเภท: number | null รูปแบบ: double
ค่าใช้จ่ายรวมของงาน, USD
- 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 สถานะของเซสชันการ crawl
ค่าที่เป็นไปได้:in_progress,finished - crawlประเภท: object | null · Response36Afe1097B20_CrawlStatusInfo
_status รายละเอียดของเซสชันการ crawl
- 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 รหัสสถานะทั่วไปคุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่หมายเหตุ: เราขอแนะนำอย่างยิ่งให้ออกแบบระบบที่จำเป็นสำหรับการจัดการเงื่อนไขที่ผิดปกติหรือข้อผิดพลาดที่เกี่ยวข้อง
- warningsประเภท: array (object | null)[] | null
คำเตือนของทรัพยากร
- columnประเภท: integer | null
คอลัมน์ที่พบข้อผิดพลาด
- lineประเภท: integer | null
บรรทัดที่พบข้อผิดพลาด
- messageประเภท: string | null
ข้อความของข้อผิดพลาดรายการข้อผิดพลาด HTML ที่เป็นไปได้ทั้งหมดดูได้ที่นี่
- statusประเภท: integer | null
_code รหัสสถานะทั่วไปคุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่หมายเหตุ: เราขอแนะนำอย่างยิ่งให้ออกแบบระบบที่จำเป็นสำหรับการจัดการเงื่อนไขที่ผิดปกติหรือข้อผิดพลาดที่เกี่ยวข้อง
- resourceประเภท: string | null
_type ประเภทขององค์ประกอบ
- serverประเภท: string | null
เวอร์ชันเซิร์ฟเวอร์
- sizeประเภท: integer | null
ขนาดทรัพยากรระบุขนาดของหน้าเว็บที่กำหนดเป็นไบต์
- statusประเภท: integer | null
_code รหัสสถานะทั่วไปคุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่หมายเหตุ: เราขอแนะนำอย่างยิ่งให้ออกแบบระบบที่จำเป็นสำหรับการจัดการเงื่อนไขที่ผิดปกติหรือข้อผิดพลาดที่เกี่ยวข้อง
- 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 จำนวนรวมของรายการที่เกี่ยวข้องที่ crawl แล้ว
- 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/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]"
}
]
}
]
}
]
}