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

Membuat Tugas ‘DataForSEO Search Volume’ 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 ‘DataForSEO Search Volume’ Langsung

​

Volume pencarian yang diturunkan dari panel clickstream alih-alih platform iklan, untuk daftar keywords. use_clickstream mengaktifkan campurannya. Mengembalikan location_code, language_code, use_clickstream, items_count, dan items. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Volume clickstream sering tidak sepakat dengan post_dataforseo_keywords_gads_search_volume_live, dan itulah intinya: yang satu mengukur apa yang ditampilkan kepada pengiklan, yang lain apa yang dilakukan orang.

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)[]
    • keywords
      Tipe: array string[]

      kata kunci target
      field wajib
      pengodean UTF-8
      jumlah maksimum kata kunci yang dapat Anda tentukan dalam array ini: 1000
      kata kunci akan diubah ke format huruf kecil

      Catatan: simbol dan karakter tertentu (misalnya, simbol UTF, emoji) tidak diizinkan
      untuk mempelajari lebih lanjut tentang simbol dan karakter yang dapat digunakan, silakan lihat artikel ini

      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 tidak menentukan language_name
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa mesin pencari
      field wajib jika tidak menentukan language_code
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika tidak menentukan location_name
      jika Anda menggunakan field ini, Anda dapat memperoleh daftar lokasi yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      contoh:
      2826

    • location_name
      Tipe: string

      nama lengkap lokasi mesin pencari
      field wajib jika tidak menentukan location_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      contoh:
      United Kingdom

    • 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

    • use_clickstream
      Tipe: boolean | null

      gunakan data clickstream untuk menyediakan hasil
      field opsional
      jika disetel ke true, Anda akan mendapatkan nilai volume pencarian DataForSEO berdasarkan data clickstream;
      jika disetel ke false, data volume pencarian Bing akan digunakan untuk menghitung volume pencarian DataForSEO;
      nilai default: true;
      Catatan: volume pencarian Bing tersedia untuk lokasi yang disediakan di endpoint Bing Search Volume History Locations dan Bing Ads Locations; nilai volume pencarian untuk lokasi lain dihitung berdasarkan data clickstream meskipun Anda menyetel parameter ini ke false

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo
    • 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_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo
        • 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

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

            array kata kunci
            berisi kata kunci dan tingkat volume pencariannya

            • keyword
              Tipe: string | null

              kata kunci yang diberikan dalam array POST

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

              tingkat volume pencarian bulanan
              array objek dengan tingkat volume pencarian pada bulan tertentu dalam setahun

              • month
                Tipe: integer | null

                bulan

              • search_volume
                Tipe: integer | null

                tingkat volume pencarian rata-rata bulanan

              • year
                Tipe: integer | null

                tahun

            • search_volume
              Tipe: integer | null Format: int64

              volume pencarian saat ini dari sebuah kata kunci

          • items_count
            Tipe: integer | null

            jumlah hasil yang dikembalikan dalam array items

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

            Catatan: jika kata kunci dalam array POST tampaknya salah eja, data akan dikembalikan untuk kata kunci yang ejaannya benar;
            kami menggunakan fungsionalitas Google Ads API untuk memeriksa dan memvalidasi ejaan kata kunci, pelajari lebih lanjut di tautan ini

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST
            jika tidak ada data, nilainya adalah null

          • use_clickstream
            Tipe: boolean | null

            menunjukkan apakah parameter use_clickstream aktif
            nilai yang mungkin: true, false

        • 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/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Setting Live ‘DataForSEO Search Volume’ Tasks