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

Organik YouTube Lanjutan Langsung

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

Organik YouTube Lanjutan Langsung

​

Mengembalikan hasil peringkat untuk kata kunci di YouTube, secara sinkron. Mengembalikan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, dan items. advanced adalah pilihan default; ambil regular bila hanya daftar peringkat yang penting dan html hanya untuk memeriksa apa yang dibuang parser. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.002.
  • 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.

Isi
application/json
  • Tipe: array (object | null)[]
    • block_depth
      Tipe: integer | null

      kedalaman parsing field opsional jumlah blok hasil di SERP nilai default: 20 nilai maksimum: 200 Catatan: akun Anda akan ditagih untuk setiap SERP yang berisi hingga 20 hasil; dengan demikian, menetapkan kedalaman blok di atas 20 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 20 hasil; jika kedalaman blok yang ditentukan lebih tinggi dari jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda

    • device
      Tipe: string | null

      jenis perangkat field opsional kembalikan hasil untuk jenis perangkat tertentu nilai yang tersedia: desktop, mobile

    • keyword
      Tipe: string

      keyword field wajib Anda dapat menentukan hingga 700 karakter di field keyword semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi) jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”; jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”; pelajari selengkapnya tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string | null

      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

    • language_name
      Tipe: string | null

      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

    • location_code
      Tipe: integer | null

      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

    • location_name
      Tipe: string | null

      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

    • os
      Tipe: string | null

      sistem operasi perangkat field opsional jika Anda menentukan desktop di field device, pilih dari nilai berikut: windows, macos nilai default: windows jika Anda menentukan mobile di field device, pilih dari nilai berikut: android, ios nilai default: android

    • search_param
      Tipe: string | null

      parameter tambahan kueri pencarian field opsional contoh: sp=EgIQAg%253D%253D

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

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

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

      array tugas

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

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

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

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

          Jalur URL

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

          array hasil

          • check_url
            Tipe: string | null

            URL langsung ke hasil mesin penelusuran Anda dapat menggunakannya untuk memastikan bahwa kami memberikan hasil yang akurat

          • datetime
            Tipe: string | null

            tanggal dan waktu saat hasil diterima dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00

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

            jenis hasil penelusuran di SERP berisi jenis hasil penelusuran (items) yang ditemukan di SERP. jenis item yang mungkin: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist

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

            elemen hasil penelusuran yang ditemukan di SERP

            • block_name
              Tipe: string | null

              nama blok di SERP
              contoh:
              "People also watched"

            • block_rank
              Tipe: integer | null

              peringkat blok di SERP
              posisi di antara semua blok di SERP

            • channel_id
              Tipe: string | null

              ID saluran

            • rank_absolute
              Tipe: integer | null

              peringkat absolut di SERP untuk domain target
              posisi absolut di antara semua elemen di SERP

            • rank_group
              Tipe: integer | null

              peringkat grup di SERP
              posisi dalam grup elemen dengan nilai type yang identik
              posisi elemen dengan nilai type berbeda dihilangkan dari rank_group

            • type
              Tipe: string | null

              jenis elemen

            • url
              Tipe: string | null

              URL saluran

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • keyword
            Tipe: string | null

            kata kunci yang diterima dalam array POST kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • se_domain
            Tipe: string | null

            domain mesin penelusuran dalam array POST

          • se_results_count
            Tipe: integer | null Format: int64

            jumlah total hasil di SERP

          • spell
            Tipe: object | null · Response36Afe1097B20_SpellInfo

            koreksi otomatis mesin penelusuran jika mesin penelusuran memberikan hasil untuk kata kunci yang dikoreksi, kami akan menentukan kata kunci yang dikoreksi oleh mesin penelusuran dan jenis koreksi otomatisnya

            • keyword
              Tipe: string | null

              kata kunci yang diperoleh sebagai hasil koreksi otomatis mesin penelusuran hasil akan diberikan untuk kata kunci yang dikoreksi

            • type
              Tipe: string | null

              jenis koreksi otomatis nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for catatan: Yahoo dan Yandex hanya mendukung jenis koreksi otomatis berikut: including_results_for

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      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
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
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Live YouTube Organic Advanced