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

LLM Mentions 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

LLM Mentions Langsung

​

Jawaban individual yang di dalamnya asisten menyebut target Anda. Mengembalikan total_count, current_offset, search_after_token, dan items - untuk halaman setelah halaman pertama, gunakan token, bukan offset. ⚠️ 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. Untuk jumlah, bukan mentions-nya sendiri, gunakan post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan permintaan referensi: USD 0,701.
  • 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 pencocokan kata kunci target menentukan bagaimana kata kunci yang ditentukan dicocokkan field opsional nilai yang mungkin: word_match - pencarian teks lengkap untuk istilah yang cocok dengan kata kunci benih yang ditentukan dengan kata tambahan sebelum, sesudah, atau di dalam frasa kunci (misalnya, penelusuran "light" akan mengembalikan hasil dengan "light bulb", "light switch"); partial_match - pencarian substring yang menemukan semua kemunculan yang berisi urutan karakter yang ditentukan, meskipun muncul di dalam kata yang lebih panjang (misalnya, penelusuran "light" akan mengembalikan hasil dengan "lighting", "highlight"); 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.

    • filters
      Tipe: array

      array parameter filter hasil field opsional Anda dapat menambahkan beberapa filter sekaligus (maksimal 8 filter) Anda harus menetapkan operator logika and, 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 atau lebih karakter contoh: ["ai_search_volume",">","1000"] Daftar lengkap filter yang mungkin tersedia di sini.

    • 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

    • limit
      Tipe: integer

      jumlah maksimum objek yang dikembalikan field opsional nilai default: 100 nilai maksimum: 1000

    • 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

    • offset
      Tipe: integer

      offset dalam array hasil data mentions yang dikembalikan field opsional nilai default: 0 contoh: jika Anda menentukan nilai 10, sepuluh objek mentions pertama dalam array hasil akan dilewati dan data akan disediakan untuk objek berikutnya; Catatan: nilai maksimum adalah 9.000, gunakan search_after_token jika Anda ingin mengambil lebih banyak hasil

    • order_by
      Tipe: array string[]

      aturan pengurutan hasil field opsional Anda dapat menggunakan nilai yang sama seperti di array filters untuk mengurutkan hasil jenis pengurutan yang mungkin: asc - hasil akan diurutkan dalam urutan menaik desc - hasil akan diurutkan dalam urutan menurun Anda harus menggunakan koma untuk menyiapkan jenis pengurutan contoh: ["ai_search_volume,desc"] perhatikan bahwa Anda tidak dapat menetapkan lebih dari tiga aturan pengurutan dalam satu permintaan Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan

    • 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

    • search_after_token
      Tipe: string

      token untuk permintaan berikutnya field opsional disediakan di field yang sama pada respons setiap permintaan; gunakan parameter ini untuk menghindari timeout saat mencoba memperoleh lebih dari 20.000 hasil dalam satu permintaan; dengan menentukan nilai search_after_token unik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal; nilai search_after_token unik untuk setiap tugas berikutnya ; Catatan: jika search_after_token ditentukan dalam permintaan, semua parameter lain harus identik dengan permintaan sebelumnya

    • 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.current_offset
      Tipe: integer

      jumlah objek mentions yang dilewati dalam array items

    • tasks.result.items
      Tipe: array string[]

      berisi data mentions yang relevan

    • tasks.result.items_count
      Tipe: integer

      jumlah hasil yang dikembalikan dalam array items

    • tasks.result.items.ai_search_volume
      Tipe: integer

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

    • tasks.result.items.answer
      Tipe: string

      jawaban relevan dalam format markdown konten hasil yang diformat dalam bahasa markup markdown

    • tasks.result.items.brand_entities
      Tipe: array string[]

      array entitas merek berisi informasi tentang merek yang disebutkan dalam respons

    • tasks.result.items.brand_entities.category
      Tipe: string

      kategori merek

    • tasks.result.items.brand_entities.position
      Tipe: integer

      posisi dalam hasil

    • tasks.result.items.brand_entities.title
      Tipe: string

      nama merek

    • tasks.result.items.fan_out_queries
      Tipe: array string[]

      array kueri fan-out berisi kueri penelusuran terkait yang diturunkan dari kueri utama untuk memberikan respons yang lebih komprehensif

    • tasks.result.items.first_response_at
      Tipe: string

      tanggal dan waktu data respons pertama kali dicatat 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
      Tipe: string

      kode bahasa dalam array POST

    • tasks.result.items.last_response_at
      Tipe: string

      tanggal dan waktu data respons terakhir diperbarui 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
      Tipe: integer

      kode lokasi dalam array POST

    • tasks.result.items.model_name
      Tipe: string

      nama model AI asal data diambil Catatan: untuk jenis platform google, nilainya selalu google_ai_overview

    • tasks.result.items.monthly_searches
      Tipe: array string[]

      tingkat volume penelusuran AI bulanan array objek dengan tingkat volume penelusuran AI pada bulan tertentu dalam setahun

    • tasks.result.items.monthly_searches.month
      Tipe: integer

      bulan

    • tasks.result.items.monthly_searches.search_volume
      Tipe: integer

      tingkat volume penelusuran AI pada bulan tertentu dalam setahun pelajari lebih lanjut tentang metrik ini di sini

    • tasks.result.items.monthly_searches.year
      Tipe: integer

      tahun

    • tasks.result.items.platform
      Tipe: string

      platform yang diterima dalam array POST

    • tasks.result.items.question
      Tipe: string

      pertanyaan relevan

    • tasks.result.items.search_results
      Tipe: array string[]

      array hasil penelusuran semua keluaran penelusuran web yang diambil model saat mencari informasi, termasuk duplikat dan entri yang tidak digunakan

    • tasks.result.items.search_results.breadcrumb
      Tipe: string

      navigasi breadcrumb

    • tasks.result.items.search_results.description
      Tipe: string

      deskripsi hasil

    • tasks.result.items.search_results.domain
      Tipe: string

      domain hasil

    • tasks.result.items.search_results.position
      Tipe: integer

      posisi dalam hasil

    • tasks.result.items.search_results.publication_date
      Tipe: string

      tanggal dan waktu 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
      Tipe: string

      judul hasil

    • tasks.result.items.search_results.url
      Tipe: string

      URL hasil

    • tasks.result.items.sources
      Tipe: array string[]

      array sumber sumber yang dikutip atau dijadikan rujukan model dalam jawaban akhirnya

    • tasks.result.items.sources.domain
      Tipe: string

      domain sumber

    • tasks.result.items.sources.markdown
      Tipe: string

      konten elemen dalam format markdown konten hasil yang diformat dalam bahasa markup markdown

    • tasks.result.items.sources.position
      Tipe: integer

      posisi dalam hasil

    • tasks.result.items.sources.publication_date
      Tipe: string

      tanggal dan waktu 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
      Tipe: string

      deskripsi sumber

    • tasks.result.items.sources.source_name
      Tipe: string

      nama sumber

    • tasks.result.items.sources.thumbnail
      Tipe: string

      thumbnail sumber

    • tasks.result.items.sources.title
      Tipe: string

      judul sumber

    • tasks.result.items.sources.url
      Tipe: string

      URL sumber

    • tasks.result.search_after_token
      Tipe: string

      token untuk permintaan berikutnya dengan menentukan search_after_token unik saat menyiapkan tugas baru, Anda akan mendapatkan hasil berikutnya dari tugas awal; nilai search_after_token unik untuk setiap tugas berikutnya

    • tasks.result.total_count
      Tipe: integer

      jumlah total hasil yang relevan dengan permintaan

    • 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
Request Example for 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": ""
  }
]'

{
  "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 berhasil

Live LLM Mentions