DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ringkasan Deret Waktu Backlink
Metrik backlink inti satu target dari waktu ke waktu, dikelompokkan menurut group_range (hari, minggu, bulan). Mengembalikan date_from, date_to, group_range, dan satu item per periode. Untuk perolehan dan kehilangan alih-alih total, gunakan post_dataforseo_backlinks_timeseries_new_lost_live. Endpoint ini tidak menerima parameter batas, jadi satu-satunya tuas adalah memanggilnya lebih jarang.
Referensi harga
- Pengukuran: biaya respons yang dilaporkan.
- Perkiraan referensi per permintaan: USD 0,0273.
- 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
field ini menunjukkan tanggal yang akan digunakan sebagai ambang untuk data ringkasan;nilai minimum:
2019-01-30
nilai maksimum tidak boleh melebihi tanggal yang ditentukan dalamdate_to
format tanggal:"yyyy-mm-dd"
contoh:"2021-01-01" - dateTipe: string | null
_to tanggal berakhir rentang waktu
field opsional
jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default
nilai minimum tidak boleh mendahului tanggal yang ditentukan dalamdate_from
nilai maksimum: tanggal hari ini
format tanggal:"yyyy-mm-dd"
contoh:"2021-01-15" - groupTipe: string | null
_range rentang waktu yang akan digunakan untuk mengelompokkan hasil
field opsional
nilai default:month
nilai yang tersedia:day,week,month,yearcatatan: untuk
day, kami akan mengembalikan item yang sesuai dengan semua tanggal antara dan termasukdate_fromdandate_to;
untukweek/month/year, kami akan mengembalikan item yang sesuai dengan minggu/bulan/tahun penuh, di mana setiap item akan menunjukkan hari terakhir minggu/bulan/tahun tersebutmisalnya, jika Anda menentukan:
"group_range": "month",
"date_from": "2022-03-23",
"date_to": "2022-05-13"
kami akan mengembalikan item yang berada di antara 2022-03-01 dan 2022-05-31, yaitu tiga item yang sesuai dengan tanggal berikut:2022-03-31,2022-04-30,2022-05-31jika tidak ada data untuk
day/week/month/yeartertentu, kami akan mengembalikan0 - includeTipe: boolean | null
_subdomains menunjukkan apakah subdomain dari
targetakan disertakan dalam pencarian
field opsional
jika disetel kefalse, subdomain akan diabaikan
nilai default:true - rankTipe: string | null
_scale menentukan skala yang digunakan untuk menghitung dan menampilkan nilai
rank,domain_from_rank, danpage_from_rank
field opsionalAnda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000
nilai yang tersedia:
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 dan cara metrik peringkat dihitung dalam artikel Pusat Bantuan ini
- 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 - targetTipe: string
domain untuk mendapatkan data
field wajib
domain harus ditentukan tanpahttps://danwww.
contoh:"forbes.com"
- Tipe: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo200
- 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_BacklinksTimeseriesSummaryLiveTaskInfo
- 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
- dateTipe: string | null
_from tanggal mulai rentang waktu
dalam format UTC: “yyyy-mm-dd”
contoh:2019-01-01 - dateTipe: string | null
_to tanggal akhir rentang waktu
dalam format UTC:"yyyy-mm-dd"
contoh:"2019-01-15" - groupTipe: string | null
_range group_range dari array POST
- itemsTipe: array (object | null)[] | null
berisi data ringkasan yang relevan
- backlinksTipe: integer | null Format: int64
jumlah backlink untuk
datetertentu - backlinksTipe: integer | null Format: int64
_nofollow jumlah backlink nofollow untuk
datetertentu - dateTipe: string | null
tanggal dan waktu saat data untuk target disimpan
dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
contoh:2019-11-15 12:57:46 +00:00 - rankTipe: integer | null
- referringTipe: integer | null Format: int64
_domains jumlah domain perujuk untuk
datetertentu
domain perujuk mencakup subdomain yang dihitung sebagai domain terpisah untuk metrik ini - referringTipe: integer | null Format: int64
_domains _nofollow jumlah domain yang menunjuk setidaknya satu tautan nofollow ke
targetuntukdatetertentu - referringTipe: integer | null Format: int64
_ips jumlah alamat IP perujuk untuk
datetertentu
jumlah alamat IP yang menunjuk ke halaman ini - referringTipe: integer | null Format: int64
_main _domains jumlah domain utama perujuk untuk
datetertentu - referringTipe: integer | null Format: int64
_main _domains _nofollow jumlah domain utama yang menunjuk setidaknya satu tautan nofollow ke
targetuntukdatetertentu - referringTipe: integer | null Format: int64
_pages jumlah halaman yang menunjuk ke
targetuntukdatetertentu - referringTipe: integer | null Format: int64
_pages _nofollow jumlah halaman perujuk yang menunjuk setidaknya satu tautan nofollow ke
targetuntukdatetertentu - referringTipe: integer | null Format: int64
_subnets jumlah subjaringan perujuk untuk
datetertentu - typeTipe: string | null
jenis elemen
- itemsTipe: integer | null Format: int64
_count jumlah hasil yang dikembalikan dalam array
items - targetTipe: string | null
targetdari array POST
- 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/backlinks/timeseries_summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"date_from": "2021-12-01",
"date_to": "2022-02-01",
"group_range": "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": [
{
"target": null,
"date_from": null,
"date_to": null,
"group_range": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"backlinks_nofollow": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null
}
]
}
]
}
]
}