v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – arama API'si

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

Content Analysis – arama API'si

Bir anahtar kelimeye atıf yapan tek tek sayfaları listeler, toplamları değil. Her öğe url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score ve page_category ile birlikte total_count ve items_count taşır. filters, get_dataforseo_content_available_filters tarafından listelenen alanları kabul eder. Sayfalar yerine sayımlar ve dağılımlar için post_dataforseo_content_summary_live kullanın.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek maliyeti tahmini: USD 0.0276.
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)[]
- filters
  Tür: array (object | null)[] | null
  
  sonuç filtreleme parametreleri dizisi
  isteğe bağlı alan
  aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre)
  koşullar arasında and, or mantıksal operatörünü ayarlamalısınız
  şu operatörler desteklenir:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, 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:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  filtreler hakkında daha fazla bilgi için Content Analysis API - Filters sayfasına bakın
  
  Boş nesne
- keyword
  Tür: string
  
  hedef anahtar kelime
  zorunlu alan
  UTF-8 kodlaması
  anahtar kelimeler küçük harf biçimine dönüştürülür;
  Not: tek başına bir anahtar kelime yerine tam bir ifadeyle eşleşmek için çift tırnak ve ters eğik çizgi kullanın;
  örnek:
  "keyword": "\"tesla palo alto\""
  
  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
- keyword_fields
  Tür: object | null
  
  hedef anahtar kelime alanları ve hedef anahtar kelimeler
  isteğe bağlı alan
  bu parametreyi, belirli alanların içermesi gereken anahtar kelimelere göre veri kümesini filtrelemek için kullanın;
  belirtebileceğiniz alanlar: title, main_title, previous_title, snippet
  birkaç alan belirtebilirsiniz;
  Not: tek başına bir anahtar kelime yerine tam bir ifadeyle eşleşmek için çift tırnak ve ters eğik çizgi kullanın;
  örnek:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  Tür: string | null
- limit
  Tür: integer | null
  
  döndürülen maksimum alıntı sayısı
  isteğe bağlı alan
  varsayılan değer: 100
  maksimum değer: 1000
- offset
  Tür: integer | null
  
  döndürülen alıntıların sonuç dizisindeki offset
  isteğe bağlı alan
  varsayılan değer: 0
  10 değerini belirtirseniz, sonuç dizisindeki ilk on alıntı atlanır ve veriler sonraki alıntılar için sağlanır
  Not: bu parametreyi yalnızca 10.000'e kadar sonuç alırken kullanmanızı öneririz
  10.000'in üzerinde sonuç almak için bunun yerine offset_token kullanın.
- offset_token
  Tür: string | null
  
  sonraki istekler için offset token
  isteğe bağlı alan
  her isteğin yanıtındaki aynı alanda sağlanır;
  tek bir istekte 10.000'in üzerinde sonuç almaya çalışırken zaman aşımlarını önlemek için bu parametreyi kullanın;
  yanıt dizisindeki benzersiz offset_token değerini belirterek başlangıç görevinin sonraki sonuçlarını alırsınız;
  offset_token değerleri her sonraki görev için benzersizdir
  Not: istekte offset_token belirtilirse, görev işlenirken limit dışındaki tüm diğer parametreler dikkate alınmaz
  bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz
- order_by
  Tür: array string[] | null
  
  sonuç sıralama kuralları
  isteğ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:
  ["content_info.sentiment_connotations.anger,desc"]
  varsayılan kural:
  ["content_info.sentiment_connotations.anger,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
  örnek:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  Tür: array string[] | null
  
  hedef sayfa türleri
  isteğe bağlı alan
  veri kümesini sayfa türlerine göre filtrelemek için bu parametreyi kullanın
  olası değerler:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  Tür: string | null
  
  domain_rank ve url_rank değerlerini hesaplamak ve görüntülemek için kullanılan ölçeği tanımlar
  isteğe bağlı alan
  
  bu parametreyi, rank değerlerinin 0–100 veya 0–1000 ölçeğinde sunulup sunulmayacağını seçmek için kullanabilirsiniz
  
  olası değerler:
  one_hundred — rank değerleri 0–100 ölçeğinde görüntülenir
  one_thousand — rank değerleri 0–1000 ölçeğinde görüntülenir
  
  varsayılan değer: one_thousand
  
  bu parametrenin nasıl çalıştığı hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın
- search_mode
  Tür: string | null
  
  sonuç gruplama türü
  isteğe bağlı alan
  olası gruplama türleri:
  as_is - hedef keyword için tüm alıntıları döndürür
  one_per_domain - etki alanı başına bir keyword alıntısı döndürür
  varsayılan değer: as_is
- tag
  Tür: string | null
  
  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 | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
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_ContentAnalysisSearchLiveTaskInfo
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

alıntıları ve ilgili verileri içerir

content_info
Tür: object | null · Response36Afe1097B20_AnalysisContentInfo

belirli url adresinden gelen alıntılara ait verileri içerir

author
Tür: string | null

içeriğin yazarı

connotation_types
Tür: object | null

çağrışım türleri
verilen alıntıyla ilişkili duygu türlerini (duygu polaritesi) ve her duygu türü için olasılık indeksini içerir
olası duygu çağrışımı türleri: positive, negative, neutral

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

Signed 64-bit integers (long type).

content_quality_score
Tür: integer | null

içerik kalite puanı
bu değer, içeriğin içerdiği kelime, cümle ve karakter sayısına göre hesaplanır

content_type
Tür: string | null

içerik türü
örnek:
page_content, comment

date_published
Tür: string | null

içeriğin yayımlandığı tarih ve saat
UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00"
örnek:
2017-01-24 13:20:59 +00:00

group_date
Tür: string | null

alıntı grubu tarihi ve saati
içerik yayımlanma tarihini veya crawler'ımızın sayfayı ilk ziyaret ettiği tarih ve saati belirtir;
bu alan, alıntıları tarihe göre gruplamak ve alıntı eğilimlerini göstermek için kullanılabilir;
tarih ve saat UTC biçiminde sağlanır: "yyyy-mm-dd hh-mm-ss +00:00"
örnek:
2017-01-24 13:20:59 +00:00

highlighted_text
Tür: string | null

snippet içinden vurgulanan metin

language
Tür: string | null

alan adının ana dili
mevcut dillerin tam listesi için Languages uç noktasına bakın

level
Tür: integer | null

title başlık düzeyi
h etiketi düzeyini 1 (en üst) ile 6 (en alt) arasında belirtir

main_title
Tür: string | null

sayfa başlığı

previous_title
Tür: string | null

önceki içerik bloğunun başlığı

rating
Tür: object | null · Response36Afe1097B20_ContententRatingInfo

içerik puanı
content_info ile ilgili puan

max_rating_value
Tür: number | null Biçim: double

puan adı için maksimum değer

name
Tür: string | null

puan adı burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax

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

oy sayısı

rating_value
Tür: number | null Biçim: double

puanlamanın değeri

relative_rating
Tür: number | null Biçim: double

göreli puan

semantic_location
Tür: string | null

anlamsal konum
hedef anahtar kelime alıntısının bulunduğu HTML'deki anlamsal öğeyi belirtir
örnek:
article, header

sentiment_connotations
Tür: object | null

duygu çağrışımları
verilen alıntıyla ilişkili duyguları (duygusal tepkiler) ve her duygu için olasılık indeksini içerir
olası duygu çağrışımları: anger, happiness, love, sadness, share, fun

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

Signed 64-bit integers (long type).

snippet
Tür: string | null

içerik parçacığı

snippet_length
Tür: integer | null

parçacığın karakter uzunluğu

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

sosyal medya etkileşim metrikleri
sosyal medya platformları tarafından geliştirilen ve desteklenen web sitesi yerleştirmelerine dayalı olarak içerikle ilişkili sosyal medya etkileşimlerine ait veriler

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

beğeni sayısı

type
Tür: string | null

öğe türü

text_category
Tür: array integer[] | null

metin kategorisi
kullanılabilir kategorilerin tam listesi için Categories uç noktasına bakın

title
Tür: string | null

sonucun başlığı

country
Tür: string | null

alan adı kaydının ülke kodu
mevcut ülkelerin tam listesi için Locations uç noktasına bakın

domain
Tür: string | null

alan adı

domain_rank
Tür: integer | null

domain alan adının sıralaması
bu değer, verilen alan adı için DataForSEO Backlink Index'teki geri bağlantı verilerine dayanır;
domain_rank, bağlantılı bir veritabanındaki düğüm sıralama yöntemine göre hesaplanır — orijinal Google PageRank algoritmasında kullanılan ilke
metrik ve hesaplama yöntemi hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

fetch_time
Tür: string | null

crawler'ımızın sayfayı ziyaret ettiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2017-01-24 13:20:59 +00:00

language
Tür: string | null

alan adının ana dili
mevcut dillerin tam listesi için Languages uç noktasına bakın

main_domain
Tür: string | null

ana alan adı

page_category
Tür: array integer[] | null

ilgili tüm sayfa kategorilerini içerir
sayfayla ilgili ürün ve hizmet kategorileri
mevcut kategorilerin tam listesi için Categories uç noktasına bakın

page_types
Tür: array string[] | null

sayfa türleri

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

sayfada bulunan puanlar
mikroverilere dayalı olarak sayfada bulunan tüm puanlar

max_rating_value
Tür: number | null Biçim: double

puan adı için maksimum değer

name
Tür: string | null

puan adı burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax

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

oy sayısı

rating_value
Tür: number | null Biçim: double

puanlamanın değeri

relative_rating
Tür: number | null Biçim: double

göreli puan

score
Tür: number | null

alıntı belirginlik puanı
bu değer url_rank, domain_rank ve keyword ifadesinin title, main_title, url, snippet içinde bulunmasına dayanır
score ne kadar yüksekse ilgili alıntının değeri o kadar yüksektir

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

sosyal medya etkileşim metrikleri
sosyal medya platformları tarafından geliştirilen ve desteklenen web sitesi yerleştirmelerine dayalı olarak içerikle ilişkili sosyal medya etkileşimlerine ait veriler

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

beğeni sayısı

type
Tür: string | null

öğe türü

spam_score
Tür: integer | null

url adresinin geri bağlantı spam puanı
bu değer, verilen URL için DataForSEO Backlink Index'teki geri bağlantı verilerine dayanır;
metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi sayfasına bakın

type
Tür: string | null

öğe türü

url
Tür: string | null

alıntının bulunduğu URL

url_rank
Tür: integer | null

url adresinin sıralaması
bu değer, verilen URL için DataForSEO Backlink Index'teki geri bağlantı verilerine dayanır;
url_rank, bağlantılı bir veritabanındaki düğüm sıralama yöntemine göre hesaplanır — orijinal Google PageRank algoritmasında kullanılan ilke
metrik ve hesaplama yöntemi hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

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

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

offset_token
Tür: string | null

sonraki istekler için ofset token'ı
bu alanda sağlanan dizeyi, ilk görevin sonraki sonuçlarını almak için kullanabilirsiniz;
not: offset_token değerleri her sonraki görev için benzersizdir

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

veritabanımızda isteğinizle ilgili toplam sonuç 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/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

Ş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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Content Analysis – arama API'si

Kimlik doğrulamaRequired

DataForSEO

Content Analysis – arama API'si

Fiyatlandırma referansı