DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tạo tác vụ SERP Google Events
Xếp hàng các sự kiện Google hiển thị cho một truy vấn trên Google, trả về id tác vụ trong tasks[0].id. Đượ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. Bản trực tiếp trả lời ngay và đơn giản hơn cho một truy vấn đơn lẻ; hãy xếp hàng khi lô yêu cầu sẽ kéo dài hơn một lượt gọi công cụ.
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[]
- keywordKiểu: stringbắt buộc
Từ khóa cần tìm kiếm
- languageKiểu: string
_code Mã ngôn ngữ công cụ tìm kiếm
- languageKiểu: string
_name Tên đầy đủ của ngôn ngữ công cụ tìm kiếm
- locationKiểu: integer
_code Mã vị trí công cụ tìm kiếm
- locationKiểu: string
_coordinate Tọa độ GPS của một vị trí
- locationKiểu: string
_name Tên đầy đủ của vị trí công cụ tìm kiếm
- pingbackKiểu: string
_url URL thông báo của tác vụ đã hoàn thành
- postbackKiểu: string
_data Kiểu dữ liệu postback
- postbackKiểu: string
_url URL để gửi kết quả tác vụ
- priorityKiểu: integer
Độ ưu tiên tác vụ
- Kiểu: object200
Phản hồi thành công
- Kiểu: numbercost
Tổng chi phí tác vụ, USD
- Kiểu: integerstatus
_code Mã trạng thái chung
- Kiểu: stringstatus
_message Thông báo thông tin chung
- Kiểu: array string[]tasks
Mảng đối tượng tác vụ
- Kiểu: integertasks
_count Số lượng tác vụ trong mảng tasks
- Kiểu: integertasks
_error Số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: numbertasks[]
.cost Chi phí của tác vụ, USD
- Kiểu: stringtasks[]
.id Mã định danh tác vụ ở định dạng UUID
- Kiểu: integertasks[]
.result _count Số phần tử trong mảng kết quả
- Kiểu: integertasks[]
.status _code Mã trạng thái tác vụ
- Kiểu: stringtasks[]
.status _message Thông báo trạng thái tác vụ
- Kiểu: stringtime
Thời gian thực thi, giây
- Kiểu: stringversion
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/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}