DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Teks Sauh
Teks sauh yang menunjuk ke satu target, satu baris bagi setiap sauh berbeza dengan anchor, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks dan broken_pages. Gunakannya untuk melihat cara web menerangkan sesuatu tapak - sauh yang terlebih optimum akan muncul di sini. Paparan peringkat pautan ialah post_dataforseo_backlinks_backlinks_live; peringkat domain ialah post_dataforseo_backlinks_referring_domains_live.
Rujukan harga
- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,033.
- 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)[]
- backlinksJenis: array (object | null)[] | null
_filters tapis pautan balik
targetanda
medan pilihan
anda boleh menggunakan medan ini untuk menapis pautan balik awal yang akan disertakan dalam set data untuk metrik teragregattargetanda
anda boleh menapis pautan balik mengikut semua medan yang tersedia dalam respons endpoint ini
dengan parameter ini, anda boleh menyertakan hanya pautan balik dofollow dalam respons dan mencipta set data pautan balik yang fleksibel untuk mengira metrik
contoh:"backlinks_filters": [["dofollow", "=", true]]Objek kosong - backlinksJenis: string | null
_status _type tetapkan pautan balik yang hendak dikembalikan dan dikira
medan pilihan
anda boleh menggunakan medan ini untuk memilih pautan balik yang akan dikembalikan dan digunakan untuk metrik teragregattargetanda;
nilai yang mungkin:all- semua pautan balik akan dikembalikan dan dikira;live- pautan balik yang ditemui semasa pemeriksaan terakhir akan dikembalikan dan dikira;lost- pautan balik yang hilang akan dikembalikan dan dikira;nilai lalai:
live - excludeJenis: boolean | null
_internal _backlinks menunjukkan sama ada pautan balik daripada subdomain
targetdikecualikan
medan pilihan
jika ditetapkan kepadafalse, pautan balik daripada subdomaintargetakan dilangkau dan anda tidak akan menerima domain yang sama dalam respons;
nilai lalai:true - filtersJenis: array (object | null)[] | null
array parameter penapisan hasil
medan pilihan
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,ilike,not_ilike,match,not_match
anda boleh menggunakan operator%denganlikedannot_likeuntuk memadankan sebarang rentetan dengan sifar atau lebih aksara
contoh:["referring_links_types.anchors",">","1"][["broken_pages",">","2"],
"and",
["backlinks",">","10"]][["first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]Senarai penuh penapis yang mungkin tersedia di sini.
Objek kosong - includeJenis: boolean | null
_indirect _links menunjukkan sama ada pautan tidak langsung ke
targetakan disertakan dalam hasil
medan pilihan
jika ditetapkan kepadatrue, hasil akan menyertakan data tentang pautan tidak langsung yang menunjuk ke halaman yang mengubah hala ke sasaran, atau menunjuk ke halaman kanonikal
jika ditetapkan kepadafalse, pautan tidak langsung akan diabaikan
nilai lalai:true - includeJenis: boolean | null
_subdomains menunjukkan sama ada subdomain bagi
targetakan disertakan dalam carian
medan pilihan
jika ditetapkan kepadafalse, subdomain akan diabaikan
nilai lalai:true - internalJenis: integer | null
_list _limit bilangan maksimum elemen dalam tatasusunan dalaman
medan pilihan
anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam tatasusunan berikut:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsnilai lalai:
10
nilai maksimum:1000 - limitJenis: integer | null
bilangan maksimum sauh yang dipulangkan
medan pilihan
nilai lalai:100
nilai maksimum:1000 - offsetJenis: integer | null
offset dalam tatasusunan hasil sauh yang dipulangkan
medan pilihan
nilai lalai:0
jika anda menetapkan nilai10, sepuluh sauh pertama dalam tatasusunan hasil akan dilangkau dan data akan disediakan untuk sauh seterusnya - orderJenis: array string[] | null
_by peraturan isihan hasil
medan pilihan
anda boleh menggunakan nilai yang sama seperti dalam tatasusunanfiltersuntuk mengisih hasil
jenis isihan yang tersedia:asc- hasil akan diisih mengikut susunan menaikdesc- hasil akan diisih mengikut susunan menurun
anda harus menggunakan koma untuk menetapkan jenis isihan
contoh:["backlinks,desc"]
ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan isihan dalam satu permintaan
anda harus menggunakan koma untuk memisahkan beberapa peraturan isihan
contoh:["backlinks,desc","rank,asc"] - 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, subdomain atau halaman web untuk mendapatkan sauh
medan wajib
domain atau subdomain harus ditentukan tanpahttps://danwww.
halaman harus ditentukan dengan URL mutlak (termasukhttp://atauhttps://)
- Jenis: object | null · Response36Afe1097B20_BacklinksAnchorsLiveResponseInfo200
- 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_BacklinksAnchorsLiveTaskInfo
- 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
- itemsJenis: array (object | null)[] | null
tatasusunan items
- anchorJenis: string | null
sauh pautan balik
- backlinksJenis: integer | null Format: int64
menunjukkan bilangan pautan balik
- backlinksJenis: integer | null Format: int64
_spam _score - brokenJenis: integer | null Format: int64
_backlinks bilangan pautan balik rosak
bilangan pautan balik rosak yang menunjuk ketarget - brokenJenis: integer | null
_pages bilangan halaman rosak
bilangan halaman yang membalas dengan kod status 4xx atau 5xx tempat pautan balik menunjuk - firstJenis: string | null
_seen tarikh dan masa perangkak kami mula-mula menemui pautan balik dengan sauh ini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2019-11-15 12:57:46 +00:00 - lostJenis: string | null
_date tarikh dan masa pautan balik terakhir dengan sauh ini hilang
menunjukkan tarikh dan masa perangkak kami melawati halaman dan halaman itu membalas dengan kod status 4xx atau 5xx, atau apabila pautan balik terakhir dialih keluar
dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
contoh:2017-01-24 13:20:59 +00:00 - rankJenis: integer | null
kedudukan pautan sauh
volum kedudukan yang disalurkan oleh laman web perujuk kepadatargetmelalui pautan dengan sauh tertenturankdikira berdasarkan kaedah kedudukan nod dalam pangkalan data berpaut - prinsip yang digunakan dalam algoritma Google PageRank asal
ketahui lebih lanjut tentang metrik dan cara pengiraannya dalam artikel Pusat Bantuan ini - referringJenis: integer | null Format: int64
_domains menunjukkan bilangan domain perujuk
- referringJenis: integer | null Format: int64
_domains _nofollow bilangan domain yang menunjuk sekurang-kurangnya satu pautan nofollow ke
target - referringJenis: integer | null Format: int64
_ips bilangan alamat IP perujuk
bilangan alamat IP yang menunjuk ke halaman ini - referringJenis: object | null
_links _attributes atribut pautan bagi pautan perujuk
menunjukkan atribut pautan bagi pautan perujuk dan bilangan pautan bagi setiap atribut- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _countries kod negara ISO bagi pautan perujuk
menunjukkan kod negara ISO bagi domain tempat pautan perujuk berada dan bilangan pautan bagi setiap negara- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _platform _types jenis platform perujuk
menunjukkan jenis platform perujuk dan bilangan pautan bagi setiap platformnilai yang mungkin:
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _semantic _locations - propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _tld domain peringkat teratas bagi pautan perujuk
mengandungi domain peringkat teratas dan bilangan pautan perujuk bagi setiap satu- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _types jenis pautan perujuk
menunjukkan jenis pautan perujuk dan bilangan pautan bagi setiap jenis
nilai yang mungkin:anchor,image,link,meta,canonical,alternate,redirect- propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: integer | null Format: int64
_main _domains menunjukkan bilangan domain utama perujuk
- referringJenis: integer | null Format: int64
_main _domains _nofollow bilangan domain utama yang menunjuk sekurang-kurangnya satu pautan nofollow ke
target - referringJenis: integer | null Format: int64
_pages menunjukkan bilangan halaman yang menunjuk ke
targetdengan sauh ini - referringJenis: integer | null Format: int64
_pages _nofollow bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke
targetdengan sauh ini - referringJenis: integer | null Format: int64
_subnets bilangan subrangkaian perujuk
- typeJenis: string | null
jenis elemen
- itemsJenis: integer | null Format: int64
_count bilangan item dalam tatasusunan hasil
- targetJenis: string | null
sasaran dalam array POST
- totalJenis: integer | null Format: int64
_count jumlah item berkaitan dalam pangkalan data
- 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/anchors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 4,
"order_by": [
"backlinks,desc"
],
"filters": [
"anchor",
"like",
"%news%"
]
}
]'
{
"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,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"anchor": null,
"rank": null,
"backlinks": null,
"first_seen": null,
"lost_date": null,
"backlinks_spam_score": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}