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
Pelayan: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 dimasukkan ke baris gilir mengikut id: unjuran tayangan, klik, kos dan kedudukan purata untuk bidaan yang anda tentukan. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Berbeza daripada endpoint volum, ini ialah unjuran, bukan ukuran - angka berubah mengikut bid dan match.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.012.
  • 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.

Parameter Laluan
  • id
    Jenis: string
    wajib

    pengecam tugas
    pengecam tugas unik dalam sistem kami dalam format UUID
    anda boleh menggunakannya dalam tempoh 30 hari untuk meminta hasil tugas pada bila-bila masa

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

          • average_cpc
            Jenis: number | null Format: double

            nilai purata kos setiap klik
            mewakili kos setiap klik (USD) yang dianggarkan untuk kata kunci berdasarkan tempoh masa dan data sejarah yang ditentukan;
            jika tiada data, nilainya ialah null

          • bid
            Jenis: number | null

            bidaan tersuai maksimum
            bidaan yang anda tentukan semasa menyediakan tugasan
            mewakili harga yang sanggup anda bayar untuk sesuatu iklan
            semakin tinggi nilai yang anda tentukan, semakin tinggi metrik dan kos yang anda terima dalam respons
            ketahui lebih lanjut dalam artikel Pusat Bantuan ini

          • clicks
            Jenis: number | null

            bilangan klik pada iklan
            bilangan klik yang dijangka diperoleh iklan dalam tempoh masa yang ditentukan
            jika tiada data, nilainya ialah null

          • cost
            Jenis: number | null

            caj untuk iklan
            amaun yang akan dicaj untuk menjalankan iklan dalam tempoh masa yang ditentukan
            jika tiada data, nilainya ialah null

          • ctr
            Jenis: number | null Format: double

            kadar klik-lalu (CTR) iklan yang dijangka
            bilangan klik yang dijangka diterima iklan dibahagikan dengan bilangan tayangan iklan;
            Nota: parameter telah ditamatkan, nilainya sentiasa null

          • date_interval
            Jenis: string | null

            selang tarikh ramalan dalam array POST

          • impressions
            Jenis: integer | null

            bilangan tayangan iklan yang dijangka
            bilangan tayangan yang dijangka diperoleh iklan dalam tempoh masa yang ditentukan
            Nota: parameter telah ditamatkan, nilainya sentiasa null

          • keyword
            Jenis: string | null

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

          • 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

          • match
            Jenis: string | null

            jenis padanan kata kunci
            boleh mengambil nilai berikut: exact, broad, phrase

          • search_partners
            Jenis: boolean | null

            sertakan rakan carian Google
            nilainya sentiasa false

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

Get ‘Ads Traffic By Keywords’ Results by id