Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Mencipta Tugas ‘Search Volume’

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

Mencipta Tugas ‘Search Volume’

​

Membariskan tugas volum carian Bing, memulangkan id tugas. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Ambil dengan get_dataforseo_keywords_bing_search_volume_fetch.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.06.
  • 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)[]
    • date_from
      Jenis: string | null

      tarikh mula julat masa
      medan pilihan
      jika anda tidak menetapkan medan ini, data akan disediakan untuk 12 bulan lepas
      nilai minimum: 24 bulan dari tarikh hari ini
      jika endpoint Status mengembalikan false dalam medan actual_data, date_from boleh ditetapkan kepada bulan sebelum bulan lalu dan sebelumnya;
      jika endpoint Status mengembalikan true dalam medan actual_data, date_from boleh ditetapkan kepada bulan lalu dan sebelumnya;
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2020-01-01"

      Nota: kami tidak mengesyorkan penggunaan julat masa tersuai untuk tarikh tahun lepas

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      jika anda tidak menetapkan medan ini, data akan disediakan untuk 12 bulan lepas;
      nilai minimum: dua tahun ke belakang dari tarikh hari ini;
      nilai maksimum: satu bulan dari tarikh hari ini;
      nota: kami tidak mengesyorkan penggunaan julat masa tersuai untuk tarikh tahun lepas;
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2020-03-15"

      Nota: kami tidak mengesyorkan penggunaan julat masa tersuai untuk tarikh tahun lepas

    • device
      Jenis: string | null

      jenis peranti
      medan pilihan
      tentukan medan ini jika anda ingin mendapatkan data untuk jenis peranti tertentu. nilai yang mungkin: all, mobile, desktop, tablet
      nilai lalai: all

    • keywords
      Jenis: array string[]

      kata kunci
      medan wajib
      Bilangan maksimum kata kunci yang boleh anda tentukan: 1000
      Bilangan maksimum aksara untuk setiap kata kunci: 100
      kata kunci yang ditentukan akan ditukar kepada huruf kecil, data akan disediakan dalam tatasusunan berasingan

      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 anda tidak menentukan language_name
      jika anda menggunakan medan ini, anda tidak perlu menentukan language_name
      bahasa yang disokong:
      en, fr, de

    • language_name
      Jenis: string

      nama penuh bahasa enjin carian
      medan wajib jika anda tidak menentukan language_code
      jika anda menggunakan medan ini, anda tidak perlu menentukan language_code
      bahasa yang disokong:
      English, French, German

    • location_code
      Jenis: integer

      kod lokasi enjin carian
      medan wajib jika anda tidak menentukan location_name atau location_coordinate
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate
      anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/locations
      contoh:
      2840

    • location_coordinate
      Jenis: string

      koordinat GPS sesuatu lokasi
      medan wajib jika anda tidak menentukan location_name atau location_code
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code
      parameter location_coordinate hendaklah ditentukan dalam format "latitude,longitude"
      data akan disediakan untuk negara milik koordinat yang ditentukan
      contoh:
      52.6178549,-155.352142

    • location_name
      Jenis: string

      nama penuh lokasi enjin carian
      medan wajib jika anda tidak menentukan location_code atau location_coordinate
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate
      anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/bing/locations
      contoh:
      London,England,United Kingdom

    • pingback_url
      Jenis: string | null

      URL pemberitahuan tugas yang selesai
      medan pilihan
      apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
      anda boleh menggunakan rentetan '$id' sebagai pemboleh ubah $id dan '$tag' sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Nota: aksara khas dalam pingback_url akan di-urlencode;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • postback_url
      Jenis: string | null

      URL untuk menghantar hasil tugas
      medan pilihan
      sebaik sahaja tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan
      anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
      contoh:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Nota: aksara khas dalam postback_url akan dikodkan URL;
      iaitu, aksara # akan dikodkan menjadi %23

      ketahui lebih lanjut di Pusat Bantuan kami

    • search_partners
      Jenis: boolean | null

      jenis rakan kongsi carian Bing
      medan pilihan
      jika anda menentukan true, hasil akan dihantar untuk rangkaian milik, dikendalikan dan disindiket merentas Bing, Yahoo, AOL dan laman rakan kongsi yang menghos carian Bing, AOL dan Yahoo.
      nilai lalai: false - hasil dikembalikan untuk rangkaian carian Bing, AOL dan Yahoo

    • sort_by
      Jenis: string | null

      parameter isihan hasil
      medan pilihan
      Gunakan parameter ini untuk mengisih hasil mengikut search_volume, cpc, competition atau relevance dalam susunan menurun
      nilai lalai: relevance

    • 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

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

          tatasusunan hasil
          dalam kes ini, nilainya akan menjadi null

        • 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 post/v1/beta/dataforseo/keywords_data/bing/search_volume/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_name": "English",
    "keywords": [
      "average page rpm adsense",
      "adsense blank ads how long",
      "leads and prospects"
    ]
  }
]'

{
  "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": null
    }
  ]
}

Operasi berjaya

Setting ‘Search Volume’ Tasks