DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Organik YouTube Lanjutan Langsung
Memulangkan hasil berkedudukan untuk kata kunci di YouTube, secara segerak. Memulangkan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count dan items. advanced ialah pilihan lalai; ambil regular apabila hanya senarai berkedudukan yang penting dan html hanya untuk memeriksa apa yang digugurkan penghurai. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.002.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- blockJenis: integer | null
_depth kedalaman penghuraian medan pilihan bilangan blok hasil dalam SERP nilai lalai: 20 nilai maksimum: 200 Nota: akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 20 hasil; oleh itu, menetapkan kedalaman blok melebihi 20 boleh menyebabkan caj tambahan jika enjin carian mengembalikan lebih daripada 20 hasil; jika kedalaman blok yang ditentukan lebih tinggi daripada bilangan hasil dalam respons, perbezaannya akan dikembalikan secara automatik ke baki akaun anda
- deviceJenis: string | null
jenis peranti medan pilihan pulangkan hasil untuk jenis peranti tertentu nilai yang tersedia: desktop, mobile
- keywordJenis: string
keyword medan wajib anda boleh menentukan sehingga 700 aksara dalam medan keyword semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang) jika anda perlu menggunakan aksara “%” untuk keyword, tentukan sebagai “%25”; jika anda perlu menggunakan aksara “+” untuk keyword, tentukan sebagai “%2B”; ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
- languageJenis: string | null
_code kod bahasa enjin carian medan wajib jika anda tidak menentukan language_name jika anda menggunakan medan ini, anda tidak perlu menentukan language_name anda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: en
- languageJenis: string | null
_name nama penuh bahasa enjin carian medan wajib jika anda tidak menentukan language_code jika anda menggunakan medan ini, anda tidak perlu menentukan language_code anda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/languages contoh: English
- locationJenis: integer | null
_code kod lokasi enjin carian medan wajib jika anda tidak menentukan location_name jika anda menggunakan medan ini, anda tidak perlu menentukan location_name anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: 2840
- locationJenis: string | null
_name nama penuh lokasi enjin carian medan wajib jika anda tidak menentukan location_code jika anda menggunakan medan ini, anda tidak perlu menentukan location_code anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/youtube/locations contoh: United States
- osJenis: string | null
sistem pengendalian peranti medan pilihan jika anda menentukan desktop dalam medan device, pilih daripada nilai berikut: windows, macos nilai lalai: windows jika anda menentukan mobile dalam medan device, pilih daripada nilai berikut: android, ios nilai lalai: android
- searchJenis: string | null
_param parameter tambahan pertanyaan carian medan pilihan contoh: sp=EgIQAg%253D%253D
- tagJenis: string | null
pengecam tugas yang ditentukan pengguna medan pilihan had aksara ialah 255 anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil anda akan menemui nilai tag yang ditentukan dalam objek data respons
- Jenis: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
array tugas
- Jenis: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: array (object | null)[] | null
array hasil
- checkJenis: string | null
_url URL langsung ke hasil enjin carian anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat
- datetimeJenis: string | null
tarikh dan masa apabila hasil diterima dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00
- itemJenis: array (string | null)[] | null
_types jenis hasil carian dalam SERP mengandungi jenis hasil carian (items) yang ditemui dalam SERP. jenis item yang mungkin: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist
- itemsJenis: array (object | null)[] | null
elemen hasil carian yang ditemui dalam SERP
- blockJenis: string | null
_name nama blok dalam SERP
contoh:"People also watched" - blockJenis: integer | null
_rank kedudukan blok dalam SERP
kedudukan antara semua blok dalam SERP - channelJenis: string | null
_id ID saluran
- rankJenis: integer | null
_absolute kedudukan mutlak dalam SERP untuk domain sasaran
kedudukan mutlak antara semua elemen dalam SERP - rankJenis: integer | null
_group kedudukan kumpulan dalam SERP
kedudukan dalam kumpulan elemen dengan nilaitypeyang serupa
kedudukan elemen dengan nilaitypeberbeza dikecualikan daripadarank_group - typeJenis: string | null
jenis elemen
- urlJenis: string | null
URL saluran
- itemsJenis: integer | null Format: int64
_count bilangan hasil yang dikembalikan dalam array items
- keywordJenis: string | null
kata kunci yang diterima dalam array POST kata kunci dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)
- languageJenis: string | null
_code kod bahasa dalam array POST
- locationJenis: integer | null
_code kod lokasi dalam array POST
- seJenis: string | null
_domain domain enjin carian dalam array POST
- seJenis: integer | null Format: int64
_results _count jumlah keseluruhan hasil dalam SERP
- spellJenis: object | null · Response36Afe1097B20_SpellInfo
pembetulan automatik enjin carian jika enjin carian memberikan hasil untuk kata kunci yang dibetulkan, kami akan menyatakan kata kunci yang dibetulkan oleh enjin carian dan jenis pembetulan automatik
- keywordJenis: string | null
kata kunci yang diperoleh hasil daripada pembetulan automatik enjin carian keputusan akan diberikan untuk kata kunci yang dibetulkan
- typeJenis: string | null
jenis pembetulan automatik nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo dan Yandex hanya menyokong jenis pembetulan automatik berikut: including_results_for
- resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "audi"
}
]'
{
"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": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"block_rank": null,
"block_name": null,
"channel_id": null,
"url": null
}
]
}
]
}
]
}