v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions 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/search/live

LLM Mentions Langsung

Jawapan individu yang menyebut sasaran anda oleh pembantu. Mengembalikan total_count, current_offset, search_after_token dan items - untuk halaman selepas halaman pertama, gunakan token, bukan offset. ⚠️ 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. Untuk bilangan dan bukan mentions itu sendiri, gunakan post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran permintaan rujukan: USD 0.701.
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 menentukan cara kata kunci yang ditentukan dipadankan medan pilihan nilai yang mungkin: 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 mengembalikan hasil dengan "light bulb", "light switch"); partial_match - carian subrentetan yang menemui semua kejadian yang mengandungi urutan aksara yang ditentukan, walaupun ia muncul dalam perkataan yang lebih panjang (contohnya, carian "light" akan mengembalikan hasil dengan "lighting", "highlight"); 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.
- filters
  Jenis: array
  
  array parameter penapisan hasil medan pilihan anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis) anda harus menetapkan operator logik and, 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 rentetan dengan sifar atau lebih aksara contoh: ["ai_search_volume",">","1000"] Senarai penuh penapis yang mungkin tersedia di sini.
- 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
- limit
  Jenis: integer
  
  bilangan maksimum objek yang dikembalikan medan pilihan nilai lalai: 100 nilai maksimum: 1000
- 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
- offset
  Jenis: integer
  
  offset dalam array hasil data mentions yang dikembalikan medan pilihan nilai lalai: 0 contoh: jika anda menentukan nilai 10, sepuluh objek mentions pertama dalam array hasil akan dilangkau dan data akan disediakan untuk objek berikutnya; Nota: nilai maksimum ialah 9,000, gunakan search_after_token jika anda ingin mendapatkan lebih banyak hasil
- order_by
  Jenis: array string[]
  
  peraturan susunan hasil medan pilihan anda boleh menggunakan nilai yang sama seperti dalam array filters untuk menyusun hasil jenis susunan yang mungkin: asc - hasil akan disusun dalam susunan menaik desc - hasil akan disusun dalam susunan menurun anda harus menggunakan koma untuk menyediakan jenis susunan contoh: ["ai_search_volume,desc"] ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan susunan dalam satu permintaan anda harus menggunakan koma untuk memisahkan beberapa peraturan susunan
- 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
- search_after_token
  Jenis: string
  
  token untuk permintaan berikutnya medan pilihan disediakan dalam medan yang sama pada respons setiap permintaan; gunakan parameter ini untuk mengelakkan tamat masa semasa cuba memperoleh lebih daripada 20,000 hasil dalam satu permintaan; dengan menentukan nilai search_after_token unik daripada array respons, anda akan memperoleh hasil berikutnya bagi tugas awal; nilai search_after_token adalah unik bagi setiap tugas berikutnya ; Nota: jika search_after_token ditentukan dalam permintaan, semua parameter lain mestilah sama dengan permintaan sebelumnya
- 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.current_offset
Jenis: integer

bilangan objek mentions yang dilangkau dalam array items

tasks.result.items
Jenis: array string[]

mengandungi data mentions yang berkaitan

tasks.result.items_count
Jenis: integer

bilangan hasil yang dikembalikan dalam array items

tasks.result.items.ai_search_volume
Jenis: integer

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

tasks.result.items.answer
Jenis: string

jawapan berkaitan dalam format markdown kandungan hasil yang diformatkan dalam bahasa penanda markdown

tasks.result.items.brand_entities
Jenis: array string[]

array entiti jenama mengandungi maklumat tentang jenama yang disebut dalam respons

tasks.result.items.brand_entities.category
Jenis: string

kategori jenama

tasks.result.items.brand_entities.position
Jenis: integer

kedudukan dalam hasil

tasks.result.items.brand_entities.title
Jenis: string

nama jenama

tasks.result.items.fan_out_queries
Jenis: array string[]

array pertanyaan fan-out mengandungi pertanyaan carian berkaitan yang diterbitkan daripada pertanyaan utama untuk memberikan respons yang lebih menyeluruh

tasks.result.items.first_response_at
Jenis: string

tarikh dan masa data respons pertama kali direkodkan dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
Jenis: string

kod bahasa dalam array POST

tasks.result.items.last_response_at
Jenis: string

tarikh dan masa data respons kali terakhir dikemas kini dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00” contoh: 2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
Jenis: integer

kod lokasi dalam array POST

tasks.result.items.model_name
Jenis: string

nama model AI tempat data diambil Nota: untuk jenis platform google, nilainya sentiasa google_ai_overview

tasks.result.items.monthly_searches
Jenis: array string[]

kadar volum carian AI bulanan array objek dengan kadar volum carian AI dalam bulan tertentu bagi sesuatu tahun

tasks.result.items.monthly_searches.month
Jenis: integer

bulan

tasks.result.items.monthly_searches.search_volume
Jenis: integer

kadar volum carian AI dalam bulan tertentu bagi sesuatu tahun ketahui lebih lanjut tentang metrik ini di sini

tasks.result.items.monthly_searches.year
Jenis: integer

tahun

tasks.result.items.platform
Jenis: string

platform yang diterima dalam array POST

tasks.result.items.question
Jenis: string

soalan berkaitan

tasks.result.items.search_results
Jenis: array string[]

array hasil carian semua keluaran carian web yang diambil oleh model semasa mencari maklumat, termasuk pendua dan entri yang tidak digunakan

tasks.result.items.search_results.breadcrumb
Jenis: string

jejak navigasi

tasks.result.items.search_results.description
Jenis: string

penerangan hasil

tasks.result.items.search_results.domain
Jenis: string

domain hasil

tasks.result.items.search_results.position
Jenis: integer

kedudukan dalam hasil

tasks.result.items.search_results.publication_date
Jenis: string

tarikh dan masa hasil diterbitkan dalam format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” contoh: 2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
Jenis: string

tajuk hasil

tasks.result.items.search_results.url
Jenis: string

URL hasil

tasks.result.items.sources
Jenis: array string[]

array sumber sumber yang dipetik atau dijadikan rujukan oleh model dalam jawapan akhirnya

tasks.result.items.sources.domain
Jenis: string

domain sumber

tasks.result.items.sources.markdown
Jenis: string

kandungan elemen dalam format markdown kandungan hasil yang diformatkan dalam bahasa penanda markdown

tasks.result.items.sources.position
Jenis: integer

kedudukan dalam hasil

tasks.result.items.sources.publication_date
Jenis: string

tarikh dan masa hasil diterbitkan dalam format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” contoh: 2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
Jenis: string

penerangan sumber

tasks.result.items.sources.source_name
Jenis: string

nama sumber

tasks.result.items.sources.thumbnail
Jenis: string

gambar kecil sumber

tasks.result.items.sources.title
Jenis: string

tajuk sumber

tasks.result.items.sources.url
Jenis: string

URL sumber

tasks.result.search_after_token
Jenis: string

token untuk permintaan berikutnya dengan menentukan search_after_token unik semasa menyediakan tugas baharu, anda akan memperoleh hasil berikutnya bagi tugas awal; nilai search_after_token adalah unik bagi setiap tugas berikutnya

tasks.result.total_count
Jenis: integer

jumlah keseluruhan hasil yang berkaitan dengan permintaan

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/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

Respons berjaya

LLM Mentions Langsung

PengesahanRequired

DataForSEO

LLM Mentions Langsung

Rujukan harga