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

Menyetel Tugas Langsung ‘Google Ads Search Volume’

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

Menyetel Tugas Langsung ‘Google Ads Search Volume’

​

Volum carian Google Ads untuk senarai keywords. Mengembalikan keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc, dan monthly_searches, serta spell apabila Google membetulkan istilah tersebut. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini nombor volum carian klasik; untuk kekerapan orang bertanya kepada pembantu sebaliknya, gunakan post_dataforseo_ai_keyword_volume_live. Pasangan submit dan fetch endpoint ini melakukan kerja yang sama secara tak segerak, pada harga yang sama, untuk kelompok 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)[]
    • date_from
      Tipe: string | null

      tanggal mulai rentang waktu
      field opsional
      format tanggal: "yyyy-mm-dd"
      nilai minimum: 4 tahun dari tanggal saat ini
      secara default, data dikembalikan untuk 12 bulan terakhir;
      Catatan: tanggal yang ditentukan tidak boleh lebih besar dari tanggal di date_to dan/atau tanggal kemarin;jika endpoint Status mengembalikan false di field actual_data, date_from dapat diatur ke bulan sebelum bulan lalu dan sebelumnya;
      jika endpoint Status mengembalikan true di field actual_data, date_from dapat diatur ke bulan lalu dan sebelumnya

    • date_to
      Tipe: string | null

      tanggal akhir rentang waktu
      field opsional
      Catatan: tanggal yang ditentukan tidak boleh lebih besar dari bulan lalu, Google Ads tidak mengembalikan data pada bulan berjalan;
      jika Anda tidak menentukan field ini, tanggal kemarin akan digunakan secara default
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2022-11-30"

    • include_adult_keywords
      Tipe: boolean | null

      sertakan kata kunci terkait konten dewasa
      field opsional
      jika diatur ke true, kata kunci dewasa akan disertakan dalam respons
      nilai default: false
      perhatikan bahwa API mungkin tidak mengembalikan data untuk kata kunci tersebut karena pembatasan Google Ads

    • 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 Anda tentukan akan diubah ke format huruf kecil
      Catatan #1: Google Ads mungkin tidak mengembalikan data untuk kelompok kata kunci tertentu;
      Catatan #2: Google Ads memberikan nilai volume penelusuran gabungan untuk kelompok kata kunci serupa
      untuk memperoleh volume penelusuran bagi kata kunci serupa, kami menyarankan mengirimkan kata kunci tersebut dalam permintaan terpisah;
      Catatan #3: Google Ads tidak mengizinkan penggunaan simbol dan karakter tertentu (misalnya: simbol UTF, emoji), sehingga Anda tidak dapat menggunakannya saat menetapkan tugas;
      untuk mempelajari lebih lanjut simbol dan karakter yang dapat digunakan, silakan merujuk ke artikel ini

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

    • language_code
      Tipe: string | null

      kode bahasa mesin pencari
      field opsional
      Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      contoh:
      en

    • language_name
      Tipe: string | null

      nama lengkap bahasa mesin pencari
      field opsional
      Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      contoh:
      English

    • location_code
      Tipe: integer | null

      kode lokasi mesin pencari
      field opsional
      jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate;
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      contoh:
      2840

    • location_coordinate
      Tipe: string | null

      koordinat GPS suatu lokasi
      field opsional
      jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
      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 | null

      nama lengkap lokasi mesin pencari
      field opsional
      jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      contoh:
      London,England,United Kingdom

    • search_partners
      Tipe: boolean | null

      sertakan partner penelusuran Google
      field opsional
      jika Anda menentukan true, hasil akan dikirimkan untuk jaringan milik, yang dioperasikan, dan sindikasi di Google dan situs partner yang menyelenggarakan penelusuran Google;
      nilai default: false - hasil dikembalikan untuk situs penelusuran Google

    • sort_by
      Tipe: string | null

      parameter pengurutan hasil
      field opsional
      gunakan parameter ini untuk mengurutkan hasil berdasarkan relevance, search_volume, competition_index, low_top_of_page_bid, atau high_top_of_page_bid dalam urutan menurun
      nilai default: relevance

    • 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 array data pada respons

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

          • competition
            Tipe: string | null

            persaingan
            mewakili jumlah persaingan relatif yang terkait dengan kata kunci tertentu, hanya di SERP berbayar;
            nilai ini didasarkan pada data Google Ads dan dapat bernilai sebagai berikut: HIGH, MEDIUM, LOW;
            jika tidak ada data nilainya adalah null;
            pelajari lebih lanjut tentang metrik ini di artikel Pusat Bantuan ini

          • competition_index
            Tipe: integer | null

            persaingan
            mewakili jumlah persaingan relatif yang terkait dengan kata kunci tertentu, hanya di SERP berbayar;
            nilai ini didasarkan pada data Google Ads dan dapat berada antara 0 dan 100 (inklusif);
            jika tidak ada data nilainya adalah null;
            pelajari lebih lanjut tentang metrik ini di artikel Pusat Bantuan ini

          • cpc
            Tipe: number | null

            biaya per klik
            menunjukkan jumlah yang dibayarkan (USD) untuk setiap klik pada iklan yang ditampilkan untuk kata kunci tertentu

          • high_top_of_page_bid
            Tipe: number | null

            tawaran maksimum agar iklan ditampilkan di bagian atas halaman pertama
            menunjukkan nilai yang lebih besar dari sekitar 80% tawaran terendah yang membuat iklan ditampilkan (berdasarkan statistik Google Ads untuk pengiklan);
            nilainya dapat berbeda tergantung lokasi yang ditentukan dalam permintaan POST

          • keyword
            Tipe: string | null

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

          • 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

          • low_top_of_page_bid
            Tipe: number | null

            tawaran minimum agar iklan ditampilkan di bagian atas halaman pertama
            menunjukkan nilai yang lebih besar dari sekitar 20% tawaran terendah yang membuat iklan ditampilkan (berdasarkan statistik Google Ads untuk pengiklan);
            nilainya dapat berbeda tergantung lokasi yang ditentukan dalam permintaan POST

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

            pencarian bulanan
            mewakili perkiraan jumlah pencarian untuk ide kata kunci ini (secara default selama dua belas bulan terakhir), yang ditargetkan ke lokasi geografis tertentu;
            jika tidak ada data maka nilainya adalah null

            • month
              Tipe: integer | null

              bulan

            • search_volume
              Tipe: integer | null

              tingkat volume pencarian rata-rata bulanan

            • year
              Tipe: integer | null

              tahun

          • search_partners
            Tipe: boolean | null

            menunjukkan apakah data dari jaringan mitra disertakan dalam respons

          • search_volume
            Tipe: integer | null Format: int64

            tingkat volume pencarian rata-rata bulanan;
            mewakili perkiraan jumlah pencarian untuk ide kata kunci tertentu di google.com atau google.com dan mitra, tergantung pada penargetan pengguna;
            jika tidak ada data maka nilainya adalah null

          • spell
            Tipe: string | null

            ejaan kata kunci yang benar
            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

        • 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/google_ads/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

{
  "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,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Setting Live ‘Google Ads Search Volume’ Tasks