DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ringkasan Siri Masa Pautan Balik
Metrik pautan balik teras satu target dari semasa ke semasa, dikumpulkan mengikut group_range (hari, minggu, bulan). Memulangkan date_from, date_to, group_range dan satu item bagi setiap tempoh. Untuk perolehan dan kehilangan dan bukan jumlah, gunakan post_dataforseo_backlinks_timeseries_new_lost_live. Endpoint ini tidak mengambil parameter had, jadi satu-satunya tuas ialah memanggilnya dengan lebih jarang.
Rujukan harga
- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,0273.
- 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)[]
- dateJenis: string | null
_from tarikh mula julat masa
medan pilihan
medan ini menunjukkan tarikh yang akan digunakan sebagai ambang bagi data ringkasan;nilai minimum:
2019-01-30
nilai maksimum tidak boleh melebihi tarikh yang ditetapkan dalamdate_to
format tarikh:"yyyy-mm-dd"
contoh:"2021-01-01" - dateJenis: string | null
_to tarikh tamat julat masa
medan pilihan
jika anda tidak menetapkan medan ini, tarikh hari ini akan digunakan secara lalai
nilai minimum tidak boleh mendahului tarikh yang ditetapkan dalamdate_from
nilai maksimum: tarikh hari ini
format tarikh:"yyyy-mm-dd"
contoh:"2021-01-15" - groupJenis: string | null
_range julat masa yang akan digunakan untuk mengumpulkan hasil
medan pilihan
nilai lalai:month
nilai tersedia:day,week,month,yearnota: untuk
day, kami akan memulangkan item yang sepadan dengan semua tarikh antara dan termasukdate_fromdandate_to;
untukweek/month/year, kami akan memulangkan item yang sepadan dengan minggu/bulan/tahun penuh, di mana setiap item akan menunjukkan hari terakhir minggu/bulan/tahun tersebutcontohnya, jika anda menetapkan:
"group_range": "month",
"date_from": "2022-03-23",
"date_to": "2022-05-13"
kami akan memulangkan item yang jatuh antara 2022-03-01 dan 2022-05-31, iaitu tiga item yang sepadan dengan tarikh berikut:2022-03-31,2022-04-30,2022-05-31jika tiada data untuk
day/week/month/yeartertentu, kami akan memulangkan0 - includeJenis: boolean | null
_subdomains menunjukkan sama ada subdomain bagi
targetakan disertakan dalam carian
medan pilihan
jika ditetapkan kepadafalse, subdomain akan diabaikan
nilai lalai:true - rankJenis: string | null
_scale menentukan skala yang digunakan untuk mengira dan memaparkan nilai
rank,domain_from_rankdanpage_from_rank
medan pilihananda boleh menggunakan parameter ini untuk memilih sama ada nilai rank dipaparkan pada skala 0–100 atau 0–1000
nilai tersedia:
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 dan cara metrik kedudukan dikira dalam artikel Pusat Bantuan ini
- 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 - targetJenis: string
domain untuk mendapatkan data
medan wajib
domain harus ditentukan tanpahttps://danwww.
contoh:"forbes.com"
- Jenis: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo200
- 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_BacklinksTimeseriesSummaryLiveTaskInfo
- 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
- dateJenis: string | null
_from tarikh mula julat masa
dalam format UTC: “yyyy-mm-dd”
contoh:2019-01-01 - dateJenis: string | null
_to tarikh tamat julat masa
dalam format UTC:"yyyy-mm-dd"
contoh:"2019-01-15" - groupJenis: string | null
_range group_range daripada array POST
- itemsJenis: array (object | null)[] | null
mengandungi data ringkasan yang berkaitan
- backlinksJenis: integer | null Format: int64
bilangan pautan balik bagi
dateyang diberikan - backlinksJenis: integer | null Format: int64
_nofollow bilangan pautan balik nofollow bagi
dateyang diberikan - dateJenis: string | null
tarikh dan masa data bagi sasaran disimpan
dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
contoh:2019-11-15 12:57:46 +00:00 - rankJenis: integer | null
- referringJenis: integer | null Format: int64
_domains bilangan domain perujuk bagi
dateyang diberikan
domain perujuk merangkumi subdomain yang dikira sebagai domain berasingan untuk metrik ini - referringJenis: integer | null Format: int64
_domains _nofollow bilangan domain yang menunjuk sekurang-kurangnya satu pautan nofollow ke
targetbagidateyang diberikan - referringJenis: integer | null Format: int64
_ips bilangan alamat IP perujuk bagi
dateyang diberikan
bilangan alamat IP yang menunjuk ke halaman ini - referringJenis: integer | null Format: int64
_main _domains bilangan domain utama perujuk bagi
dateyang diberikan - referringJenis: integer | null Format: int64
_main _domains _nofollow bilangan domain utama yang menunjuk sekurang-kurangnya satu pautan nofollow ke
targetbagidateyang diberikan - referringJenis: integer | null Format: int64
_pages bilangan halaman yang menunjuk ke
targetbagidateyang diberikan - referringJenis: integer | null Format: int64
_pages _nofollow bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke
targetbagidateyang diberikan - referringJenis: integer | null Format: int64
_subnets bilangan subrangkaian perujuk bagi
dateyang diberikan - typeJenis: string | null
jenis elemen
- itemsJenis: integer | null Format: int64
_count bilangan hasil yang dipulangkan dalam array
items - targetJenis: string | null
targetdaripada array POST
- 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/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
}
]
}
]
}
]
}