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

Ikhtisar Kata Kunci

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

Ikhtisar Kata Kunci

​

Semua yang diketahui Labs tentang daftar keywords dalam satu panggilan: volume, kesulitan, niat, persaingan, dan fitur SERP yang dipicunya. Mengembalikan se_type, location_code, language_code, items_count, dan items. Endpoint ini tidak menerima parameter batas, tetapi ditagih per panggilan, bukan per item, jadi kirim seluruh daftar sekaligus. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Mulai di sini jika Anda sudah memiliki kata kunci; post_dataforseo_labs_google_keyword_ideas_live adalah tujuan saat Anda membutuhkan lebih banyak.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,0254.
  • Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • include_clickstream_data
      Tipe: boolean | null

      menyertakan atau mengecualikan data dari metrik berbasis clickstream dalam hasil
      field opsional
      jika parameter disetel ke true, Anda akan menerima field clickstream_keyword_info, keyword_info_normalized_with_clickstream, dan keyword_info_normalized_with_bing dalam respons
      nilai default: false
      dengan parameter ini diaktifkan, Anda akan dikenakan biaya dua kali lipat untuk permintaan tersebut

      pelajari lebih lanjut tentang cara metrik berbasis clickstream dihitung di artikel pusat bantuan ini

    • include_serp_info
      Tipe: boolean | null

      sertakan data dari SERP untuk setiap kata kunci
      field opsional
      jika disetel ke true, kami akan mengembalikan array serp_info yang berisi data SERP (jumlah hasil pencarian, URL relevan, dan fitur SERP) untuk setiap kata kunci dalam respons
      nilai default: false

    • keywords
      Tipe: array string[]

      kata kunci
      field wajib
      Jumlah maksimum kata kunci yang dapat Anda tentukan: 700
      Jumlah maksimum karakter untuk setiap kata kunci: 80
      Jumlah maksimum kata untuk setiap frasa kata kunci: 10
      kata kunci yang ditentukan akan diubah ke format huruf kecil, data akan disediakan dalam array terpisah

      perhatikan bahwa jika beberapa kata kunci yang ditentukan dalam array ini tidak muncul dalam hasil yang Anda terima, berarti basis data kami tidak berisi kata kunci tersebut dan tidak dapat mengembalikan datanya
      Anda tidak akan dikenakan biaya untuk kata kunci yang tidak muncul dalam hasil

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string | null

      kode bahasa
      field wajib jika Anda tidak menentukan language_name
      Catatan: Anda harus menentukan language_name atau language_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa
      field wajib jika Anda tidak menentukan language_code
      Catatan: Anda harus menentukan language_name atau language_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      English

    • 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/dataforseo_labs/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/dataforseo_labs/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_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
        • 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

            • avg_backlinks_info
              Tipe: object | null · Response36Afe1097B20_AvgBacklinksInfo

              data backlink untuk kata kunci yang dikembalikan
              objek ini menyediakan jumlah rata-rata backlink, halaman dan domain perujuk, serta nilai peringkat rata-rata di antara 10 situs web teratas yang diperingkat secara organik untuk kata kunci

              • backlinks
                Tipe: number | null

                jumlah rata-rata backlink

              • dofollow
                Tipe: number | null

                jumlah rata-rata tautan dofollow

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu data kata kunci diperbarui
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                Tipe: number | null

                peringkat domain utama rata-rata
                pelajari lebih lanjut tentang metrik dan rumus perhitungannya di artikel Pusat Bantuan ini

              • rank
                Tipe: number | null

                peringkat rata-rata
                pelajari lebih lanjut tentang metrik dan rumus perhitungannya di artikel pusat bantuan ini

              • referring_domains
                Tipe: number | null

                jumlah rata-rata domain perujuk

              • referring_main_domains
                Tipe: number | null

                jumlah rata-rata domain utama perujuk

              • referring_pages
                Tipe: number | null

                jumlah rata-rata halaman perujuk

              • se_type
                Tipe: string | null

                jenis mesin pencari

            • clickstream_keyword_info
              Tipe: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              data clickstream untuk kata kunci yang dikembalikan
              untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true

              • age_distribution
                Tipe: object | null

                distribusi metrik berbasis clickstream menurut usia
                pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • propertyName
                  Tipe: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • gender_distribution
                Tipe: object | null

                distribusi metrik berbasis clickstream menurut gender
                pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • propertyName
                  Tipe: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu data kata kunci diperbarui
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-11-15 12:57:46 +00:00

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

                pencarian bulanan
                mewakili jumlah pencarian (perkiraan) untuk ide kata kunci ini (sesuai yang tersedia selama dua belas bulan terakhir), yang ditargetkan ke lokasi geografis yang ditentukan

                • 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

                rata-rata tingkat volume pencarian bulanan
                mewakili jumlah pencarian (perkiraan) untuk ide kata kunci tertentu di google.com

            • keyword
              Tipe: string | null

              kata kunci
              kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)

            • keyword_info
              Tipe: object | null · Response36Afe1097B20_KeywordInfo

              data kata kunci untuk kata kunci yang dikembalikan

              • categories
                Tipe: array integer[] | null

                kategori produk dan layanan
                Anda dapat mengunduh daftar lengkap kategori yang mungkin

              • competition
                Tipe: number | null

                persaingan
                mewakili jumlah persaingan relatif yang terkait dengan kata kunci tertentu. Nilai ini didasarkan pada data Google Ads dan dapat berada antara 0 dan 1 (inklusif)

              • competition_level
                Tipe: string | null

                tingkat persaingan
                mewakili tingkat persaingan relatif yang terkait dengan kata kunci tertentu, hanya di SERP berbayar;
                nilai yang mungkin: LOW, MEDIUM, HIGH
                jika tingkat persaingan tidak diketahui, nilainya adalah null;
                pelajari lebih lanjut tentang metrik ini di artikel Pusat Bantuan ini

              • cpc
                Tipe: number | null

                biaya per klik
                mewakili biaya rata-rata per klik (USD) yang secara historis dibayarkan untuk kata kunci

              • 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

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu data kata kunci diperbarui
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-11-15 12:57:46 +00:00

              • 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 jumlah pencarian (perkiraan) untuk ide kata kunci ini (sesuai yang tersedia selama dua belas bulan terakhir), yang ditargetkan ke lokasi geografis yang ditentukan

                • month
                  Tipe: integer | null

                  bulan

                • search_volume
                  Tipe: integer | null

                  tingkat volume pencarian rata-rata bulanan

                • year
                  Tipe: integer | null

                  tahun

              • se_type
                Tipe: string | null

                jenis mesin pencari

              • search_volume
                Tipe: integer | null Format: int64

                rata-rata tingkat volume pencarian bulanan
                mewakili jumlah pencarian (perkiraan) untuk ide kata kunci tertentu di google.com

              • search_volume_trend
                Tipe: object | null · Response36Afe1097B20_SearchVolumeTrend

                perubahan tren volume pencarian
                mewakili persentase perubahan volume pencarian dibandingkan periode sebelumnya

                • monthly
                  Tipe: integer | null

                  perubahan volume pencarian dalam persen dibandingkan bulan sebelumnya

                • quarterly
                  Tipe: integer | null

                  perubahan volume pencarian dalam persen dibandingkan kuartal sebelumnya

                • yearly
                  Tipe: integer | null

                  perubahan volume pencarian dalam persen dibandingkan tahun sebelumnya

            • keyword_info_normalized_with_bing
              Tipe: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              berisi volume pencarian kata kunci yang dinormalisasi dengan volume pencarian Bing

              • is_normalized
                Tipe: boolean | null

                info kata kunci dinormalisasi jika true, nilai dinormalisasi dengan data Bing

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu saat dataset diperbarui dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00

              • 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

                volume pencarian saat ini dari sebuah kata kunci

            • keyword_info_normalized_with_clickstream
              Tipe: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              berisi volume pencarian kata kunci yang dinormalisasi dengan data clickstream

              • is_normalized
                Tipe: boolean | null

                info kata kunci dinormalisasi jika true, nilai dinormalisasi dengan data Bing

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu saat dataset diperbarui dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00

              • 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

                volume pencarian saat ini dari sebuah kata kunci

            • keyword_properties
              Tipe: object | null · Response36Afe1097B20_KeywordProperties

              informasi tambahan tentang kata kunci

              • core_keyword
                Tipe: string | null

                kata kunci utama dalam sebuah grup
                berisi kata kunci utama dalam grup yang ditentukan oleh algoritme pengelompokan sinonim
                jika nilainya null, basis data kami tidak berisi kata kunci yang dapat diidentifikasi algoritme terkait sebagai sinonim dari keyword

              • detected_language
                Tipe: string | null

                bahasa kata kunci yang terdeteksi
                menunjukkan bahasa kata kunci yang diidentifikasi oleh sistem kami

              • is_another_language
                Tipe: boolean | null

                bahasa kata kunci yang terdeteksi berbeda dari bahasa yang ditetapkan
                jika true, bahasa yang ditetapkan dalam permintaan tidak cocok dengan bahasa yang ditentukan sistem kami untuk kata kunci tertentu

              • keyword_difficulty
                Tipe: integer | null

                kesulitan peringkat dalam 10 hasil organik teratas pertama untuk sebuah kata kunci
                menunjukkan peluang masuk 10 hasil organik teratas untuk sebuah kata kunci pada skala logaritmik dari 0 hingga 100;
                dihitung dengan menganalisis, antara lain, profil tautan dari 10 halaman pertama di SERP;
                pelajari lebih lanjut tentang metrik ini di panduan Pusat Bantuan ini

              • se_type
                Tipe: string | null

                jenis mesin pencari

              • synonym_clustering_algorithm
                Tipe: string | null

                algoritme yang digunakan untuk mengidentifikasi sinonim
                nilai yang mungkin:
                keyword_metrics - menunjukkan algoritme berdasarkan parameter keyword_info
                text_processing - menunjukkan algoritme berbasis teks
                jika nilainya null, basis data kami tidak berisi kata kunci yang dapat diidentifikasi algoritme terkait sebagai sinonim dari keyword

              • words_count
                Tipe: integer | null Format: int64

                jumlah kata dalam kata kunci
                menunjukkan berapa banyak kata yang menyusun kata kunci

            • language_code
              Tipe: string | null

              kode bahasa dalam array POST

            • location_code
              Tipe: integer | null

              kode lokasi dalam array POST

            • se_type
              Tipe: string | null

              jenis mesin pencari

            • search_intent_info
              Tipe: object | null · Response36Afe1097B20_SearchIntentInfo

              info niat pencarian untuk kata kunci yang dikembalikan
              pelajari niat pencarian di artikel pusat bantuan ini

              • foreign_intent
                Tipe: array (string | null)[] | null

                niat pencarian tambahan
                nilai yang mungkin: informational, navigational, commercial, transactional

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu data kata kunci diperbarui
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-11-15 12:57:46 +00:00

              • main_intent
                Tipe: string | null

                niat pencarian utama
                nilai yang mungkin: informational, navigational, commercial, transactional

              • se_type
                Tipe: string | null

                jenis mesin pencari

            • search_partners
              Tipe: boolean | null

              menunjukkan data untuk Google dan situs mitra
              jika true, hasil dikembalikan untuk jaringan milik, dioperasikan, dan sindikasi di seluruh Google dan situs mitra yang menghosting pencarian Google;
              jika false, hasil hanya dikembalikan untuk situs pencarian Google

            • serp_info
              Tipe: object | null · Response36Afe1097B20_SerpInfo

              data SERP
              nilai akan null jika Anda tidak mengatur field include_serp_info ke true dalam array POST atau jika tidak ada data SERP untuk kata kunci ini di basis data kami

              • check_url
                Tipe: string | null

                URL langsung ke hasil mesin pencari
                Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

              • last_updated_time
                Tipe: string | null

                tanggal dan waktu data kata kunci diperbarui
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                Tipe: string | null

                sebelum tanggal dan waktu pembaruan data SERP terakhir
                dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                misalnya:
                2019-10-15 12:57:46 +00:00

              • se_results_count
                Tipe: integer | null Format: int64

                jumlah hasil pencarian untuk kata kunci yang dikembalikan

              • se_type
                Tipe: string | null

                jenis mesin pencari

              • serp_item_types
                Tipe: array (string | null)[] | null

                jenis hasil pencarian di SERP
                berisi jenis hasil pencarian (items) yang ditemukan di SERP
                jenis item yang mungkin:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                catatan bahwa hasil sebenarnya hanya akan dikembalikan untuk elemen organic, paid, featured_snippet, dan local_pack

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • se_type
            Tipe: string | null

            jenis mesin pencari

        • 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
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "include_clickstream_data": true,
    "include_serp_info": true,
    "keywords": [
      "iphone"
    ]
  }
]'

{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "search_partners": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Keyword Overview