v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions Aggregated Metrics 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/ai_optimization/llm_mentions/aggregated_metrics/live

LLM Mentions Aggregated Metrics Langsung

Seberapa sering asisten menyebut target Anda, sebagai total alih-alih jawaban individual: total dan items. ⚠️ target adalah array objek, setiap item berupa {"domain": "..."} atau {"keyword": "..."}; string biasa ditolak sebagai tipe yang salah dan array string ditolak dengan pesan 'Each target item must be an object'. Field filter berasal dari get_dataforseo_ai_llm_mentions_available_filters. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini adalah angka visibilitas utamanya; post_dataforseo_ai_llm_mentions_search_live menunjukkan jawaban di baliknya, dan post_dataforseo_ai_llm_mentions_cross_metrics_live membandingkan beberapa target sekaligus.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan permintaan referensi: USD 0,101.
Pengali pelanggan referensi: 1,0. Jangan menerapkannya 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

wajib

application/json

Tipe: array object[]
- target
  Tipe: array object[]
  wajib
  
  array objek yang berisi entitas target; field wajib; Anda dapat menentukan hingga 10 entitas (objek) di field target; satu entitas target dapat berisi satu domain atau satu keyword dan parameter terkait; contoh: array target dengan entitas domain [{"domain": "en.wikipedia.org", "search_filter": "exclude"}]; array target dengan entitas keyword [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}]; array target dengan beberapa entitas [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Tipe: string
  wajib
  
  domain target; field wajib jika Anda tidak menentukan keyword; Anda dapat menentukan hingga 63 karakter di field domain; domain harus ditentukan tanpa https:// dan www.
  
  include_subdomains
  Tipe: boolean
  
  menunjukkan apakah subdomain dari domain target akan disertakan dalam pencarian; field opsional; jika disetel ke true, subdomain akan disertakan dalam pencarian; nilai default: false
  
  keyword
  Tipe: string
  
  keyword target; field wajib jika Anda tidak menentukan domain; Anda dapat menentukan hingga 250 karakter di field keyword; semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi); jika Anda perlu menggunakan karakter “%” untuk keyword Anda, tentukan sebagai “%25”; jika Anda perlu menggunakan karakter “+” untuk keyword Anda, tentukan sebagai “%2B”; pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini
  
  match_type
  Tipe: string
  
  jenis kecocokan keyword target; field opsional; word_match - pencarian teks lengkap untuk istilah yang cocok dengan keyword benih yang ditentukan dengan kata tambahan sebelum, setelah, atau di dalam frasa kunci (misalnya, pencarian “light” akan mengembalikan hasil dengan “light bulb”, “light switch”); partial_match - pencarian substring yang menemukan semua kemunculan yang berisi urutan karakter yang ditentukan, bahkan jika muncul di dalam kata yang lebih panjang (misalnya, pencarian “light” akan mengembalikan hasil dengan “lighting”, “highlight”); nilai yang mungkin: word_match, partial_match; nilai default: word_match
  
  search_filter
  Tipe: string
  
  Filter pencarian entitas: include atau exclude; default-nya include.
  
  search_scope
  Tipe: array string[]
  
  Cakupan pencarian. Entitas domain: any, sources, search_results. Entitas keyword: any, question, answer, brand_entities, fan_out_queries. Default: any.
- initial_dataset_filters
  Tipe: array
  
  array ekspresi filter yang diterapkan sebelum agregasi; field opsional; Anda dapat menggunakan array ini untuk memfilter ekspresi yang diterapkan ke basis data penyebutan mentah sebelum agregasi guna membatasi baris yang berkontribusi pada hasil; Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter); Anda harus menyetel operator logika and atau or di antara kondisi; operator berikut didukung: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match; Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol karakter atau lebih; contoh: ["ai_search_volume",">","1000"]; daftar lengkap filter yang mungkin tersedia di sini. Pelajari lebih lanjut tentang filter kumpulan data awal di artikel pusat bantuan ini.
- internal_list_limit
  Tipe: integer
  
  jumlah maksimum elemen dalam array internal; field opsional; Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut: sources_domain, search_results_domain; nilai minimum: 1; nilai maksimum: 20; nilai default: 10
- language_code
  Tipe: string
  
  kode bahasa pencarian; field opsional; jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name; Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; nilai default: en; Catatan: data chat_gpt hanya tersedia untuk en
- language_name
  Tipe: string
  
  nama lengkap bahasa pencarian; field opsional; jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code; jika Anda tidak menentukan field ini, language_code dengan nilai en akan digunakan secara default; Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Catatan: data chat_gpt hanya tersedia untuk bahasa Inggris
- location_code
  Tipe: integer
  
  kode lokasi pencarian; field opsional; jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name; Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; nilai default: 2840; Catatan: data chat_gpt hanya tersedia untuk 2840
- location_name
  Tipe: string
  
  nama lengkap lokasi pencarian; field opsional; jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code; jika Anda tidak menentukan field ini, location_code dengan nilai 2840 akan digunakan secara default; Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Catatan: data chat_gpt hanya tersedia untuk United States
- platform
  Tipe: string
  
  platform target; field opsional; nilai yang mungkin: chat_gpt, google; nilai default: google; Catatan: data yang dikembalikan bergantung pada platform yang dipilih; Catatan #2: data chat_gpt hanya tersedia untuk United States dan bahasa Inggris
- tag
  Tipe: string
  
  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

Respons berhasil
cost
Tipe: number

total biaya tugas, USD

status_code
Tipe: integer

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini; Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi terkait pengecualian atau error

status_message
Tipe: string

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array string[]

array tugas

tasks_count
Tipe: integer

jumlah tugas dalam array tasks

tasks_error
Tipe: integer

jumlah tugas dalam array tasks yang dikembalikan dengan error

tasks.cost
Tipe: number

biaya tugas, USD

tasks.data
Tipe: object

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

tasks.id
Tipe: string

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

tasks.path
Tipe: array string[]

Jalur URL

tasks.result
Tipe: array string[]

array hasil

tasks.result_count
Tipe: integer

jumlah elemen dalam array hasil

tasks.result.items
Tipe: array string[]

array hasil halaman individual yang berisi metrik penyebutan terperinci untuk setiap halaman teratas yang ditemukan; dalam hal ini, sama dengan null

tasks.result.total
Tipe: object

ringkasan metrik penyebutan teragregasi; berisi metrik penyebutan LLM teragregasi keseluruhan di semua domain yang ditemukan, dikelompokkan berdasarkan berbagai dimensi

tasks.result.total.brand_entities_category
Tipe: array string[]

data tentang entitas merek yang relevan dengan target; array objek yang berisi data tentang kategori entitas merek yang muncul dalam hasil pencarian terkait kueri LLM

tasks.result.total.brand_entities_category.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.brand_entities_category.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.brand_entities_category.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan; dalam hal ini, field menampilkan kategori entitas merek yang ditemukan

tasks.result.total.brand_entities_category.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait domain spesifik

tasks.result.total.brand_entities_category.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.brand_entities_title
Tipe: array string[]

data tentang entitas merek yang relevan dengan target; array objek yang berisi data tentang judul entitas merek yang muncul dalam hasil pencarian terkait kueri LLM

tasks.result.total.brand_entities_title.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.brand_entities_title.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.brand_entities_title.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan; dalam hal ini, field menampilkan judul entitas merek yang ditemukan

tasks.result.total.brand_entities_title.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait domain spesifik

tasks.result.total.brand_entities_title.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.language
Tipe: array string[]

pengelompokan berdasarkan bahasa; array objek yang berisi metrik penyebutan yang disegmentasikan berdasarkan bahasa konten

tasks.result.total.language.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.language.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.language.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan

tasks.result.total.language.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait kunci pengelompokan spesifik ini

tasks.result.total.language.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.location
Tipe: array string[]

pengelompokan berdasarkan lokasi; array objek yang berisi metrik penyebutan yang disegmentasikan berdasarkan lokasi geografis

tasks.result.total.location.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.location.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.location.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan

tasks.result.total.location.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait kunci pengelompokan spesifik ini

tasks.result.total.location.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.platform
Tipe: array string[]

pengelompokan berdasarkan platform; array elemen grup yang berisi metrik penyebutan yang disegmentasikan berdasarkan platform AI

tasks.result.total.platform.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.platform.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.platform.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan

tasks.result.total.platform.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait kunci pengelompokan spesifik ini

tasks.result.total.platform.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.search_results_domain
Tipe: array string[]

domain hasil pencarian teratas yang ditemukan relevan dengan target; array objek yang berisi data tentang domain teratas yang muncul dalam hasil pencarian terkait kueri LLM

tasks.result.total.search_results_domain.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.search_results_domain.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.search_results_domain.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan; dalam hal ini, field menampilkan nama domain yang ditemukan

tasks.result.total.search_results_domain.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait domain spesifik

tasks.result.total.search_results_domain.type
Tipe: string

jenis elemen = 'group_element'

tasks.result.total.sources_domain
Tipe: array string[]

domain sumber teratas yang ditemukan relevan dengan target; array objek yang berisi data tentang domain teratas yang dikutip sebagai sumber dalam respons LLM

tasks.result.total.sources_domain.ai_search_volume
Tipe: integer

tingkat volume pencarian AI saat ini dari sebuah keyword; pelajari lebih lanjut tentang metrik ini di sini

tasks.result.total.sources_domain.impressions
Tipe: integer

tingkat tayangan AI saat ini dari sebuah keyword

tasks.result.total.sources_domain.key
Tipe: string

pengenal pengelompokan; pengenal spesifik untuk dimensi pengelompokan; dalam hal ini, field menampilkan nama domain yang ditemukan

tasks.result.total.sources_domain.mentions
Tipe: integer

jumlah total penyebutan LLM; berapa kali keyword atau domain target disebutkan terkait domain spesifik

tasks.result.total.sources_domain.type
Tipe: string

jenis elemen = 'group_element'

tasks.status_code
Tipe: integer

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

tasks.status_message
Tipe: string

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks.time
Tipe: string

waktu eksekusi, detik

time
Tipe: string

waktu eksekusi, detik

version
Tipe: string

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/ai_optimization/llm_mentions/aggregated_metrics/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]'

Tampilkan Skema

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ]
}

Respons berhasil

LLM Mentions Aggregated Metrics Langsung

AutentikasiRequired

DataForSEO

LLM Mentions Aggregated Metrics Langsung

Referensi harga