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

Membuat Tugas ‘Bing Keyword Performance’ 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

Membuat Tugas ‘Bing Keyword Performance’ Langsung

​

Bagaimana daftar keywords berperforma di Bing Ads untuk device dan jenis match tertentu. ⚠️ language_name wajib dan ketiadaannya dilaporkan sebagai Invalid Field: 'language_name' di dalam HTTP 200 - pesan itu berarti hilang maupun salah. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan yang valid berasal dari get_dataforseo_keywords_bing_kw_performance_locales. Endpoint pengiriman dan pengambilan kembar dari endpoint ini melakukan pekerjaan yang sama secara asinkron, dengan harga yang sama, untuk kumpulan yang terlalu besar untuk ditunggu.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.09.
  • 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)[]
    • device
      Tipe: string | null

      jenis perangkat
      field opsional
      tentukan field ini jika Anda ingin mendapatkan data untuk jenis perangkat tertentu. nilai yang mungkin: desktop, mobile, tablet, all
      nilai default: all

    • keywords
      Tipe: array string[]

      kata kunci
      field wajib
      Jumlah maksimum kata kunci yang dapat Anda tentukan: 1000
      Jumlah maksimum karakter untuk setiap kata kunci: 80
      Jumlah maksimum kata untuk setiap frasa kata kunci: 10
      kata kunci yang ditentukan akan diubah ke huruf kecil, data akan disediakan dalam array terpisah

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string

      kode bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_name
      Anda dapat memperoleh daftar lokasi dan bahasa yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      "en"

    • language_name
      Tipe: string

      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 lokasi dan bahasa yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_name atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
      Anda dapat memperoleh daftar lokasi dan bahasa yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      2840

    • location_coordinate
      Tipe: string

      koordinat GPS suatu lokasi
      field wajib jika Anda tidak menentukan location_name atau location_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
      parameter location_coordinate harus ditentukan dalam format "latitude,longitude"
      data akan diberikan untuk negara tempat koordinat yang ditentukan berada
      contoh:
      52.6178549,-155.352142

    • location_name
      Tipe: string

      nama lengkap lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_code atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
      Anda dapat memperoleh daftar lokasi dan bahasa yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      "United States"

    • match
      Tipe: string | null

      jenis kecocokan kata kunci
      field opsional
      dapat mengambil nilai berikut:
      aggregate mengembalikan data di semua jenis kecocokan;
      broad mengembalikan data untuk semua kueri pengguna yang berisi kata kunci yang ditentukan dengan urutan kata yang bervariasi;
      phrase mengembalikan data untuk semua kueri pengguna yang berisi kata kunci yang ditentukan dengan urutan kata yang identik;
      exact mengembalikan data untuk kueri pengguna yang cocok dengan kata kunci yang ditentukan;Catatan: jenis kecocokan aggregate diterapkan secara default

    • 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_KeywordsDataBingKeywordPerformanceLiveResponseInfo
    • 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_KeywordsDataBingKeywordPerformanceLiveTaskInfo
        • 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

          • keyword
            Tipe: string | null

            kata kunci dalam array POST

          • keyword_kpi
            Tipe: object | null · Response36Afe1097B20_KeywordKpi

            objek berisi metrik kata kunci
            jika tidak ada data, nilainya adalah null

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

              data kata kunci yang diagregasi untuk perangkat desktop
              jika tidak ada data, nilainya adalah null

              • ad_position
                Tipe: string | null

                mewakili posisi iklan terkait di SERP
                dapat bernilai sebagai berikut:
                FirstPage1: Iklan pertama yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage2: Iklan kedua yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage3: Iklan ketiga yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage4: Iklan keempat yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage5: Iklan kelima yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage6: Iklan keenam yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage7: Iklan ketujuh yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage8: Iklan kedelapan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage9: Iklan kesembilan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage10: Iklan kesepuluh yang muncul di sisi kanan halaman hasil penelusuran pertama
                MainLine1: Iklan pertama yang muncul di bagian atas halaman hasil penelusuran
                MainLine2: Iklan kedua yang muncul di bagian atas halaman hasil penelusuran
                MainLine3: Iklan ketiga yang muncul di bagian atas halaman hasil penelusuran
                MainLine4: Iklan keempat yang muncul di bagian atas halaman hasil penelusuran

              • average_bid
                Tipe: number | null Format: double

                tawaran rata-rata kata kunci

              • average_cpc
                Tipe: number | null Format: double

                biaya rata-rata per klik, USD
                dihitung dengan membagi biaya semua klik dengan jumlah klik

              • clicks
                Tipe: integer | null

                klik iklan
                jumlah klik yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • ctr
                Tipe: number | null Format: double

                rasio klik-tayang sebagai persentase
                dihitung dengan membagi jumlah klik dengan jumlah tayangan lalu mengalikan hasilnya dengan 100

              • impressions
                Tipe: integer | null

                tayangan iklan
                jumlah tayangan yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • total_cost
                Tipe: number | null Format: int64

                total biaya iklan, USD
                biaya penggunaan kata kunci dan jenis kecocokan yang ditentukan selama bulan lalu

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

              data kata kunci yang diagregasi untuk perangkat seluler
              jika tidak ada data, nilainya adalah null

              • ad_position
                Tipe: string | null

                mewakili posisi iklan terkait di SERP
                dapat bernilai sebagai berikut:
                FirstPage1: Iklan pertama yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage2: Iklan kedua yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage3: Iklan ketiga yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage4: Iklan keempat yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage5: Iklan kelima yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage6: Iklan keenam yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage7: Iklan ketujuh yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage8: Iklan kedelapan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage9: Iklan kesembilan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage10: Iklan kesepuluh yang muncul di sisi kanan halaman hasil penelusuran pertama
                MainLine1: Iklan pertama yang muncul di bagian atas halaman hasil penelusuran
                MainLine2: Iklan kedua yang muncul di bagian atas halaman hasil penelusuran
                MainLine3: Iklan ketiga yang muncul di bagian atas halaman hasil penelusuran
                MainLine4: Iklan keempat yang muncul di bagian atas halaman hasil penelusuran

              • average_bid
                Tipe: number | null Format: double

                tawaran rata-rata kata kunci

              • average_cpc
                Tipe: number | null Format: double

                biaya rata-rata per klik, USD
                dihitung dengan membagi biaya semua klik dengan jumlah klik

              • clicks
                Tipe: integer | null

                klik iklan
                jumlah klik yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • ctr
                Tipe: number | null Format: double

                rasio klik-tayang sebagai persentase
                dihitung dengan membagi jumlah klik dengan jumlah tayangan lalu mengalikan hasilnya dengan 100

              • impressions
                Tipe: integer | null

                tayangan iklan
                jumlah tayangan yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • total_cost
                Tipe: number | null Format: int64

                total biaya iklan, USD
                biaya penggunaan kata kunci dan jenis kecocokan yang ditentukan selama bulan lalu

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

              data kata kunci yang diagregasi untuk perangkat tablet
              jika tidak ada data, nilainya adalah null

              • ad_position
                Tipe: string | null

                mewakili posisi iklan terkait di SERP
                dapat bernilai sebagai berikut:
                FirstPage1: Iklan pertama yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage2: Iklan kedua yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage3: Iklan ketiga yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage4: Iklan keempat yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage5: Iklan kelima yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage6: Iklan keenam yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage7: Iklan ketujuh yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage8: Iklan kedelapan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage9: Iklan kesembilan yang muncul di sisi kanan halaman hasil penelusuran pertama
                FirstPage10: Iklan kesepuluh yang muncul di sisi kanan halaman hasil penelusuran pertama
                MainLine1: Iklan pertama yang muncul di bagian atas halaman hasil penelusuran
                MainLine2: Iklan kedua yang muncul di bagian atas halaman hasil penelusuran
                MainLine3: Iklan ketiga yang muncul di bagian atas halaman hasil penelusuran
                MainLine4: Iklan keempat yang muncul di bagian atas halaman hasil penelusuran

              • average_bid
                Tipe: number | null Format: double

                tawaran rata-rata kata kunci

              • average_cpc
                Tipe: number | null Format: double

                biaya rata-rata per klik, USD
                dihitung dengan membagi biaya semua klik dengan jumlah klik

              • clicks
                Tipe: integer | null

                klik iklan
                jumlah klik yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • ctr
                Tipe: number | null Format: double

                rasio klik-tayang sebagai persentase
                dihitung dengan membagi jumlah klik dengan jumlah tayangan lalu mengalikan hasilnya dengan 100

              • impressions
                Tipe: integer | null

                tayangan iklan
                jumlah tayangan yang dihasilkan kata kunci dan jenis kecocokan selama bulan lalu

              • total_cost
                Tipe: number | null Format: int64

                total biaya iklan, USD
                biaya penggunaan kata kunci dan jenis kecocokan yang ditentukan selama bulan lalu

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST
            jika tidak ada data, nilainya adalah_nulln

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST
            jika tidak ada data, nilainya adalah_nulln

          • month
            Tipe: integer | null

            menunjukkan bulan data disediakan
            misalnya:
            10

          • year
            Tipe: integer | null

            menunjukkan tahun data disediakan
            misalnya:
            2020

        • 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/keywords_data/bing/keyword_performance/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "keywords": [
      "dataforseo",
      "seo",
      "ranking"
    ]
  }
]'

{
  "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,
          "location_code": null,
          "language_code": null,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}

Operasi berhasil

Setting Live ‘Bing Keyword Performance’ Tasks