v0.2.0-beta

OpenAPI 3.1.0

Gambaran Keseluruhan Kata Kunci

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/dataforseo_labs/google/keyword_overview/live

Gambaran Keseluruhan Kata Kunci

Segala yang diketahui Labs tentang senarai keywords dalam satu panggilan: volum, kesukaran, niat, persaingan dan ciri SERP yang dicetuskannya. Memulangkan se_type, location_code, language_code, items_count dan items. Endpoint ini tiada parameter had, tetapi dicaj setiap panggilan dan bukan setiap item, jadi hantar keseluruhan senarai sekali gus. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Mulakan di sini apabila anda sudah mempunyai kata kunci; post_dataforseo_labs_google_keyword_ideas_live ialah tempat untuk pergi apabila anda memerlukan lebih banyak.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0,0254.
Pengganda rujukan pelanggan: 1,0. Jangan gunakannya 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)[]
- include_clickstream_data
  Jenis: boolean | null
  
  sertakan atau kecualikan data daripada metrik berasaskan clickstream dalam hasil
  medan pilihan
  jika parameter ditetapkan kepada true, anda akan menerima medan clickstream_keyword_info, keyword_info_normalized_with_clickstream dan keyword_info_normalized_with_bing dalam respons
  nilai lalai: false
  dengan parameter ini didayakan, anda akan dikenakan caj dua kali ganda untuk permintaan tersebut
  
  ketahui lebih lanjut tentang cara metrik berasaskan clickstream dikira dalam artikel pusat bantuan ini
- include_serp_info
  Jenis: boolean | null
  
  sertakan data daripada SERP untuk setiap kata kunci
  medan pilihan
  jika ditetapkan kepada true, kami akan memulangkan tatasusunan serp_info yang mengandungi data SERP (bilangan hasil carian, URL berkaitan dan ciri SERP) untuk setiap kata kunci dalam respons
  nilai lalai: false
- keywords
  Jenis: array string[]
  
  kata kunci
  medan wajib
  Bilangan maksimum kata kunci yang boleh anda tentukan: 700
  Bilangan maksimum aksara untuk setiap kata kunci: 80
  Bilangan maksimum perkataan untuk setiap frasa kata kunci: 10
  kata kunci yang ditentukan akan ditukar kepada format huruf kecil, data akan disediakan dalam tatasusunan berasingan
  
  ambil perhatian bahawa jika sesetengah kata kunci yang ditentukan dalam tatasusunan ini tidak muncul dalam hasil yang anda terima, bermakna pangkalan data kami tidak mengandungi kata kunci tersebut dan tidak dapat memulangkan data tentangnya
  anda tidak akan dikenakan caj untuk kata kunci yang tidak muncul dalam hasil
  
  ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
- language_code
  Jenis: string | null
  
  kod bahasa
  medan wajib jika anda tidak menentukan language_name
  Nota: anda perlu menentukan language_name atau language_code
  anda boleh mendapatkan senarai lokasi tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  en
- language_name
  Jenis: string
  
  nama penuh bahasa
  medan wajib jika anda tidak menentukan language_code
  Nota: anda perlu menentukan language_name atau language_code
  anda boleh mendapatkan senarai lokasi tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  English
- location_code
  Jenis: integer
  
  kod lokasi
  medan wajib jika anda tidak menentukan location_name
  Nota: anda perlu menentukan location_name atau location_code
  anda boleh mendapatkan senarai lokasi tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  2840
- location_name
  Jenis: string
  
  nama penuh lokasi
  medan wajib jika anda tidak menentukan location_code
  Nota: anda perlu menentukan location_name atau location_code
  anda boleh mendapatkan senarai lokasi tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/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

Respons

200
Jenis: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo
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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
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

mengandungi kata kunci dan data berkaitan

avg_backlinks_info
Jenis: object | null · Response36Afe1097B20_AvgBacklinksInfo

data pautan balik bagi kata kunci yang dipulangkan
objek ini menyediakan purata bilangan pautan balik, halaman dan domain perujuk, serta nilai kedudukan purata antara 10 laman web teratas yang menduduki secara organik bagi kata kunci

backlinks
Jenis: number | null

bilangan purata backlink

dofollow
Jenis: number | null

bilangan purata pautan dofollow

last_updated_time
Jenis: string | null

tarikh dan masa data kata kunci dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

main_domain_rank
Jenis: number | null

kedudukan domain utama purata
ketahui lebih lanjut tentang metrik dan formula pengiraannya dalam artikel Pusat Bantuan ini

rank
Jenis: number | null

kedudukan purata
ketahui lebih lanjut tentang metrik dan formula pengiraannya dalam artikel Pusat Bantuan ini

referring_domains
Jenis: number | null

purata bilangan domain perujuk

referring_main_domains
Jenis: number | null

purata bilangan domain utama perujuk

referring_pages
Jenis: number | null

purata bilangan halaman perujuk

se_type
Jenis: string | null

jenis enjin carian

clickstream_keyword_info
Jenis: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

data clickstream untuk kata kunci yang dipulangkan
untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true

age_distribution
Jenis: object | null

taburan metrik berasaskan clickstream mengikut umur
pelajari lebih lanjut tentang cara metrik dikira dalam artikel pusat bantuan ini

propertyName
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

gender_distribution
Jenis: object | null

taburan metrik berasaskan clickstream mengikut jantina
pelajari lebih lanjut tentang cara metrik dikira dalam artikel pusat bantuan ini

propertyName
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

last_updated_time
Jenis: string | null

tarikh dan masa data kata kunci dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

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

carian bulanan
mewakili bilangan carian (anggaran) bagi idea kata kunci ini (seperti yang tersedia untuk dua belas bulan lalu), disasarkan kepada lokasi geografi yang ditentukan

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 purata volum carian bulanan
mewakili bilangan carian (anggaran) bagi idea kata kunci tertentu di google.com

keyword
Jenis: string | null

kata kunci
kata kunci dipulangkan dengan %## yang dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

keyword_info
Jenis: object | null · Response36Afe1097B20_KeywordInfo

data kata kunci bagi kata kunci yang dipulangkan

categories
Jenis: array integer[] | null

kategori produk dan perkhidmatan
anda boleh memuat turun senarai penuh kategori yang mungkin

competition
Jenis: number | null

persaingan
mewakili jumlah persaingan relatif yang berkaitan dengan kata kunci tertentu. Nilai ini berdasarkan data Google Ads dan boleh berada antara 0 dan 1 (termasuk kedua-dua hujung)

competition_level
Jenis: string | null

tahap persaingan
mewakili tahap persaingan relatif yang berkaitan dengan kata kunci tertentu, dalam SERP berbayar sahaja;
nilai yang mungkin: LOW, MEDIUM, HIGH
jika tahap persaingan tidak diketahui, nilainya ialah null;
pelajari lebih lanjut tentang metrik ini dalam artikel Pusat Bantuan ini

cpc
Jenis: number | null

kos setiap klik
mewakili purata kos setiap klik (USD) yang dibayar secara sejarah bagi kata kunci

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

last_updated_time
Jenis: string | null

tarikh dan masa data kata kunci dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

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 bilangan carian (anggaran) bagi idea kata kunci ini (seperti yang tersedia untuk dua belas bulan lalu), disasarkan kepada lokasi geografi yang ditentukan

month
Jenis: integer | null

bulan

search_volume
Jenis: integer | null

kadar purata volum carian bulanan

year
Jenis: integer | null

tahun

se_type
Jenis: string | null

jenis enjin carian

search_volume
Jenis: integer | null Format: int64

kadar purata volum carian bulanan
mewakili bilangan carian (anggaran) bagi idea kata kunci tertentu di google.com

search_volume_trend
Jenis: object | null · Response36Afe1097B20_SearchVolumeTrend

perubahan trend volum carian
mewakili peratusan perubahan volum carian berbanding tempoh sebelumnya

monthly
Jenis: integer | null

perubahan volum carian dalam peratus berbanding bulan sebelumnya

quarterly
Jenis: integer | null

perubahan volum carian dalam peratus berbanding suku tahun sebelumnya

yearly
Jenis: integer | null

perubahan volum carian dalam peratus berbanding tahun sebelumnya

keyword_info_normalized_with_bing
Jenis: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

mengandungi volum carian kata kunci yang dinormalkan dengan volum carian Bing

is_normalized
Jenis: boolean | null

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

last_updated_time
Jenis: string | null

tarikh dan masa apabila dataset dikemas kini dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00

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

kadar volum carian semasa bagi sesuatu kata kunci

keyword_info_normalized_with_clickstream
Jenis: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

mengandungi volum carian kata kunci yang dinormalkan dengan data clickstream

is_normalized
Jenis: boolean | null

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

last_updated_time
Jenis: string | null

tarikh dan masa apabila dataset dikemas kini dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2019-11-15 12:57:46 +00:00

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

kadar volum carian semasa bagi sesuatu kata kunci

keyword_properties
Jenis: object | null · Response36Afe1097B20_KeywordProperties

maklumat tambahan tentang kata kunci

core_keyword
Jenis: string | null

kata kunci utama dalam sesuatu kumpulan
mengandungi kata kunci utama dalam kumpulan yang ditentukan oleh algoritma pengelompokan sinonim
jika nilainya null, pangkalan data kami tidak mengandungi kata kunci yang boleh dikenal pasti oleh algoritma berkenaan sebagai sinonim bagi keyword

detected_language
Jenis: string | null

bahasa kata kunci yang dikesan
menunjukkan bahasa kata kunci seperti yang dikenal pasti oleh sistem kami

is_another_language
Jenis: boolean | null

bahasa kata kunci yang dikesan berbeza daripada bahasa yang ditetapkan
jika true, bahasa yang ditetapkan dalam permintaan tidak sepadan dengan bahasa yang ditentukan oleh sistem kami bagi kata kunci tertentu

keyword_difficulty
Jenis: integer | null

kesukaran untuk menduduki 10 hasil organik teratas pertama bagi sesuatu kata kunci
menunjukkan peluang untuk masuk ke 10 hasil organik teratas bagi sesuatu kata kunci pada skala logaritma dari 0 hingga 100;
dikira dengan menganalisis, antara parameter lain, profil pautan bagi 10 halaman pertama dalam SERP;
pelajari lebih lanjut tentang metrik ini dalam panduan Pusat Bantuan ini

se_type
Jenis: string | null

jenis enjin carian

synonym_clustering_algorithm
Jenis: string | null

algoritma yang digunakan untuk mengenal pasti sinonim
nilai yang mungkin:
keyword_metrics - menunjukkan algoritma berdasarkan parameter keyword_info
text_processing - menunjukkan algoritma berasaskan teks
jika nilainya null, pangkalan data kami tidak mengandungi kata kunci yang boleh dikenal pasti oleh algoritma berkenaan sebagai sinonim bagi keyword

words_count
Jenis: integer | null Format: int64

bilangan perkataan dalam kata kunci
menunjukkan berapa banyak perkataan yang membentuk kata kunci

language_code
Jenis: string | null

kod bahasa dalam array POST

location_code
Jenis: integer | null

kod lokasi dalam array POST

se_type
Jenis: string | null

jenis enjin carian

search_intent_info
Jenis: object | null · Response36Afe1097B20_SearchIntentInfo

maklumat niat carian bagi kata kunci yang dipulangkan
ketahui tentang niat carian dalam artikel pusat bantuan ini

foreign_intent
Jenis: array (string | null)[] | null

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

last_updated_time
Jenis: string | null

tarikh dan masa data kata kunci dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

main_intent
Jenis: string | null

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

se_type
Jenis: string | null

jenis enjin carian

search_partners
Jenis: boolean | null

menunjukkan data untuk Google dan tapak rakan kongsi
jika true, hasil dipulangkan untuk rangkaian milik, dikendalikan dan sindikasi di seluruh Google dan tapak rakan kongsi yang menghos carian Google;
jika false, hasil hanya dipulangkan untuk tapak carian Google

serp_info
Jenis: object | null · Response36Afe1097B20_SerpInfo

data SERP
nilai akan null jika anda tidak menetapkan medan include_serp_info kepada true dalam array POST atau jika tiada data SERP untuk kata kunci ini dalam pangkalan data kami

check_url
Jenis: string | null

URL terus ke hasil enjin carian
anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

last_updated_time
Jenis: string | null

tarikh dan masa data kata kunci dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

previous_updated_time
Jenis: string | null

sebelum tarikh dan masa data SERP dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-10-15 12:57:46 +00:00

se_results_count
Jenis: integer | null Format: int64

bilangan hasil carian untuk kata kunci yang dipulangkan

se_type
Jenis: string | null

jenis enjin carian

serp_item_types
Jenis: array (string | null)[] | null

jenis hasil carian dalam SERP
mengandungi jenis hasil carian (items) yang ditemui dalam 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;
nota bahawa hasil sebenar hanya akan dipulangkan untuk elemen organic, paid, featured_snippet, dan local_pack

items_count
Jenis: integer | null Format: int64

bilangan hasil yang dipulangkan dalam array items

language_code
Jenis: string | null

kod bahasa dalam array POST

location_code
Jenis: integer | null

kod lokasi dalam array POST

se_type
Jenis: string | null

jenis enjin carian

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/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"
    ]
  }
]'

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": [
        {
          "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 berjaya

Gambaran Keseluruhan Kata Kunci

PengesahanRequired

DataForSEO

Gambaran Keseluruhan Kata Kunci

Rujukan harga