v0.2.0-beta

OpenAPI 3.1.0

Membuat Tugas ‘Bulk Clickstream Search Volume’ Langsung

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

post/v1/beta/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live

Membuat Tugas ‘Bulk Clickstream Search Volume’ Langsung

Volume pencarian clickstream untuk banyak keywords dalam satu panggilan, tanpa dimensi bahasa. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Varian per kata kunci dengan bahasa adalah post_dataforseo_keywords_clickstream_search_volume_live. Karena harganya per panggilan dan bukan per kata kunci, inilah yang dipakai untuk sebuah daftar.

Referensi harga

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

Isi

application/json

Tipe: array (object | null)[]
- keywords
  Tipe: array string[]
  
  kata kunci target
  field wajib
  pengodean UTF-8
  jumlah maksimum kata kunci yang dapat Anda tentukan dalam array ini: 1000;
  setiap kata kunci harus memiliki panjang minimal 3 karakter;
  kata kunci akan diubah ke format huruf kecil;
  Catatan: simbol dan karakter tertentu (misalnya, simbol UTF, emoji) tidak diizinkan
  untuk mempelajari lebih lanjut tentang simbol dan karakter yang dapat digunakan, silakan lihat artikel ini
  
  pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini
- location_code
  Tipe: integer
  
  kode lokasi
  field wajib jika Anda tidak menentukan location_name
  Catatan: Anda harus menentukan location_name atau location_code
  Anda dapat memperoleh daftar lokasi yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  2840
- location_name
  Tipe: string
  
  nama lengkap lokasi
  field wajib jika Anda tidak menentukan location_code
  Catatan: Anda harus menentukan location_name atau location_code
  Anda dapat memperoleh daftar lokasi yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  United Kingdom
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  field opsional
  batas karakter adalah 255
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons

200
Tipe: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo
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_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo
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

items
Tipe: array (object | null)[] | null

berisi kata kunci dan data terkait

keyword
Tipe: string | null

kata kunci yang diberikan dalam array POST

monthly_searches
Tipe: array (object | null)[] | null

tingkat volume pencarian bulanan
array objek dengan tingkat volume pencarian pada bulan tertentu dalam setahun

month
Tipe: integer | null

bulan

search_volume
Tipe: integer | null

tingkat volume pencarian rata-rata bulanan

year
Tipe: integer | null

tahun

search_volume
Tipe: integer | null Format: int64

volume pencarian saat ini dari sebuah kata kunci

items_count
Tipe: integer | null Format: int64

jumlah hasil yang dikembalikan dalam array items

location_code
Tipe: integer | null

kode lokasi dalam array POST

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

post/v1/beta/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

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": [
        {
          "location_code": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Membuat Tugas ‘Bulk Clickstream Search Volume’ Langsung

AutentikasiRequired

DataForSEO

Membuat Tugas ‘Bulk Clickstream Search Volume’ Langsung

Referensi harga