DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ảnh chụp trang SERP API
Trả về ảnh chụp màn hình đã render của một trang kết quả tìm kiếm trên Google. Trả về keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count và items. Được bọc trong phong bì của DataForSEO: dữ liệu ở tasks[0].result, kết quả ở tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200.
Tham chiếu giá
- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: array (object | null)[]
- browserKiểu: string | null
_preset cài đặt sẵn độ phân giải trình duyệt
trường tùy chọn
cài đặt sẵn trình duyệt gắn với một loại thiết bị nhất định
có thể nhận các giá trị sau:desktop,tablet,mobile
Lưu ý: theo mặc định, cài đặt sẵn trình duyệt tương ứng với loại thiết bị được chỉ định trong yêu cầu POST - browserKiểu: integer | null
_screen _height chiều cao độ phân giải trình duyệt
trường tùy chọn
có thể chỉ định trong khoảng sau:240-9999
giá trị mặc định chodesktop: 1080
giá trị mặc định chomobile: 844
giá trị mặc định chotable: 1366 - browserKiểu: number | null
_screen _scale _factor hệ số tỉ lệ trình duyệt
trường tùy chọn
có thể chỉ định trong khoảng sau:0.5-3
giá trị mặc định chodesktop: 1
giá trị mặc định chomobile: 3
giá trị mặc định chotable: 2 - browserKiểu: integer | null Định dạng: int64
_screen _width chiều rộng độ phân giải trình duyệt
trường tùy chọn
có thể chỉ định trong khoảng sau:240-9999
giá trị mặc định chodesktop: 1920
giá trị mặc định chomobile: 390
giá trị mặc định chotable: 1024 - pageKiểu: integer | null
số trang SERP
trường tùy chọn
nếudepthtrong yêu cầu POST tác vụ tương ứng vượt quá 10 kết quả (hoặc 1 trang SERP), hãy chỉ định số trang SERP cần chụp ảnh màn hình;
giá trị mặc định:1 - taskKiểu: string
_id
- Kiểu: object | null · Response36Afe1097B20_SerpScreenshotResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- Kiểu: string | nullstatus
_message thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_SerpScreenshotTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiểu: string | null
mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- itemsKiểu: array (object | null)[] | null
mảng items
- imageKiểu: string | null
ảnh chụp trang được yêu cầu
URL ảnh chụp trang trên bộ lưu trữ DataForSEO
Lưu ý: ảnh chụp trang lưu trên bộ lưu trữ DataForSEO chỉ còn truy cập được trong một ngày sau khi gửi yêu cầu
- itemsKiểu: integer | null Định dạng: int64
_count số mục trong mảng kết quả
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- statusKiểu: string | null
_message thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
phiên bản hiện tại của API
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"task_id": "06211235-0696-0139-1000-36727fbd3c90",
"browser_screen_scale_factor": 0.5
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}