DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
API Tren Kategori – Analisis Konten
Metrik per periode yang sama seperti post_dataforseo_content_phrase_trends_live, tetapi untuk seluruh kategori produk, bukan satu kata kunci. Mengambil category_code dari get_dataforseo_content_categories, dengan date_from, date_to, dan date_group menetapkan rentang dan granularitas, lalu mengembalikan date beserta total_count, rank, top_domains (masing-masing 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 per periode. Gunakan untuk melihat bagaimana pasar bergerak, bukan satu frasa; beralih ke endpoint frasa jika Anda sudah tahu susunan kata yang tepat.
Referensi harga
- Pengukuran: biaya respons yang dilaporkan.
- Perkiraan referensi per permintaan: USD 0,0276.
- Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.
Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.
- Tipe: array (object | null)[]
- categoryTipe: integer | null
_code - dateTipe: string
_from tanggal mulai rentang waktu
field wajib
nilai minimum:2022-10-31
format tanggal:"yyyy-mm-dd"
contoh:"2019-01-15" - dateTipe: string | null
_group rentang waktu yang akan digunakan untuk mengelompokkan hasil
field opsional
nilai default:month
nilai yang mungkin:day,week,month - dateTipe: string | null
_to tanggal berakhir rentang waktu
field opsional
jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default
format tanggal:"yyyy-mm-dd"
contoh:"2019-01-15" - initialTipe: array (object | null)[] | null
_dataset _filters parameter filter set data awal
field opsional
parameter filter awal yang berlaku untuk field di Search endpoint;
Anda dapat menambahkan beberapa filter sekaligus (maksimal 8 filter)
Anda harus menetapkan operator logikaand,ordi antara kondisi
operator berikut didukung:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not,match,not_match
Anda dapat menggunakan operator%denganlikedannot_likeuntuk mencocokkan string apa pun dengan nol atau lebih karakter
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 informasi selengkapnya tentang filter, lihat API Analisis Konten - Filter
pelajari lebih lanjut tentang filter set data awal di artikel pusat bantuan ini.Objek kosong - internalTipe: integer | null
_list _limit jumlah maksimum elemen dalam array internal
field opsional
Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut:top_domainstext_categoriespage_categoriescountrieslanguages
nilai default:1
nilai maksimum:20 - pageTipe: array string[] | null
_type jenis halaman target
field opsional
gunakan parameter ini untuk memfilter set data berdasarkan jenis halaman
nilai yang mungkin:"ecommerce","news","blogs","message-boards","organization" - rankTipe: string | null
_scale menentukan skala yang digunakan untuk menghitung dan menampilkan nilai
rank
field opsionalAnda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000
nilai yang mungkin:
one_hundred— nilai rank ditampilkan pada skala 0–100one_thousand— nilai rank ditampilkan pada skala 0–1000nilai default:
one_thousandpelajari lebih lanjut tentang cara parameter ini bekerja di artikel Pusat Bantuan ini
- searchTipe: string | null
_mode jenis pengelompokan hasil
field opsional
jenis pengelompokan yang mungkin:as_is- mengembalikan data semua sitasi untukcategory_codetargetone_per_domain- mengembalikan data satu sitasicategory_codeper domain
nilai default:as_is - tagTipe: string | null
pengenal tugas yang ditentukan pengguna
field opsional
batas karakter adalah 255
Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
Anda akan menemukan nilaitagyang ditentukan di objekdatapada respons
- Tipe: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: array (object | null)[] | null
array hasil
- connotationTipe: object | null
_types jenis konotasi
berisi jenis sentimen (polaritas sentimen) yang terkait dengan kutipan kategori dan jumlah kutipan per jenis sentimen
jenis konotasi yang tersedia:"positive","negative","neutral"- propertyTipe: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countriesTipe: object | null
- propertyTipe: integer | null Format: int64
Name Signed 64-bit integers (long type).
- dateTipe: string | null
tanggal penyediaan data
- languagesTipe: object | null
- propertyTipe: integer | null Format: int64
Name Signed 64-bit integers (long type).
- pageTipe: array (object | null)[] | null
_categories - categoryTipe: array (integer | null)[] | null
- countTipe: integer | null Format: int64
Signed 64-bit integers (long type).
- pageTipe: object | null
_types jenis halaman
berisi jenis halaman dan jumlah kutipan per jenis halaman- propertyTipe: integer | null Format: int64
Name Signed 64-bit integers (long type).
- rankTipe: integer | null
peringkat semua URL yang mengutip
keyword
jumlah ternormalisasi peringkat semua URL yang mengutipkeywordtarget untuk tanggal tertentu - sentimentTipe: object | null
_connotations konotasi sentimen
berisi sentimen (reaksi emosional) yang terkait dengan kutipan kategori target dan jumlah kutipan per sentimen
konotasi yang tersedia:"anger","fear","happiness","love","sadness","share","neutral","fun"- propertyTipe: integer | null Format: int64
Name Signed 64-bit integers (long type).
- textTipe: array (object | null)[] | null
_categories - categoryTipe: array (integer | null)[] | null
- countTipe: integer | null Format: int64
Signed 64-bit integers (long type).
- topTipe: array (object | null)[] | null
_domains domain teratas yang mengutip kata kunci target
berisi objek dengan domain teratas yang mengutip kategori target dan jumlah kutipan per domain- countTipe: integer | null Format: int64
Signed 64-bit integers (long type).
- domainTipe: string | null
- totalTipe: integer | null Format: int64
_count jumlah total hasil di basis data kami yang relevan dengan permintaan Anda
- typeTipe: string | null
jenis elemen
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
versi API saat ini
application/json - 400
Permintaan tidak dapat diproses. Periksa parameter permintaan.
- 401
Kunci API Felo yang valid diperlukan.
- 402
Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
- 403
Akun tidak diizinkan melakukan operasi ini.
- 429
Batas permintaan atau batas pengeluaran telah tercapai.
- 502
Layanan tidak dapat menyelesaikan permintaan.
- 503
API atau layanan penagihan untuk sementara tidak tersedia.
- 504
Layanan kehabisan waktu saat memproses permintaan.
- default
Respons error; respons passthrough upstream dapat menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/category_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"category_code": 10994,
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"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,
"date": 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
}
]
}
]
}