v0.2.0-beta

OpenAPI 3.1.0

Ambil Hasil Search Volume berdasarkan 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

get/v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/{id}

Ambil Hasil Search Volume berdasarkan id

Mengambil tugas volum carian Google Ads yang diantrekan mengikut id. Bentuk sama seperti post_dataforseo_keywords_gads_search_volume_live. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

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_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo
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_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo
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

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

get/v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tampilkan Skema

{
  "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

Ambil Hasil Search Volume berdasarkan id

AutentikasiRequired

DataForSEO

Ambil Hasil Search Volume berdasarkan id

Referensi harga