DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Estimasi Trafik Massal Historis
Perkiraan trafik organik untuk banyak domain pada setiap titik dalam riwayat yang tersedia - deret waktu di balik post_dataforseo_labs_google_bulk_traffic_estimation_live. Endpoint ini tidak menerima parameter batas, tetapi ditagih per panggilan, bukan per item, jadi kirim seluruh daftar sekaligus. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Ukuran respons mengalikan jumlah domain dengan jumlah tanggal; jaga kedua daftar tetap pendek. Tanggal yang tersedia berasal dari get_dataforseo_labs_google_available_history.
Referensi harga
- Pengukuran: biaya respons yang dilaporkan.
- Perkiraan referensi per permintaan: USD 0,1356.
- 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)[]
- dateTipe: string | null
_from tanggal mulai rentang waktu
field opsional
jika Anda tidak menentukan field ini, data akan disediakan untuk 12 bulan sebelumnya
nilai minimum yang mungkin:2020-10-01
format tanggal:"yyyy-mm-dd" - dateTipe: string | null
_to tanggal akhir rentang waktu
field opsional
jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default;
format tanggal:"yyyy-mm-dd"
contoh:"2021-04-01" - ignoreTipe: boolean | null
_synonyms abaikan kata kunci yang sangat mirip
field opsional
jika disetel ketrue, hanya kata kunci inti yang akan dikembalikan, semua kata kunci yang sangat mirip akan dikecualikan;
nilai default:false - itemTipe: array string[] | null
_types tampilkan hasil berdasarkan jenis item
field opsional
menunjukkan jenis hasil pencarian yang disertakan dalam respons;
Catatan: jika arrayitem_typesberisi jenis item yang berbeda dariorganic, hasil akan diurutkan berdasarkan jenis item pertama dalam array;
nilai yang mungkin:["organic", "paid", "featured_snippet", "local_pack"]
nilai default:["organic", "paid"] - languageTipe: string | null
_code kode bahasa
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_name
Anda dapat memperoleh daftar bahasa yang tersedia besertalanguage_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
abaikan field ini untuk mendapatkan hasil untuk semua bahasa yang tersedia
contoh:en - languageTipe: string | null
_name nama lengkap bahasa
jika Anda menggunakan field ini, Anda tidak perlu menentukanlanguage_code
Anda dapat memperoleh daftar bahasa yang tersedia besertalanguage_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
abaikan field ini untuk mendapatkan hasil untuk semua bahasa yang tersedia
contoh:English - locationTipe: integer | null
_code kode lokasi
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_name
Anda dapat memperoleh daftar lokasi yang tersedia besertalocation_code-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
abaikan field ini untuk mendapatkan hasil untuk semua lokasi yang tersedia
contoh:2840 - locationTipe: string | null
_name nama lengkap lokasi
jika Anda menggunakan field ini, Anda tidak perlu menentukanlocation_code
Anda dapat memperoleh daftar lokasi yang tersedia besertalocation_name-nya dengan membuat permintaan terpisah kehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
abaikan field ini untuk mendapatkan hasil untuk semua lokasi yang tersedia
contoh:United Kingdom - 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 - targetsTipe: array string[]
domain dan subdomain target
field wajib
Anda dapat menentukan domain dan subdomain di field ini;
domain dan subdomain harus ditentukan tanpahttps://danwww.;
Anda dapat menetapkan hingga 1000 domain atau subdomain
- Tipe: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo200
- 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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
- 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
- itemsTipe: array (object | null)[] | null
array item dengan data estimasi trafik yang relevan
- metricsTipe: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo
data trafik yang relevan dengan domain yang ditentukan
- featuredTipe: array (object | null)[] | null
_snippet data trafik dari hasil featured snippet di SERP Google
- countTipe: integer | null Format: int64
jumlah total SERP organik yang berisi domain
- etvTipe: number | null
- monthTipe: integer | null
bulan data disediakan
- yearTipe: integer | null
tahun data disediakan
- localTipe: array (object | null)[] | null
_pack data trafik dari hasil local pack di SERP
- countTipe: integer | null Format: int64
jumlah total SERP organik yang berisi domain
- etvTipe: number | null
- monthTipe: integer | null
bulan data disediakan
- yearTipe: integer | null
tahun data disediakan
- organicTipe: array (object | null)[] | null
data trafik dari pencarian organik
- countTipe: integer | null Format: int64
jumlah total SERP organik yang berisi domain
- etvTipe: number | null
- monthTipe: integer | null
bulan data disediakan
- yearTipe: integer | null
tahun data disediakan
- paidTipe: array (object | null)[] | null
data trafik dari pencarian berbayar
- countTipe: integer | null Format: int64
jumlah total SERP organik yang berisi domain
- etvTipe: number | null
- monthTipe: integer | null
bulan data disediakan
- yearTipe: integer | null
tahun data disediakan
- seTipe: string | null
_type jenis mesin pencari
- targetTipe: string | null
domain target dalam array POST
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - languageTipe: string | null
_code kode bahasa dalam array POST
jika tidak ada data, nilainya adalahnull - locationTipe: integer | null
_code kode lokasi dalam array POST
jika tidak ada data, nilainya adalahnull - seTipe: string | null
_type jenis mesin pencari
- totalTipe: integer | null Format: int64
_count jumlah total hasil di basis data kami yang relevan dengan permintaan Anda
- 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/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"dataforseo.com",
"cnn.com",
"forbes.com"
],
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29",
"item_types": [
"organic",
"paid"
]
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"target": null,
"metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}