DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
API Ringkasan – Analisis Kandungan
Pandangan agregat bagi setiap sitasi sesuatu kata kunci merentas indeks web. Memulangkan total_count, rank, top_domains (setiap satu domain dan count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries dan languages. Ini ialah hab keluarga kandungan: post_dataforseo_content_sentiment_analysis_live hanya memulangkan dua blok konotasi yang sudah termasuk di sini, jadi panggil endpoint ini melainkan anda memang mahukan muatan yang lebih kecil. Untuk halaman penyitasi individu dan bukan jumlah, gunakan post_dataforseo_content_search_live; untuk agregat yang sama dari semasa ke semasa, post_dataforseo_content_phrase_trends_live.
Rujukan harga
- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,0276.
- Pengganda rujukan pelanggan: 1,0. Jangan gunakannya semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- initialJenis: array (object | null)[] | null
_dataset _filters parameter penapisan set data awal
medan pilihan
parameter penapisan awal yang digunakan pada medan dalam Search endpoint
anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
anda harus menetapkan operator logikand,orantara syarat
operator berikut disokong:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not
anda boleh menggunakan operator%denganlikedannot_likeuntuk memadankan sebarang rentetan dengan sifar atau lebih aksara
contoh:["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]]]
untuk maklumat lanjut tentang penapis, rujuk API Analisis Kandungan - Penapis
ketahui lebih lanjut tentang penapis set data awal dalam artikel pusat bantuan ini.Objek kosong - internalJenis: integer | null
_list _limit bilangan maksimum elemen dalam array dalaman
medan pilihan
anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam array berikut:top_domainstext_categoriespage_categoriescountrieslanguages
nilai lalai:1
nilai maksimum:20 - keywordJenis: string
kata kunci sasaran
medan wajib
pengekodan UTF-8
kata kunci akan ditukar kepada format huruf kecil;
Nota: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik;
contoh:"keyword": ""tesla palo alto""ketahui lebih lanjut tentang peraturan dan had medan
keyworddankeywordsdalam API DataForSEO dalam artikel Pusat Bantuan ini - keywordJenis: object | null
_fields medan kata kunci sasaran dan kata kunci sasaran
medan pilihan
gunakan parameter ini untuk menapis set data mengikut kata kunci yang perlu terkandung dalam medan tertentu;
medan yang boleh anda tentukan:title,main_title,previous_title,snippet
anda boleh menyatakan beberapa medan;
Nota: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik;
contoh:"keyword_fields": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- propertyJenis: string | null
Name
- pageJenis: array string[] | null
_type jenis halaman sasaran
medan pilihan
gunakan parameter ini untuk menapis set data mengikut jenis halaman
nilai yang mungkin:"ecommerce","news","blogs","message-boards","organization" - positiveJenis: number | null
_connotation _threshold ambang konotasi positif
medan pilihan
dinyatakan sebagai ambang indeks kebarangkalian untuk sentimen positif berkaitan kandungan sitasi
jika anda menentukan medan ini, objekconnotation_typesdalam respons hanya akan mengandungi data sitasi dengan kebarangkalian sentimenpositivelebih besar daripada atau sama dengan nilai yang ditentukan
nilai yang mungkin: daripada0hingga1
nilai lalai:0.4 - rankJenis: string | null
_scale menentukan skala yang digunakan untuk mengira dan memaparkan nilai
rank
medan pilihananda boleh menggunakan parameter ini untuk memilih sama ada nilai rank dipaparkan pada skala 0–100 atau 0–1000
nilai yang mungkin:
one_hundred— nilai rank dipaparkan pada skala 0–100one_thousand— nilai rank dipaparkan pada skala 0–1000nilai lalai:
one_thousandketahui lebih lanjut tentang cara parameter ini berfungsi dalam artikel Pusat Bantuan ini
- sentimentsJenis: number | null
_connotation _threshold ambang konotasi sentimen
medan pilihan
dinyatakan sebagai ambang indeks kebarangkalian untuk konotasi sentimen berkaitan kandungan sitasi
jika anda menentukan medan ini, objeksentiment_connotationsdalam respons hanya akan mengandungi data sitasi yang
kebarangkalian setiap sentimennya lebih besar daripada atau sama dengan nilai yang ditentukan
nilai yang mungkin: daripada0hingga1
nilai lalai:0.4 - tagJenis: string | null
pengecam tugas yang ditentukan pengguna
medan pilihan
had aksara ialah 255
anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
anda akan menemui nilaitagyang ditentukan dalam objekdatarespons
- Jenis: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
tatasusunan tugas
- Jenis: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: array (object | null)[] | null
tatasusunan hasil
- connotationJenis: object | null
_types jenis konotasi
mengandungi jenis sentimen (polariti sentimen) berkaitan petikan kata kunci dan bilangan petikan bagi setiap jenis sentimen
jenis konotasi sentimen tersedia:positive,negative,neutral- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countriesJenis: object | null
- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- languagesJenis: object | null
- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- pageJenis: array (object | null)[] | null
_categories - categoryJenis: array (integer | null)[] | null
- countJenis: integer | null Format: int64
Signed 64-bit integers (long type).
- pageJenis: object | null
_types jenis halaman
mengandungi jenis halaman dan bilangan petikan bagi setiap jenis halaman- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- rankJenis: integer | null
kedudukan semua URL yang memetik
keyword
jumlah ternormal bagi kedudukan semua URL yang memetikkeywordsasaran - sentimentJenis: object | null
_connotations konotasi sentimen
mengandungi sentimen (reaksi emosi) berkaitan petikan kata kunci sasaran dan bilangan petikan bagi setiap sentimen
konotasi sentimen tersedia:anger,happiness,love,sadness,share,fun- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- textJenis: array (object | null)[] | null
_categories - categoryJenis: array (integer | null)[] | null
- countJenis: integer | null Format: int64
Signed 64-bit integers (long type).
- topJenis: array (object | null)[] | null
_domains domain teratas yang memetik kata kunci sasaran
mengandungi objek dengan domain teratas yang memetik kata kunci sasaran dan bilangan petikan bagi setiap domain- countJenis: integer | null Format: int64
Signed 64-bit integers (long type).
- domainJenis: string | null
- totalJenis: integer | null Format: int64
_count jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda
- typeJenis: string | null
jenis elemen
- resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 0.5
}
]'
{
"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,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}