Content Analysis – puan dağılımı API'si
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – puan dağılımı API'si
Bir anahtar kelimenin atıflarını puan aralıklarına böler ve her biri için tam metrik kümesini raporlar. Her aralık için min, max ve total_count, rank, top_domains (her biri domain ve count), sentiment_connotations (öfke, mutluluk, sevgi, üzüntü, paylaşım, eğlence), connotation_types (olumlu, olumsuz, nötr), text_categories, page_categories, page_types, countries ve languages alanlarını taşıyan bir metrics nesnesi içeren bir giriş döndürür. Aralıklara bölmeyi rank_scale seçer. Aynı metriklerin aralıklara bölünmemiş hali için post_dataforseo_content_summary_live; yalnızca duygu durumu için post_dataforseo_content_sentiment_analysis_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.
- Tür: array (object | null)[]
- initialTür: array (object | null)[] | null
_dataset _filters başlangıç veri kümesi filtreleme parametreleri
isteğe bağlı alan
Search uç noktasındaki alanlara uygulanan başlangıç filtreleme parametreleri
aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre)
koşullar arasındaand,ormantıksal operatörünü ayarlamalısınız
şu operatörler desteklenir:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match%operatörünülikevenot_likeile kullanarak sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşebilirsiniz
örnek:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
filtreler hakkında daha fazla bilgi için Content Analysis API - Filters sayfasına bakın
başlangıç veri kümesi filtreleri hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın.Boş nesne - internalTür: integer | null
_list _limit iç dizilerdeki maksimum öğe sayısı
isteğe bağlı alan
bu alanı, aşağıdaki dizilerdeki öğe sayısını sınırlamak için kullanabilirsiniz:top_domainstext_categoriespage_categoriescountrieslanguages
varsayılan değer:1
maksimum değer:20 - keywordTü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
keywordvekeywordsalanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın - keywordTür: object | null
_fields 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>}- propertyTür: string | null
Name
- pageTür: array string[] | null
_type 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" - positiveTür: number | null
_connotation _threshold pozitif konotasyon eşiği
isteğe bağlı alan
alıntı içeriğiyle ilişkili pozitif duygu için olasılık indeksi eşiği olarak belirtilir
bu alanı belirtirseniz, yanıttakiconnotation_typesnesnesi yalnızcapositiveduygu olasılığı belirtilen değere eşit veya daha büyük olan alıntılara ilişkin verileri içerir
olası değerler:0ile1arası
varsayılan değer:0.4 - rankTür: string | null
_scale rankdeğerlerini hesaplamak ve görüntülemek için kullanılan ölçeği tanımlar
isteğe bağlı alanbu 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ülenirone_thousand— rank değerleri 0–1000 ölçeğinde görüntülenirvarsayılan değer:
one_thousandbu parametrenin nasıl çalıştığı hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın
- searchTür: string | null
_mode sonuç gruplama türü
isteğe bağlı alan
olası gruplama türleri:as_is- hedefkeywordiçin tüm alıntıları döndürürone_per_domain- etki alanı başına birkeywordalıntısı döndürür
varsayılan değer:as_is - sentimentsTür: number | null
_connotation _threshold duygu konotasyonu eşiği
isteğe bağlı alan
alıntı içeriğiyle ilişkili duygu konotasyonları için olasılık indeksi eşiği olarak belirtilir
bu alanı belirtirseniz, yanıttakisentiment_connotationsnesnesi yalnızca her duygu için olasılığın belirtilen değere eşit veya daha büyük olduğu alıntılara ilişkin verileri içerir
olası değerler:0ile1arası
varsayılan değer:0.4 - tagTü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
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- maxTür: number | null
dağılım ölçeğindeki maksimum puan
- metricsTür: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
puan dağılımı metriklerini içerir
- connotationTür: object | null
_types konotasyon türleri
anahtar sözcük alıntısıyla ilgili duygu türlerini (duygu polaritesi) ve her duygu türü başına alıntı sayısını içerir
olası duygu konotasyonu türleri:positive,negative,neutral- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- countriesTür: object | null
- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- languagesTür: object | null
- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- pageTür: array (object | null)[] | null
_categories - categoryTür: array (integer | null)[] | null
- countTür: integer | null Biçim: int64
Signed 64-bit integers (long type).
- pageTür: object | null
_types sayfa türleri
sayfa türlerini ve her sayfa türü başına alıntı sayısını içerir- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- rankTür: integer | null
keywordifadesini alıntılayan tüm URL'lerin sıralaması
hedefkeywordifadesini alıntılayan tüm URL'lerin normalleştirilmiş sıralama toplamı - sentimentTür: object | null
_connotations duygu konotasyonları
hedef anahtar sözcük alıntısıyla ilgili duyguları (duygusal tepkiler) ve her duygu başına alıntı sayısını içerir
olası duygu konotasyonları:anger,happiness,love,sadness,share,fun- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- textTür: array (object | null)[] | null
_categories - categoryTür: array (integer | null)[] | null
- countTür: integer | null Biçim: int64
Signed 64-bit integers (long type).
- topTür: array (object | null)[] | null
_domains hedef anahtar sözcüğü alıntılayan önde gelen alan adları
hedef anahtar sözcüğü alıntılayan önde gelen alan adlarını ve her alan adı başına alıntı sayısını içeren nesneler içerir- countTür: integer | null Biçim: int64
Signed 64-bit integers (long type).
- domainTür: string | null
- totalTür: integer | null Biçim: int64
_count veritabanımızda isteğinizle ilgili toplam sonuç sayısı
- typeTür: string | null
öğe türü
- minTür: number | null
dağılım ölçeğindeki minimum puan
- typeTür: string | null
öğe türü
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"internal_list_limit": 10
}
]'
{
"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": [
{
"type": null,
"min": null,
"max": null,
"metrics": {
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
"[Max Depth Exceeded]"
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
"[Max Depth Exceeded]"
],
"page_categories": [
"[Max Depth Exceeded]"
],
"page_types": null,
"countries": null,
"languages": null
}
}
]
}
]
}