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

Dapatkan Hasil ‘Ads Traffic By Keywords’ mengikut id

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

Dapatkan Hasil ‘Ads Traffic By Keywords’ mengikut id

​

Mengambil ramalan trafik Google Ads yang diantrekan mengikut id: unjuran tayangan, klik, kos, dan kedudukan purata untuk bidaan yang Anda tentukan. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Berbeza daripada endpoint volum, ini ialah unjuran, bukan ukuran - angka berubah mengikut bid dan match.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.012.
  • 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.

Parameter Jalur
  • id
    Tipe: string
    wajib

    pengenal tugas
    pengenal tugas unik di sistem kami dalam format UUID
    Anda dapat menggunakannya dalam 30 hari untuk meminta hasil tugas kapan saja

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

          • average_cpc
            Tipe: number | null Format: double

            nilai biaya per klik rata-rata
            mewakili biaya per klik (USD) yang diperkirakan untuk kata kunci berdasarkan periode waktu dan data historis yang ditentukan;
            jika tidak ada data, nilainya adalah null

          • bid
            Tipe: number | null

            tawaran kustom maksimum
            tawaran yang Anda tentukan saat menyiapkan tugas
            mewakili harga yang bersedia Anda bayarkan untuk sebuah iklan
            semakin tinggi nilai yang Anda tentukan, semakin tinggi metrik dan biaya yang Anda terima dalam respons
            pelajari lebih lanjut di artikel Pusat Bantuan ini

          • clicks
            Tipe: number | null

            jumlah klik pada iklan
            jumlah klik yang diperkirakan akan diperoleh iklan dalam periode waktu tertentu
            jika tidak ada data, nilainya adalah null

          • cost
            Tipe: number | null

            biaya untuk iklan
            jumlah yang akan ditagihkan untuk menjalankan iklan dalam periode waktu tertentu
            jika tidak ada data, nilainya adalah null

          • ctr
            Tipe: number | null Format: double

            rasio klik-tayang (CTR) iklan yang diperkirakan
            jumlah klik yang diperkirakan diterima iklan dibagi jumlah tayangan iklan;
            Catatan: parameter sudah tidak digunakan, nilainya selalu null

          • date_interval
            Tipe: string | null

            interval tanggal perkiraan dalam array POST

          • impressions
            Tipe: integer | null

            perkiraan jumlah tayangan iklan
            jumlah tayangan yang diperkirakan diperoleh iklan dalam periode waktu tertentu
            Catatan: parameter sudah tidak digunakan, nilainya selalu null

          • keyword
            Tipe: string | null

            kata kunci dalam array POST
            metrik diberikan untuk semua kata kunci yang ditentukan dalam array POST

          • 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

          • match
            Tipe: string | null

            jenis kecocokan kata kunci
            dapat bernilai sebagai berikut: exact, broad, phrase

          • search_partners
            Tipe: boolean | null

            sertakan mitra penelusuran Google
            nilainya selalu 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 get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

Operasi berhasil

Get ‘Ads Traffic By Keywords’ Results by id