Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Canlı LLM Mentions

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

Canlı LLM Mentions

​

Asistanın hedefinizden bahsettiği tek tek yanıtlar. total_count, current_offset, search_after_token ve items döndürür — ilk sayfalardan sonra offset ile değil, token ile sayfalayın. ⚠️ target bir nesne dizisidir, her biri {"domain": "..."} veya {"keyword": "..."}; çıplak bir dize yanlış tür olarak, dizeler dizisi ise 'Each target item must be an object' hatasıyla reddedilir. Filtre alanları get_dataforseo_ai_llm_mentions_available_filters içinden gelir. DataForSEO zarfı içinde: veriler tasks[0].result, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Bahsetmelerin kendisi yerine sayılar için post_dataforseo_ai_llm_mentions_aggregated_metrics_live kullanın.

Fiyatlandırma referansı

  • Ölçümlendirme: Bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.701.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisi; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
gerekli
application/json
  • Tür: array object[]
    • target
      Tür: array object[]
      gerekli

      hedef varlıkları içeren nesne dizisi — zorunlu alan. target alanında en fazla 10 varlık (nesne) belirtebilirsiniz. Bir hedef varlık ya bir alan adı ya da bir anahtar kelime ve ilgili parametreleri içerebilir. Örnekler: alan adı varlığı içeren target dizisi [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] anahtar kelime varlığı içeren target dizisi [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] birden fazla varlık içeren target dizisi [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          Tür: string
          gerekli

          hedef alan adı — keyword belirtmezseniz zorunlu alan. domain alanında en fazla 63 karakter belirtebilirsiniz; alan adı https:// ve www. olmadan belirtilmelidir.

        • include_subdomains
          Tür: boolean

          hedef alan adının alt alan adlarının aramaya dahil edilip edilmeyeceğini belirtir — isteğe bağlı alan. true olarak ayarlanırsa alt alan adları aramaya dahil edilir. Varsayılan değer: false

        • keyword
          Tür: string

          hedef anahtar kelime — domain belirtmezseniz zorunlu alan. keyword alanında en fazla 250 karakter belirtebilirsiniz. Tüm %## kodları çözülür (‘+’ karakteri boşluk karakteri olarak çözülür). Anahtar kelimeniz için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin; “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin. DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın

        • match_type
          Tür: string

          Hedef anahtar kelime eşleşme türü. Belirtilen anahtar kelimenin nasıl eşleştirileceğini tanımlar. İsteğe bağlı alan. Olası değerler: word_match — belirtilen tohum anahtar kelimeyle eşleşen terimler için, anahtar ifadenin önünde, arkasında veya içinde ek sözcükler bulunan tam metin araması (ör. “light” araması “light bulb”, “light switch” sonuçlarını döndürür); partial_match — daha uzun bir sözcüğün içinde görünse bile belirtilen karakter dizisini içeren tüm örnekleri bulan alt dize araması (ör. “light” araması “lighting”, “highlight” sonuçlarını döndürür); varsayılan değer: word_match.

        • search_filter
          Tür: string

          Varlık arama filtresi: include veya exclude; varsayılan olarak include.

        • search_scope
          Tür: array string[]

          Arama kapsamı. Alan adı varlıkları: any, sources, search_results. Anahtar kelime varlıkları: any, question, answer, brand_entities, fan_out_queries. Varsayılan: any.

    • filters
      Tür: array

      Sonuç filtreleme parametreleri dizisi. İsteğe bağlı alan. Aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre). Koşullar arasında and veya or mantıksal operatörünü ayarlamalısınız. Desteklenen operatörler: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. % operatörünü like ve not_like ile kullanarak sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşebilirsiniz. Örnek: ["ai_search_volume",">","1000"]. Olası filtrelerin tam listesi burada mevcuttur.

    • language_code
      Tür: string

      arama dil kodu — isteğe bağlı alan. Bu alanı kullanırsanız language_name belirtmeniz gerekmez; arama motorunun mevcut dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages adresinden alabilirsiniz. Varsayılan değer: en. Not: chat_gpt verileri yalnızca en için kullanılabilir

    • language_name
      Tür: string

      arama dilinin tam adı — isteğe bağlı alan. Bu alanı kullanırsanız language_code belirtmeniz gerekmez; bu alanı belirtmezseniz varsayılan olarak en değerine sahip language_code kullanılır; arama motorunun mevcut dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages adresinden alabilirsiniz. Not: chat_gpt verileri yalnızca İngilizce için kullanılabilir

    • limit
      Tür: integer

      Döndürülen maksimum nesne sayısı. İsteğe bağlı alan. Varsayılan değer: 100. Maksimum değer: 1000.

    • location_code
      Tür: integer

      arama konum kodu — isteğe bağlı alan. Bu alanı kullanırsanız location_name belirtmeniz gerekmez. Arama motorunun mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages adresinden alabilirsiniz. Varsayılan değer: 2840. Not: chat_gpt verileri yalnızca 2840 için kullanılabilir

    • location_name
      Tür: string

      arama konumunun tam adı — isteğe bağlı alan. Bu alanı kullanırsanız location_code belirtmeniz gerekmez; bu alanı belirtmezseniz varsayılan olarak 2840 değerine sahip location_code kullanılır; arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages adresinden alabilirsiniz. Not: chat_gpt verileri yalnızca Amerika Birleşik Devletleri için kullanılabilir

    • offset
      Tür: integer

      Döndürülen bahsetme verilerinin sonuç dizisindeki offset. İsteğe bağlı alan. Varsayılan değer: 0. Örnek: 10 değerini belirtirseniz sonuç dizisindeki ilk on bahsetme nesnesi atlanır ve veriler sonraki nesneler için sağlanır. Not: maksimum değer 9.000'dir; daha fazla sonuç atlamak istiyorsanız search_after_token kullanın.

    • order_by
      Tür: array string[]

      Sonuç sıralama kuralları. İsteğe bağlı alan. Sonuçları sıralamak için filters dizisindekiyle aynı değerleri kullanabilirsiniz. Olası sıralama türleri: asc — sonuçlar artan düzende sıralanır; desc — sonuçlar azalan düzende sıralanır. Sıralama türünü ayarlamak için virgül kullanmalısınız. Örnek: ["ai_search_volume,desc"]. Tek bir istekte en fazla üç sıralama kuralı ayarlayabileceğinizi unutmayın; birden çok sıralama kuralını virgülle ayırmalısınız.

    • platform
      Tür: string

      hedef platform — isteğe bağlı alan. Olası değerler: chat_gpt, google. Varsayılan değer: google. Not: döndürülen veriler seçilen platforma bağlıdır. Not 2: chat_gpt verileri yalnızca Amerika Birleşik Devletleri ve İngilizce için kullanılabilir

    • search_after_token
      Tür: string

      Sonraki istekler için token. İsteğe bağlı alan. Her isteğin yanıtında aynı alanda sağlanır. Tek bir istekte 20.000'den fazla sonuç alırken zaman aşımlarını önlemek için bu parametreyi kullanın. Yanıt dizisindeki benzersiz search_after_token değerini belirterek ilk görevin sonraki sonuçlarını alırsınız. search_after_token değerleri her sonraki görev için benzersizdir. Not: istekte search_after_token belirtilirse diğer tüm parametreler önceki istekle aynı olmalıdır.

    • tag
      Tür: string

      kullanıcı tanımlı görev tanımlayıcısı — isteğe bağlı alan. Karakter sınırı 255. Bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz. Belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar
  • 200
    Tür: object

    Başarılı yanıt

    • cost
      Tür: number

      toplam görev maliyeti, USD

    • status_code
      Tür: integer

      genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz

    • status_message
      Tür: string

      genel bilgilendirme mesajı. Genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array string[]

      görev dizisi

    • tasks_count
      Tür: integer

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer

      tasks dizisinde hata ile dönen görev sayısı

    • tasks.cost
      Tür: number

      görevin maliyeti, USD

    • tasks.data
      Tür: object

      POST isteğinde belirttiğiniz parametrelerin aynısını içerir

    • tasks.id
      Tür: string

      görev tanımlayıcısı. Sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

    • tasks.path
      Tür: array string[]

      URL yolu

    • tasks.result
      Tür: array string[]

      sonuç dizisi

    • tasks.result_count
      Tür: integer

      result dizisindeki öğe sayısı

    • tasks.result.current_offset
      Tür: integer

      items dizisinde atlanan bahsetme nesnesi sayısı.

    • tasks.result.items
      Tür: array string[]

      İlgili bahsetme verilerini içerir.

    • tasks.result.items_count
      Tür: integer

      items dizisinde döndürülen sonuç sayısı.

    • tasks.result.items.ai_search_volume
      Tür: integer

      bir anahtar kelimenin güncel AI arama hacmi oranı. Bu metrik hakkında daha fazla bilgiyi burada bulabilirsiniz

    • tasks.result.items.answer
      Tür: string

      Markdown biçiminde ilgili yanıt. Sonucun markdown işaretleme diliyle biçimlendirilmiş içeriği.

    • tasks.result.items.brand_entities
      Tür: array string[]

      Marka varlıkları dizisi. Yanıtta bahsedilen markalarla ilgili bilgileri içerir.

    • tasks.result.items.brand_entities.category
      Tür: string

      Markanın kategorisi.

    • tasks.result.items.brand_entities.position
      Tür: integer

      Sonuçlardaki konum.

    • tasks.result.items.brand_entities.title
      Tür: string

      Markanın adı.

    • tasks.result.items.fan_out_queries
      Tür: array string[]

      Fan-out sorguları dizisi. Daha kapsamlı bir yanıt sağlamak için ana sorgudan türetilen ilgili arama sorgularını içerir.

    • tasks.result.items.first_response_at
      Tür: string

      Yanıt verilerinin ilk kaydedildiği tarih ve saat, UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”. Örnek: 2025-10-21 06:25:30 +00:00.

    • tasks.result.items.language_code
      Tür: string

      POST dizisindeki dil kodu.

    • tasks.result.items.last_response_at
      Tür: string

      Yanıt verilerinin son güncellendiği tarih ve saat, UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”. Örnek: 2025-10-21 06:25:30 +00:00.

    • tasks.result.items.location_code
      Tür: integer

      POST dizisindeki konum kodu.

    • tasks.result.items.model_name
      Tür: string

      Verilerin alındığı AI modelinin adı. Not: google platform türü için değer her zaman google_ai_overview'dir.

    • tasks.result.items.monthly_searches
      Tür: array string[]

      Aylık AI arama hacmi oranları. Yılın belirli bir ayındaki AI arama hacmi oranlarını içeren nesne dizisi.

    • tasks.result.items.monthly_searches.month
      Tür: integer

      Ay.

    • tasks.result.items.monthly_searches.search_volume
      Tür: integer

      Yılın belirli bir ayındaki AI arama hacmi oranı. Bu metrik hakkında daha fazlasını burada bulabilirsiniz.

    • tasks.result.items.monthly_searches.year
      Tür: integer

      Yıl.

    • tasks.result.items.platform
      Tür: string

      POST dizisinde alınan platform.

    • tasks.result.items.question
      Tür: string

      İlgili soru.

    • tasks.result.items.search_results
      Tür: array string[]

      Arama sonuçları dizisi. Modelin bilgi ararken aldığı tüm web araması çıktıları; kopyalar ve kullanılmayan girişler dahil.

    • tasks.result.items.search_results.breadcrumb
      Tür: string

      Gezinme yolu.

    • tasks.result.items.search_results.description
      Tür: string

      Sonuç açıklaması.

    • tasks.result.items.search_results.domain
      Tür: string

      Sonuç alan adı.

    • tasks.result.items.search_results.position
      Tür: integer

      Sonuçlardaki konum.

    • tasks.result.items.search_results.publication_date
      Tür: string

      Sonucun yayımlandığı tarih ve saat, şu biçimde: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Örnek: 2019-11-15 12:57:46 +00:00.

    • tasks.result.items.search_results.title
      Tür: string

      Sonuç başlığı.

    • tasks.result.items.search_results.url
      Tür: string

      Sonuç URL'si.

    • tasks.result.items.sources
      Tür: array string[]

      Kaynaklar dizisi. Modelin son yanıtında atıfta bulunduğu veya dayandığı kaynaklar.

    • tasks.result.items.sources.domain
      Tür: string

      Kaynak alan adı.

    • tasks.result.items.sources.markdown
      Tür: string

      Öğenin Markdown biçimindeki içeriği. Sonucun markdown işaretleme diliyle biçimlendirilmiş içeriği.

    • tasks.result.items.sources.position
      Tür: integer

      Sonuçlardaki konum.

    • tasks.result.items.sources.publication_date
      Tür: string

      Sonucun yayımlandığı tarih ve saat, şu biçimde: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. Örnek: 2019-11-15 12:57:46 +00:00.

    • tasks.result.items.sources.snippet
      Tür: string

      Kaynak açıklaması.

    • tasks.result.items.sources.source_name
      Tür: string

      Kaynak adı.

    • tasks.result.items.sources.thumbnail
      Tür: string

      Kaynak küçük resmi.

    • tasks.result.items.sources.title
      Tür: string

      Kaynak başlığı.

    • tasks.result.items.sources.url
      Tür: string

      Kaynak URL'si.

    • tasks.result.search_after_token
      Tür: string

      Sonraki istekler için token. Yeni bir görev ayarlarken benzersiz search_after_token belirterek ilk görevin sonraki sonuçlarını alırsınız. search_after_token değerleri her sonraki görev için benzersizdir.

    • tasks.result.total_count
      Tür: integer

      İstekle ilgili toplam sonuç sayısı.

    • tasks.status_code
      Tür: integer

      DataForSEO tarafından oluşturulan görev durum kodu; şu aralıkta olabilir: 10000-60000. Yanıt kodlarının tam listesini burada bulabilirsiniz

    • tasks.status_message
      Tür: string

      görevin bilgilendirme mesajı. Genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks.time
      Tür: string

      yürütme süresi, saniye

    • time
      Tür: string

      yürütme süresi, saniye

    • version
      Tür: string

      API'nin geçerli sürümü

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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

Başarılı yanıt

Live LLM Mentions