v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Search Volume 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

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

Dapatkan Hasil Search Volume mengikut id

Mengambil tugas volum carian Google Ads yang dimasukkan ke baris gilir mengikut id. Bentuk sama seperti post_dataforseo_keywords_gads_search_volume_live. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200.

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

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

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'

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

Dapatkan Hasil Search Volume mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Search Volume mengikut id

Rujukan harga