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

Mencipta Tugas ‘Bing Keyword Performance’ Langsung

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

DataForSEO

​

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

DataForSEO Operasi

Mencipta Tugas ‘Bing Keyword Performance’ Langsung

​

Bagaimana senarai keywords berprestasi dalam Bing Ads bagi device dan jenis match tertentu. ⚠️ language_name wajib dan ketiadaannya dilaporkan sebagai Invalid Field: 'language_name' di dalam HTTP 200 - mesej itu bermaksud hilang mahupun salah. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Pasangan yang sah datang daripada get_dataforseo_keywords_bing_kw_performance_locales. Endpoint penghantaran dan pengambilan kembar bagi endpoint ini melakukan kerja yang sama secara tak segerak, pada harga yang sama, untuk kelompok yang terlalu besar untuk ditunggu.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.09.
  • 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)[]
    • device
      Jenis: string | null

      jenis peranti
      medan pilihan
      tentukan medan ini jika anda ingin mendapatkan data untuk jenis peranti tertentu. nilai yang mungkin: desktop, mobile, tablet, all
      nilai lalai: all

    • keywords
      Jenis: array string[]

      kata kunci
      medan wajib
      Bilangan maksimum kata kunci yang boleh anda tentukan: 1000
      Bilangan maksimum aksara untuk setiap kata kunci: 80
      Bilangan maksimum perkataan untuk setiap frasa kata kunci: 10
      kata kunci yang ditentukan akan ditukar kepada huruf kecil, data akan disediakan dalam tatasusunan berasingan

      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini

    • language_code
      Jenis: string

      kod bahasa enjin carian
      medan wajib jika anda tidak menentukan language_name
      anda boleh mendapatkan senarai lokasi dan bahasa yang tersedia dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      "en"

    • language_name
      Jenis: string

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

    • location_code
      Jenis: integer

      kod lokasi enjin carian
      medan wajib jika anda tidak menentukan location_name atau location_coordinate
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
      anda boleh mendapatkan senarai lokasi dan bahasa yang tersedia dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      2840

    • location_coordinate
      Jenis: string

      koordinat GPS sesuatu lokasi
      medan wajib jika anda tidak menentukan location_name atau location_code
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
      parameter location_coordinate hendaklah ditentukan dalam format "latitude,longitude"
      data akan disediakan untuk negara milik koordinat yang ditentukan
      contoh:
      52.6178549,-155.352142

    • location_name
      Jenis: string

      nama penuh lokasi enjin carian
      medan wajib jika anda tidak menentukan location_code atau location_coordinate
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
      anda boleh mendapatkan senarai lokasi dan bahasa yang tersedia dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      contoh:
      "United States"

    • match
      Jenis: string | null

      jenis padanan kata kunci
      medan pilihan
      boleh mengambil nilai berikut:
      aggregate mengembalikan data merentas semua jenis padanan;
      broad mengembalikan data untuk semua pertanyaan pengguna yang mengandungi kata kunci yang ditentukan dengan susunan perkataan yang berbeza-beza;
      phrase mengembalikan data untuk semua pertanyaan pengguna yang mengandungi kata kunci yang ditentukan dengan susunan perkataan yang sama;
      exact mengembalikan data untuk pertanyaan pengguna yang sepadan dengan kata kunci yang ditentukan;Nota: jenis padanan aggregate digunakan secara lalai

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

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceLiveTaskInfo
        • 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

          tatasusunan hasil

          • keyword
            Jenis: string | null

            kata kunci dalam array POST

          • keyword_kpi
            Jenis: object | null · Response36Afe1097B20_KeywordKpi

            objek yang mengandungi metrik kata kunci
            jika tiada data, nilainya ialah null

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

              data kata kunci yang diagregat untuk peranti desktop
              jika tiada data, nilainya ialah null

              • ad_position
                Jenis: string | null

                mewakili kedudukan iklan berkaitan dalam SERP
                boleh mengambil nilai berikut:
                FirstPage1: Iklan pertama yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage2: Iklan kedua yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage3: Iklan ketiga yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage4: Iklan keempat yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage5: Iklan kelima yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage6: Iklan keenam yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage7: Iklan ketujuh yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage8: Iklan kelapan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage9: Iklan kesembilan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage10: Iklan kesepuluh yang muncul di sebelah kanan halaman hasil carian pertama
                MainLine1: Iklan pertama yang muncul di bahagian atas halaman hasil carian
                MainLine2: Iklan kedua yang muncul di bahagian atas halaman hasil carian
                MainLine3: Iklan ketiga yang muncul di bahagian atas halaman hasil carian
                MainLine4: Iklan keempat yang muncul di bahagian atas halaman hasil carian

              • average_bid
                Jenis: number | null Format: double

                purata bidaan kata kunci

              • average_cpc
                Jenis: number | null Format: double

                purata kos setiap klik, USD
                dikira dengan membahagikan kos semua klik dengan bilangan klik

              • clicks
                Jenis: integer | null

                klik iklan
                bilangan klik yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • ctr
                Jenis: number | null Format: double

                kadar klik-lalu sebagai peratusan
                dikira dengan membahagikan bilangan klik dengan bilangan tayangan dan mendarabkan hasilnya dengan 100

              • impressions
                Jenis: integer | null

                tayangan iklan
                bilangan tayangan yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • total_cost
                Jenis: number | null Format: int64

                jumlah kos iklan, USD
                kos penggunaan kata kunci dan jenis padanan yang ditentukan sepanjang bulan lalu

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

              data kata kunci yang diagregat untuk peranti mudah alih
              jika tiada data, nilainya ialah null

              • ad_position
                Jenis: string | null

                mewakili kedudukan iklan berkaitan dalam SERP
                boleh mengambil nilai berikut:
                FirstPage1: Iklan pertama yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage2: Iklan kedua yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage3: Iklan ketiga yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage4: Iklan keempat yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage5: Iklan kelima yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage6: Iklan keenam yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage7: Iklan ketujuh yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage8: Iklan kelapan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage9: Iklan kesembilan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage10: Iklan kesepuluh yang muncul di sebelah kanan halaman hasil carian pertama
                MainLine1: Iklan pertama yang muncul di bahagian atas halaman hasil carian
                MainLine2: Iklan kedua yang muncul di bahagian atas halaman hasil carian
                MainLine3: Iklan ketiga yang muncul di bahagian atas halaman hasil carian
                MainLine4: Iklan keempat yang muncul di bahagian atas halaman hasil carian

              • average_bid
                Jenis: number | null Format: double

                purata bidaan kata kunci

              • average_cpc
                Jenis: number | null Format: double

                purata kos setiap klik, USD
                dikira dengan membahagikan kos semua klik dengan bilangan klik

              • clicks
                Jenis: integer | null

                klik iklan
                bilangan klik yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • ctr
                Jenis: number | null Format: double

                kadar klik-lalu sebagai peratusan
                dikira dengan membahagikan bilangan klik dengan bilangan tayangan dan mendarabkan hasilnya dengan 100

              • impressions
                Jenis: integer | null

                tayangan iklan
                bilangan tayangan yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • total_cost
                Jenis: number | null Format: int64

                jumlah kos iklan, USD
                kos penggunaan kata kunci dan jenis padanan yang ditentukan sepanjang bulan lalu

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

              data kata kunci yang diagregat untuk peranti tablet
              jika tiada data, nilainya ialah null

              • ad_position
                Jenis: string | null

                mewakili kedudukan iklan berkaitan dalam SERP
                boleh mengambil nilai berikut:
                FirstPage1: Iklan pertama yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage2: Iklan kedua yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage3: Iklan ketiga yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage4: Iklan keempat yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage5: Iklan kelima yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage6: Iklan keenam yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage7: Iklan ketujuh yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage8: Iklan kelapan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage9: Iklan kesembilan yang muncul di sebelah kanan halaman hasil carian pertama
                FirstPage10: Iklan kesepuluh yang muncul di sebelah kanan halaman hasil carian pertama
                MainLine1: Iklan pertama yang muncul di bahagian atas halaman hasil carian
                MainLine2: Iklan kedua yang muncul di bahagian atas halaman hasil carian
                MainLine3: Iklan ketiga yang muncul di bahagian atas halaman hasil carian
                MainLine4: Iklan keempat yang muncul di bahagian atas halaman hasil carian

              • average_bid
                Jenis: number | null Format: double

                purata bidaan kata kunci

              • average_cpc
                Jenis: number | null Format: double

                purata kos setiap klik, USD
                dikira dengan membahagikan kos semua klik dengan bilangan klik

              • clicks
                Jenis: integer | null

                klik iklan
                bilangan klik yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • ctr
                Jenis: number | null Format: double

                kadar klik-lalu sebagai peratusan
                dikira dengan membahagikan bilangan klik dengan bilangan tayangan dan mendarabkan hasilnya dengan 100

              • impressions
                Jenis: integer | null

                tayangan iklan
                bilangan tayangan yang dijana oleh kata kunci dan jenis padanan sepanjang bulan lalu

              • total_cost
                Jenis: number | null Format: int64

                jumlah kos iklan, USD
                kos penggunaan kata kunci dan jenis padanan yang ditentukan sepanjang bulan lalu

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST
            jika tiada data, nilainya ialah_nulln

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST
            jika tiada data, nilainya ialah_nulln

          • month
            Jenis: integer | null

            menunjukkan bulan data disediakan
            contoh:
            10

          • year
            Jenis: integer | null

            menunjukkan tahun data disediakan
            contoh:
            2020

        • 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/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 berjaya

Setting Live ‘Bing Keyword Performance’ Tasks