DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ตั้งงาน Google Events SERP
เข้าคิวกิจกรรมที่ Google แสดงสำหรับคำค้นบน Google และคืน id ของงานใน tasks[0].id ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 endpoint แบบเรียลไทม์คู่กันตอบทันทีและง่ายกว่าสำหรับคำขอเดียว ให้เข้าคิวเมื่อชุดงานใช้เวลานานเกินกว่าการเรียกเครื่องมือหนึ่งครั้ง
ข้อมูลอ้างอิงราคา
- การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
- ค่าประมาณคำขออ้างอิง: USD 0.02
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- ประเภท: array object[]
- keywordประเภท: stringจำเป็น
คีย์เวิร์ดที่ใช้ค้นหา
- languageประเภท: string
_code รหัสภาษาของเครื่องมือค้นหา
- languageประเภท: string
_name ชื่อเต็มของภาษาของเครื่องมือค้นหา
- locationประเภท: integer
_code รหัสสถานที่ของเครื่องมือค้นหา
- locationประเภท: string
_coordinate พิกัด GPS ของสถานที่
- locationประเภท: string
_name ชื่อเต็มของสถานที่ของเครื่องมือค้นหา
- pingbackประเภท: string
_url URL แจ้งเตือนของงานที่เสร็จสิ้น
- postbackประเภท: string
_data ชนิดข้อมูล postback
- postbackประเภท: string
_url URL สำหรับส่งผลลัพธ์ของงาน
- priorityประเภท: integer
ลำดับความสำคัญของงาน
- ประเภท: object200
การตอบกลับสำเร็จ
- ประเภท: numbercost
ค่าใช้จ่ายรวมของงาน, USD
- ประเภท: integerstatus
_code รหัสสถานะทั่วไป
- ประเภท: stringstatus
_message ข้อความข้อมูลทั่วไป
- ประเภท: array string[]tasks
อาร์เรย์ของออบเจ็กต์งาน
- ประเภท: integertasks
_count จำนวนงานในอาร์เรย์ tasks
- ประเภท: integertasks
_error จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด
- ประเภท: numbertasks[]
.cost ค่าใช้จ่ายของงาน, USD
- ประเภท: stringtasks[]
.id ตัวระบุงานในรูปแบบ UUID
- ประเภท: integertasks[]
.result _count จำนวนองค์ประกอบในอาร์เรย์ผลลัพธ์
- ประเภท: integertasks[]
.status _code รหัสสถานะของงาน
- ประเภท: stringtasks[]
.status _message ข้อความสถานะของงาน
- ประเภท: stringtime
เวลาดำเนินการ, วินาที
- ประเภท: stringversion
เวอร์ชันปัจจุบันของ 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/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
}