v0.2.0-beta

OpenAPI 3.1.0

SERP API AI Özeti

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

post/v1/beta/dataforseo/serp/ai_summary

SERP API AI Özeti

Google'da bir sorgu için sonuçların üzerinde gösterilen AI genel bakışını döndürür. keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ve items döndürür. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür.

Fiyatlandırma referansı

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

Yalnızca referans üst verisidir; 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

application/json

Tür: array (object | null)[]
- fetch_content
  Tür: boolean | null
  
  SERP'lerdeki sayfalardan içerik getir
  isteğe bağlı alan
  true olarak ayarlanırsa API, SERP sonuçlarında yer alan sayfalardan içeriği getirir ve AI modeli sonuçtaki özeti oluştururken bu içeriği dikkate alır;
  varsayılan değer: false
- include_links
  Tür: boolean | null
  
  özet içine kaynak bağlantılarını dahil et
  isteğe bağlı alan
  true olarak ayarlanırsa API yanıtındaki summary alanı oluşturulan özetin kaynaklarına bağlantılar içerir;
  varsayılan değer: false
- prompt
  Tür: string | null
  
  AI prompt
  isteğe bağlı alan
  AI özetleyici için ek görev;
  AI'ya hangi yanıtı aradığınızı ileten her türlü metin, soru veya bilgi;
  belirtebileceğiniz maksimum sembol veya karakter sayısı: 2000;
  not: prompt'unuz SERP API'ye yapılan POST isteğinde belirtilen anahtar kelimeyle ilgili olmalıdır
- support_extra
  Tür: boolean | null
  
  ek SERP özelliklerini destekle
  isteğe bağlı alan
  true olarak ayarlanırsa AI modeli organic sonuçlara ek olarak şu ek SERP özelliklerini dikkate alır: answer_box, knowledge_graph, featured_snippet;
  varsayılan değer: true
- task_id
  Tür: string
  
  görev tanımlayıcısı
  zorunlu alan
  ilişkili görevin UUID biçimindeki benzersiz tanımlayıcısı
  görevin sonuçlarını istediğiniz zaman istemek için 30 gün boyunca kullanabilirsiniz

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_SerpAiSummaryResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

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

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_SerpAiSummaryTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

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

propertyName
Tür: object | null
id
Tür: string | null

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

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: array (object | null)[] | null

sonuç dizisi

items
Tür: array (object | null)[] | null

öğe dizisi

summary
Tür: string | null

oluşturulan özet
istekte belirtilen parametrelere göre AI modeli tarafından oluşturulan özet

items_count
Tür: integer | null Biçim: int64

sonuç dizisindeki öğe sayısı

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

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

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

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

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

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

post/v1/beta/dataforseo/serp/ai_summary

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/ai_summary \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d",
    "prompt": "explain what DataForSEO is",
    "include_links": true,
    "fetch_content": true
  }
]'

Şemayı göster

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "items_count": null,
          "items": [
            {
              "summary": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

SERP API AI Özeti

Kimlik doğrulamaRequired

DataForSEO

SERP API AI Özeti

Fiyatlandırma referansı