v0.2.0-beta

OpenAPI 3.1.0

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

LLM Mentions Aggregated Metrics Langsung

Kekerapan pembantu menyebut sasaran anda, sebagai jumlah dan bukan jawapan individu: total dan items. ⚠️ target ialah array objek, setiap item berbentuk {"domain": "..."} atau {"keyword": "..."}; rentetan tunggal ditolak sebagai jenis yang salah dan array rentetan ditolak dengan mesej 'Each target item must be an object'. Medan penapis datang daripada get_dataforseo_ai_llm_mentions_available_filters. Dibalut dalam envelope DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih mengembalikan HTTP 200. Inilah angka keterlihatan utama; post_dataforseo_ai_llm_mentions_search_live menunjukkan jawapan di sebaliknya, dan post_dataforseo_ai_llm_mentions_cross_metrics_live membandingkan beberapa sasaran sekali gus.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran permintaan rujukan: USD 0.101.
Pengganda pelanggan rujukan: 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

wajib

application/json

Jenis: array object[]
- target
  Jenis: array object[]
  wajib
  
  array objek yang mengandungi entiti sasaran; medan wajib; anda boleh menentukan sehingga 10 entiti (objek) dalam medan target; satu entiti sasaran boleh mengandungi satu domain atau satu kata kunci dan parameter berkaitan; contoh: array target dengan entiti domain [{"domain": "en.wikipedia.org", "search_filter": "exclude"}]; array target dengan entiti kata kunci [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}]; array target dengan berbilang entiti [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Jenis: string
  wajib
  
  domain sasaran; medan wajib jika anda tidak menentukan kata kunci; anda boleh menentukan sehingga 63 aksara dalam medan domain; domain hendaklah ditentukan tanpa https:// dan www.
  
  include_subdomains
  Jenis: boolean
  
  menunjukkan sama ada subdomain domain sasaran akan disertakan dalam carian; medan pilihan; jika ditetapkan kepada true, subdomain akan disertakan dalam carian; nilai lalai: false
  
  keyword
  Jenis: string
  
  kata kunci sasaran; medan wajib jika anda tidak menentukan domain; anda boleh menentukan sehingga 250 aksara dalam medan kata kunci; semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang); jika anda perlu menggunakan aksara “%” untuk kata kunci anda, nyatakan sebagai “%25”; jika anda perlu menggunakan aksara “+” untuk kata kunci anda, nyatakan sebagai “%2B”; ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini
  
  match_type
  Jenis: string
  
  jenis padanan kata kunci sasaran; medan pilihan; word_match - carian teks penuh untuk istilah yang sepadan dengan kata kunci benih yang ditentukan dengan perkataan tambahan sebelum, selepas atau dalam frasa kunci (contohnya, carian “light” akan memulangkan hasil dengan “light bulb”, “light switch”); partial_match - carian substring yang menemui semua contoh yang mengandungi urutan aksara yang ditentukan, walaupun ia muncul dalam perkataan yang lebih panjang (contohnya, carian “light” akan memulangkan hasil dengan “lighting”, “highlight”); nilai yang mungkin: word_match, partial_match; nilai lalai: word_match
  
  search_filter
  Jenis: string
  
  Penapis carian entiti: include atau exclude; lalai kepada include.
  
  search_scope
  Jenis: array string[]
  
  Skop carian. Entiti domain: any, sources, search_results. Entiti kata kunci: any, question, answer, brand_entities, fan_out_queries. Lalai: any.
- initial_dataset_filters
  Jenis: array
  
  array ungkapan penapis yang digunakan sebelum agregasi; medan pilihan; anda boleh menggunakan array ini untuk menapis ungkapan yang digunakan pada pangkalan data sebutan mentah sebelum agregasi bagi mengehadkan baris yang menyumbang kepada hasil; anda boleh menambah beberapa penapis sekaligus (maksimum 8 penapis); anda perlu menetapkan operator logik and atau or antara syarat; operator berikut disokong: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match; anda boleh menggunakan operator % dengan like dan not_like untuk memadankan sebarang string dengan sifar aksara atau lebih; contoh: ["ai_search_volume",">","1000"]; senarai penuh penapis yang mungkin tersedia di sini. Ketahui lebih lanjut tentang penapis set data awal dalam artikel pusat bantuan ini.
- internal_list_limit
  Jenis: integer
  
  bilangan maksimum elemen dalam array dalaman; medan pilihan; anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam array berikut: sources_domain, search_results_domain; nilai minimum: 1; nilai maksimum: 20; nilai lalai: 10
- language_code
  Jenis: string
  
  kod bahasa carian; medan pilihan; jika anda menggunakan medan ini, anda tidak perlu menentukan language_name; anda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; nilai lalai: en; Nota: data chat_gpt tersedia untuk en sahaja
- language_name
  Jenis: string
  
  nama penuh bahasa carian; medan pilihan; jika anda menggunakan medan ini, anda tidak perlu menentukan language_code; jika anda tidak menentukan medan ini, language_code dengan nilai en akan digunakan secara lalai; anda boleh mendapatkan senarai bahasa enjin carian yang tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Nota: data chat_gpt tersedia untuk bahasa Inggeris sahaja
- location_code
  Jenis: integer
  
  kod lokasi carian; medan pilihan; jika anda menggunakan medan ini, anda tidak perlu menentukan location_name; anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; nilai lalai: 2840; Nota: data chat_gpt tersedia untuk 2840 sahaja
- location_name
  Jenis: string
  
  nama penuh lokasi carian; medan pilihan; jika anda menggunakan medan ini, anda tidak perlu menentukan location_code; jika anda tidak menentukan medan ini, location_code dengan nilai 2840 akan digunakan secara lalai; anda boleh mendapatkan senarai lokasi enjin carian yang tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages; Nota: data chat_gpt tersedia untuk United States sahaja
- platform
  Jenis: string
  
  platform sasaran; medan pilihan; nilai yang mungkin: chat_gpt, google; nilai lalai: google; Nota: data yang dipulangkan bergantung pada platform yang dipilih; Nota #2: data chat_gpt tersedia untuk United States dan bahasa Inggeris sahaja
- tag
  Jenis: string
  
  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

Respons berjaya
cost
Jenis: number

jumlah kos tugas, USD

status_code
Jenis: integer

kod status umum; anda boleh menemui senarai penuh kod respons di sini; Nota: kami amat mengesyorkan agar anda mereka bentuk sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan

status_message
Jenis: string

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks
Jenis: array string[]

array tugas

tasks_count
Jenis: integer

bilangan tugas dalam array tasks

tasks_error
Jenis: integer

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

tasks.cost
Jenis: number

kos tugas, USD

tasks.data
Jenis: object

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

tasks.id
Jenis: string

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

tasks.path
Jenis: array string[]

Laluan URL

tasks.result
Jenis: array string[]

array hasil

tasks.result_count
Jenis: integer

bilangan elemen dalam array hasil

tasks.result.items
Jenis: array string[]

array hasil halaman individu yang mengandungi metrik sebutan terperinci bagi setiap halaman teratas yang ditemui; dalam kes ini, sama dengan null

tasks.result.total
Jenis: object

ringkasan metrik sebutan teragregat; mengandungi metrik sebutan LLM teragregat keseluruhan merentas semua domain yang ditemui, dikelompokkan mengikut pelbagai dimensi

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

data tentang entiti jenama yang berkaitan dengan sasaran; array objek yang mengandungi data tentang kategori entiti jenama yang muncul dalam hasil carian berkaitan pertanyaan LLM

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan; dalam kes ini, medan memaparkan kategori entiti jenama yang ditemui

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan domain khusus

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

jenis elemen = 'group_element'

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

data tentang entiti jenama yang berkaitan dengan sasaran; array objek yang mengandungi data tentang tajuk entiti jenama yang muncul dalam hasil carian berkaitan pertanyaan LLM

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan; dalam kes ini, medan memaparkan tajuk entiti jenama yang ditemui

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan domain khusus

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

jenis elemen = 'group_element'

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

pengelompokan berdasarkan bahasa; array objek yang mengandungi metrik sebutan yang disegmenkan mengikut bahasa kandungan

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan kunci pengelompokan khusus ini

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

jenis elemen = 'group_element'

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

pengelompokan berdasarkan lokasi; array objek yang mengandungi metrik sebutan yang disegmenkan mengikut lokasi geografi

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan kunci pengelompokan khusus ini

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

jenis elemen = 'group_element'

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

pengelompokan berdasarkan platform; array elemen kumpulan yang mengandungi metrik sebutan yang disegmenkan mengikut platform AI

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan kunci pengelompokan khusus ini

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

jenis elemen = 'group_element'

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

domain hasil carian teratas yang ditemui berkaitan sasaran; array objek yang mengandungi data tentang domain teratas yang muncul dalam hasil carian berkaitan pertanyaan LLM

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan; dalam kes ini, medan memaparkan nama domain yang ditemui

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan domain khusus

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

jenis elemen = 'group_element'

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

domain sumber teratas yang ditemui berkaitan sasaran; array objek yang mengandungi data tentang domain teratas yang dipetik sebagai sumber dalam respons LLM

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

kadar isipadu carian AI semasa bagi sesuatu kata kunci; ketahui lebih lanjut tentang metrik ini di sini

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

kadar tayangan AI semasa bagi sesuatu kata kunci

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

pengecam pengelompokan; pengecam khusus untuk dimensi pengelompokan; dalam kes ini, medan memaparkan nama domain yang ditemui

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

jumlah sebutan LLM; bilangan kali kata kunci atau domain sasaran disebut berkaitan domain khusus

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

jenis elemen = 'group_element'

tasks.status_code
Jenis: integer

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

tasks.status_message
Jenis: string

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks.time
Jenis: string

masa pelaksanaan, saat

time
Jenis: string

masa pelaksanaan, saat

version
Jenis: string

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

Tunjukkan 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 berjaya

LLM Mentions Aggregated Metrics Langsung

PengesahanRequired

DataForSEO

LLM Mentions Aggregated Metrics Langsung

Rujukan harga