DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Membuat Tugas Info Video YouTube
Mengantrekan metadata satu video YouTube, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.
Referensi harga
- Metering: Biaya respons yang dilaporkan.
- Estimasi referensi per permintaan: USD 0.02.
- Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.
Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.
- Tipe: array (object | null)[]
- deviceTipe: string | null
jenis perangkat field opsional hanya nilai: desktop
- languageTipe: string | null
_code kode bahasa mesin pencari field wajib jika Anda tidak menentukan language_name jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: en
- languageTipe: string | null
_name nama lengkap bahasa mesin pencari field wajib jika Anda tidak menentukan language_code jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: English
- locationTipe: integer | null
_code kode lokasi mesin pencari field wajib jika Anda tidak menentukan location_name jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: 2840
- locationTipe: string | null
_name nama lengkap lokasi mesin pencari field wajib jika Anda tidak menentukan location_code jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: United States
- osTipe: string | null
sistem operasi perangkat field opsional pilih dari nilai berikut: windows, macos nilai default: windows
- pingbackTipe: string | null
_url URL notifikasi tugas yang selesai field opsional ketika tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Catatan: karakter khusus dalam pingback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami
- postbackTipe: string | null
_data tipe data postback_url field wajib jika Anda menentukan postback_url sesuai dengan tipe data yang akan dikirim ke server Anda nilai yang mungkin: advanced
- postbackTipe: string | null
_url URL pengembalian untuk mengirim hasil tugas field opsional setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Catatan: karakter khusus dalam postback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami
- priorityTipe: integer | null
prioritas tugas field opsional dapat mengambil nilai berikut: 1 – prioritas eksekusi normal (ditetapkan secara default) 2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi. Biaya dapat dihitung di halaman Harga.
- tagTipe: string | null
pengenal tugas yang ditentukan pengguna field opsional batas karakter adalah 255 Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil Anda akan menemukan nilai tag yang ditentukan di objek data pada respons
- videoTipe: string
_id ID video field wajib Anda dapat menemukan ID video di URL atau item 'youtube_video' pada hasil YouTube Organic contoh: vQXvyV0zIP4
- Tipe: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskPostResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskPostTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: object | null
array hasil; dalam kasus ini, nilainya akan null
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
versi API saat ini
application/json - 400
Permintaan tidak dapat diproses. Periksa parameter permintaan.
- 401
Kunci API Felo yang valid diperlukan.
- 402
Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
- 403
Akun tidak diizinkan melakukan operasi ini.
- 429
Batas permintaan atau batas pengeluaran telah tercapai.
- 502
Layanan tidak dapat menyelesaikan permintaan.
- 503
API atau layanan penagihan untuk sementara tidak tersedia.
- 504
Layanan kehabisan waktu saat memproses permintaan.
- default
Respons error; respons passthrough upstream dapat menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_info/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "vQXvyV0zIP4"
}
]'
{
"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
}
]
}