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

Menetapkan Tugas Langsung ‘Google Ads Search Volume’

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

Menetapkan Tugas Langsung ‘Google Ads Search Volume’

​

Volum carian Google Ads untuk senarai keywords. Memulangkan 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 sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan 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.

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)[]
    • date_from
      Jenis: string | null

      tarikh mula julat masa
      medan pilihan
      format tarikh: "yyyy-mm-dd"
      nilai minimum: 4 tahun daripada tarikh semasa
      secara lalai, data dipulangkan untuk 12 bulan lepas;
      Nota: tarikh yang ditentukan tidak boleh lebih besar daripada tarikh dalam date_to dan/atau tarikh semalam;jika endpoint Status memulangkan false dalam medan actual_data, date_from boleh ditetapkan kepada bulan sebelum bulan lalu dan sebelumnya;
      jika endpoint Status memulangkan true dalam medan actual_data, date_from boleh ditetapkan kepada bulan lalu dan sebelumnya

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      Nota: tarikh yang ditentukan tidak boleh lebih besar daripada bulan lepas, Google Ads tidak memulangkan data bagi bulan semasa;
      jika anda tidak menentukan medan ini, tarikh semalam akan digunakan secara lalai
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2022-11-30"

    • include_adult_keywords
      Jenis: boolean | null

      sertakan kata kunci berkaitan kandungan dewasa
      medan pilihan
      jika ditetapkan kepada true, kata kunci dewasa akan disertakan dalam respons
      nilai lalai: false
      ambil perhatian bahawa API mungkin tidak memulangkan data untuk kata kunci tersebut kerana sekatan Google Ads

    • keywords
      Jenis: array string[]

      kata kunci
      medan wajib
      Bilangan maksimum kata kunci yang boleh anda tentukan: 1000
      Bilangan maksimum aksara bagi setiap kata kunci: 80
      Bilangan maksimum perkataan bagi setiap frasa kata kunci: 10
      kata kunci yang anda tentukan akan ditukar kepada format huruf kecil
      Nota #1: Google Ads mungkin tidak memulangkan data untuk kumpulan kata kunci tertentu;
      Nota #2: Google Ads memberikan nilai volum carian gabungan untuk kumpulan kata kunci yang serupa
      untuk mendapatkan volum carian bagi kata kunci yang serupa, kami mengesyorkan menghantar kata kunci tersebut dalam permintaan berasingan;
      Nota #3: Google Ads tidak membenarkan penggunaan simbol dan aksara tertentu (contohnya: simbol UTF, emoji), jadi anda tidak boleh menggunakannya semasa menetapkan tugas;
      untuk mengetahui lebih lanjut tentang simbol dan aksara yang boleh digunakan, sila rujuk artikel ini

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

    • language_code
      Jenis: string | null

      kod bahasa enjin carian
      medan pilihan
      anda boleh menerima senarai bahasa enjin carian yang tersedia dengan language_codenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      contoh:
      en

    • language_name
      Jenis: string | null

      nama penuh bahasa enjin carian
      medan pilihan
      anda boleh menerima senarai bahasa enjin carian yang tersedia dengan language_namenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      contoh:
      English

    • location_code
      Jenis: integer | null

      kod lokasi enjin carian
      medan pilihan
      jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate;
      anda boleh menerima senarai lokasi enjin carian yang tersedia dengan location_codenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      contoh:
      2840

    • location_coordinate
      Jenis: string | null

      koordinat GPS sesuatu lokasi
      medan pilihan
      jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;
      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 diberikan untuk negara tempat koordinat yang ditentukan berada;
      contoh:
      52.6178549,-155.352142

    • location_name
      Jenis: string | null

      nama penuh lokasi enjin carian
      medan pilihan
      jika anda tidak menentukan lokasi, anda akan menerima hasil seluruh dunia, iaitu untuk semua lokasi yang tersedia;
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
      anda boleh menerima senarai lokasi enjin carian yang tersedia dengan location_namenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      contoh:
      London,England,United Kingdom

    • search_partners
      Jenis: boolean | null

      sertakan rakan kongsi carian Google
      medan pilihan
      jika anda menentukan true, hasil akan dihantar untuk rangkaian milik, dikendalikan dan sindikasi merentas Google dan laman rakan kongsi yang menghoskan carian Google;
      nilai lalai: false - hasil dipulangkan untuk laman carian Google

    • sort_by
      Jenis: string | null

      parameter susunan hasil
      medan pilihan
      gunakan parameter ini untuk menyusun hasil mengikut relevance, search_volume, competition_index, low_top_of_page_bid atau high_top_of_page_bid dalam susunan menurun
      nilai lalai: relevance

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

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

          • competition
            Jenis: string | null

            persaingan
            mewakili jumlah persaingan relatif yang berkaitan dengan kata kunci tertentu dalam SERP berbayar sahaja;
            nilai ini berdasarkan data Google Ads dan boleh mengambil nilai berikut: HIGH, MEDIUM, LOW;
            jika tiada data nilainya ialah null;
            pelajari lebih lanjut tentang metrik ini dalam artikel Pusat Bantuan ini

          • competition_index
            Jenis: integer | null

            persaingan
            mewakili jumlah persaingan relatif yang berkaitan dengan kata kunci tertentu dalam SERP berbayar sahaja;
            nilai ini berdasarkan data Google Ads dan boleh berada antara 0 dan 100 (termasuk kedua-dua hujung);
            jika tiada data nilainya ialah null;
            pelajari lebih lanjut tentang metrik ini dalam artikel Pusat Bantuan ini

          • cpc
            Jenis: number | null

            kos setiap klik
            menunjukkan amaun yang dibayar (USD) untuk setiap klik pada iklan yang dipaparkan bagi kata kunci tertentu

          • high_top_of_page_bid
            Jenis: number | null

            bidaan maksimum untuk iklan dipaparkan di bahagian atas halaman pertama
            menunjukkan nilai yang lebih besar daripada kira-kira 80% bidaan terendah yang menyebabkan iklan dipaparkan (berdasarkan statistik Google Ads untuk pengiklan);
            nilai mungkin berbeza bergantung pada lokasi yang ditentukan dalam permintaan POST

          • keyword
            Jenis: string | null

            kata kunci
            kata kunci dipulangkan dengan %## yang dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

          • 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

          • low_top_of_page_bid
            Jenis: number | null

            bidaan minimum untuk iklan dipaparkan di bahagian atas halaman pertama
            menunjukkan nilai yang lebih besar daripada kira-kira 20% bidaan terendah yang menyebabkan iklan dipaparkan (berdasarkan statistik Google Ads untuk pengiklan);
            nilai mungkin berbeza bergantung pada lokasi yang ditentukan dalam permintaan POST

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

            carian bulanan
            mewakili anggaran bilangan carian bagi idea kata kunci ini (secara lalai untuk dua belas bulan lalu), disasarkan kepada lokasi geografi yang ditentukan;
            jika tiada data maka nilainya ialah null

            • month
              Jenis: integer | null

              bulan

            • search_volume
              Jenis: integer | null

              kadar purata volum carian bulanan

            • year
              Jenis: integer | null

              tahun

          • search_partners
            Jenis: boolean | null

            menunjukkan sama ada data daripada rangkaian rakan disertakan dalam respons

          • search_volume
            Jenis: integer | null Format: int64

            kadar purata volum carian bulanan;
            mewakili sama ada anggaran bilangan carian bagi idea kata kunci tertentu di google.com atau google.com dan rakan, bergantung pada penyasaran pengguna;
            jika tiada data maka nilainya ialah null

          • spell
            Jenis: string | null

            ejaan kata kunci yang betul
            Nota: jika kata kunci dalam array POST kelihatan salah eja, data akan dipulangkan untuk kata kunci yang dieja dengan betul;
            kami menggunakan fungsi Google Ads API untuk menyemak dan mengesahkan ejaan kata kunci, ketahui lebih lanjut melalui pautan ini

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

Setting Live ‘Google Ads Search Volume’ Tasks