Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Organik YouTube Lanjutan Langsung

Pelayan:https://openapi.felo.ai
Pustaka Klien

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.

Badan
application/json
  • Jenis: array (object | null)[]
    • block_depth
      Jenis: integer | null

      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

    • device
      Jenis: string | null

      jenis peranti medan pilihan pulangkan hasil untuk jenis peranti tertentu nilai yang tersedia: desktop, mobile

    • keyword
      Jenis: 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

    • language_code
      Jenis: string | null

      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

    • language_name
      Jenis: string | null

      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

    • location_code
      Jenis: integer | null

      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

    • location_name
      Jenis: string | null

      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

    • os
      Jenis: 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

    • search_param
      Jenis: string | null

      parameter tambahan pertanyaan carian medan pilihan contoh: sp=EgIQAg%253D%253D

    • tag
      Jenis: 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

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

    • tasks
      Jenis: array (object | null)[] | null

      array tugas

      • Jenis: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

          • propertyName
            Jenis: object | null
        • id
          Jenis: string | null

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

        • path
          Jenis: array (string | null)[] | null

          Laluan URL

        • result
          Jenis: array (object | null)[] | null

          array hasil

          • check_url
            Jenis: string | null

            URL langsung ke hasil enjin carian anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

          • datetime
            Jenis: 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

          • item_types
            Jenis: array (string | null)[] | null

            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

          • items
            Jenis: array (object | null)[] | null

            elemen hasil carian yang ditemui dalam SERP

            • block_name
              Jenis: string | null

              nama blok dalam SERP
              contoh:
              "People also watched"

            • block_rank
              Jenis: integer | null

              kedudukan blok dalam SERP
              kedudukan antara semua blok dalam SERP

            • channel_id
              Jenis: string | null

              ID saluran

            • rank_absolute
              Jenis: integer | null

              kedudukan mutlak dalam SERP untuk domain sasaran
              kedudukan mutlak antara semua elemen dalam SERP

            • rank_group
              Jenis: integer | null

              kedudukan kumpulan dalam SERP
              kedudukan dalam kumpulan elemen dengan nilai type yang serupa
              kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group

            • type
              Jenis: string | null

              jenis elemen

            • url
              Jenis: string | null

              URL saluran

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dikembalikan dalam array items

          • keyword
            Jenis: string | null

            kata kunci yang diterima dalam array POST kata kunci dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST

          • se_domain
            Jenis: string | null

            domain enjin carian dalam array POST

          • se_results_count
            Jenis: integer | null Format: int64

            jumlah keseluruhan hasil dalam SERP

          • spell
            Jenis: 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

            • keyword
              Jenis: string | null

              kata kunci yang diperoleh hasil daripada pembetulan automatik enjin carian keputusan akan diberikan untuk kata kunci yang dibetulkan

            • type
              Jenis: 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

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      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
Request Example for post/v1/beta/dataforseo/serp/youtube/organic/live/advanced
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
            }
          ]
        }
      ]
    }
  ]
}
Live YouTube Organic Advanced