v0.2.0-beta

OpenAPI 3.1.0

Mencipta Tugas ‘DataForSEO Search Volume’ Langsung

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

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

Mencipta Tugas ‘DataForSEO Search Volume’ Langsung

Volum carian yang diterbitkan daripada panel clickstream dan bukan platform iklan, bagi senarai keywords. use_clickstream menukar campuran. Memulangkan location_code, language_code, use_clickstream, items_count dan items. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Volum clickstream sering tidak sependapat dengan post_dataforseo_keywords_gads_search_volume_live, dan itulah maksudnya: satu mengukur apa yang ditunjukkan kepada pengiklan, satu lagi apa yang orang lakukan.

Rujukan harga

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

Badan

application/json

Jenis: array (object | null)[]
- keywords
  Jenis: array string[]
  
  kata kunci sasaran
  medan wajib
  pengekodan UTF-8
  bilangan maksimum kata kunci yang boleh anda tentukan dalam tatasusunan ini: 1000
  kata kunci akan ditukar kepada format huruf kecil
  
  Nota: simbol dan aksara tertentu (contohnya, simbol UTF, emoji) tidak dibenarkan
  untuk mengetahui lebih lanjut tentang simbol dan aksara yang boleh digunakan, sila rujuk artikel ini
  
  ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
- language_code
  Jenis: string
  
  kod bahasa enjin carian
  medan wajib jika tidak menentukan language_name
  anda boleh mendapatkan senarai bahasa yang tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  en
- language_name
  Jenis: string
  
  nama penuh bahasa enjin carian
  medan wajib jika tidak menentukan language_code
  anda boleh mendapatkan senarai bahasa yang tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  English
- location_code
  Jenis: integer
  
  kod lokasi enjin carian
  medan wajib jika tidak menentukan location_name
  jika anda menggunakan medan ini, anda boleh mendapatkan senarai lokasi yang tersedia bersama location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  2826
- location_name
  Jenis: string
  
  nama penuh lokasi enjin carian
  medan wajib jika tidak menentukan location_code
  anda boleh mendapatkan senarai lokasi yang tersedia bersama location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
  contoh:
  United Kingdom
- tag
  Jenis: string | null
  
  pengecam tugas yang ditentukan pengguna
  medan pilihan
  had aksara ialah 255
  anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
  anda akan menemui nilai tag yang ditentukan dalam objek data respons
- use_clickstream
  Jenis: boolean | null
  
  gunakan data clickstream untuk menyediakan hasil
  medan pilihan
  jika ditetapkan kepada true, anda akan mendapat nilai volum carian DataForSEO berdasarkan data clickstream;
  jika ditetapkan kepada false, data volum carian Bing akan digunakan untuk mengira volum carian DataForSEO;
  nilai lalai: true;
  Nota: volum carian Bing tersedia untuk lokasi yang disediakan dalam endpoint Bing Search Volume History Locations dan Bing Ads Locations; nilai volum carian untuk mana-mana lokasi lain dikira berdasarkan data clickstream walaupun anda menetapkan parameter ini kepada false

Respons

200
Jenis: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo
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_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo
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

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

array kata kunci
mengandungi kata kunci dan kadar volum cariannya

keyword
Jenis: string | null

kata kunci yang diberikan dalam array POST

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

kadar volum carian bulanan
array objek dengan kadar volum carian pada bulan tertentu dalam setahun

month
Jenis: integer | null

bulan

search_volume
Jenis: integer | null

kadar purata volum carian bulanan

year
Jenis: integer | null

tahun

search_volume
Jenis: integer | null Format: int64

kadar volum carian semasa bagi sesuatu kata kunci

items_count
Jenis: integer | null

bilangan hasil yang dipulangkan dalam array items

language_code
Jenis: string | null

kod bahasa dalam array POST

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

location_code
Jenis: integer | null

kod lokasi dalam array POST
jika tiada data, nilainya ialah null

use_clickstream
Jenis: boolean | null

menunjukkan sama ada parameter use_clickstream aktif
nilai yang mungkin: true, 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

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

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

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

Operasi berjaya

Mencipta Tugas ‘DataForSEO Search Volume’ Langsung

PengesahanRequired

DataForSEO

Mencipta Tugas ‘DataForSEO Search Volume’ Langsung

Rujukan harga