DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Halaman Domain
Halaman satu target yang mempunyai pautan masuk, dengan pandangan perangkak terhadap setiap satu: main_domain, domain, tld, page, ip, first_visited, prev_visited dan fetch_time. Gunakannya untuk mencari halaman yang benar-benar memperoleh pautan. Untuk kiraan pautan balik setiap halaman dan bukan metadata perangkak, gunakan post_dataforseo_backlinks_domain_pages_summary_live.
Rujukan harga
- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,0276.
- 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 menapis pautan balik
targetanda
medan pilihan
anda boleh menggunakan medan ini untuk menapis pautan balik awal yang akan disertakan dalam set data bagi metrik agregattargetanda
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 menetapkan pautan balik yang hendak dipulangkan dan dikira
medan pilihan
anda boleh menggunakan medan ini untuk memilih pautan balik yang akan dipulangkan dan digunakan untuk metrik agregat;
nilai tersedia:all- semua pautan balik akan dipulangkan dan dikira;live- pautan balik yang ditemui semasa pemeriksaan terakhir akan dipulangkan dan dikira;lost- pautan balik yang hilang akan dipulangkan dan dikira;nilai lalai:
live - excludeJenis: boolean | null
_internal _backlinks menunjukkan sama ada pautan balik dalaman daripada subdomain ke
targetakan dikecualikan daripada hasil
medan pilihan
jika ditetapkan kepadatrue, hasil tidak akan menyertakan data tentang pautan balik dalaman daripada subdomain domain yang sama dengantarget
jika ditetapkan kepadafalse, pautan dalaman akan disertakan dalam hasil
nilai lalai:true - filtersJenis: array (object | null)[] | null
tatasusunan 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 mana-mana rentetan dengan sifar atau lebih aksara
contoh:["meta.internal_links_count",">","1"][["meta.external_links_count",">","2"],
"and",
["backlinks",">","10"]][["first_visited",">","2017-10-23 11:31:45 +00:00"],
"and",
[["title","like","%seo%"],"or",["referring_domains",">","10"]]]Objek kosong - 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 halaman yang dipulangkan
medan pilihan
nilai lalai:100
nilai maksimum:1000 - offsetJenis: integer | null
offset dalam array hasil halaman yang dipulangkan
medan pilihan
nilai lalai:0
jika anda menentukan nilai10, sepuluh halaman pertama dalam array hasil akan dilangkau dan data akan disediakan untuk halaman 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:["page_summary.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:["page_summary.backlinks,desc","page_summary.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 atau subdomain
medan wajib
domain atau subdomain harus ditentukan tanpahttps://danwww.
contoh:forbes.com
- Jenis: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo200
- 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_BacklinksDomainPagesLiveTaskInfo
- 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
- contentJenis: string | null
_encoding jenis pengekodan
- domainJenis: string | null
domain
domain tempat halaman ditemui - encodedJenis: integer | null
_size saiz halaman selepas pengekodan
menunjukkan saiz halaman yang dikodkan, dalam bait - fetchJenis: string | null
_time tarikh dan masa terkini perangkak kami melawati halaman
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2017-01-24 13:20:59 +00:00 - firstJenis: string | null
_visited tarikh dan masa lawatan halaman pertama
tarikh dan masa perangkak kami mula-mula melawati halaman ini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2017-01-24 13:20:59 +00:00 - ipJenis: string | null
alamat IP
- locationJenis: string | null
pengepala location
menunjukkan URL untuk mengalih halaman jika ada - mainJenis: string | null
_domain domain utama laman web
domain utama laman web tidak merangkumi subdomain - mediaJenis: string | null
_type jenis media yang digunakan untuk memaparkan halaman
- metaJenis: object | null · Response36Afe1097B20_BacklinksPageMeta
metadata halaman
- canonicalJenis: string | null
halaman kanonikal
- charsetJenis: string | null
pengekodan aksara
contoh:utf-8 - externalJenis: integer | null Format: int64
_links _count bilangan pautan luaran pada halaman
- h1Jenis: array (string | null)[] | null
tag h1
kandungan tagh1 - h2Jenis: array (string | null)[] | null
tag h2
kandungan tagh2 - h3Jenis: array (string | null)[] | null
tag h3
kandungan tagh3 - imagesJenis: array (string | null)[] | null
_alt kandungan tag
alt - imagesJenis: integer | null Format: int64
_count bilangan imej pada halaman
- internalJenis: integer | null Format: int64
_links _count bilangan pautan dalaman pada halaman
- languageJenis: string | null
bahasa kandungan halaman
contoh:en - pageJenis: integer | null
_spam _score - platformJenis: array (string | null)[] | null
_type jenis platform
- poweredJenis: array (string | null)[] | null
_by butiran CMS
- socialJenis: object | null
_media _tags - propertyJenis: string | null
Name
- technologiesJenis: object | null
teknologi laman web
- propertyJenis: string | null
Name
- titleJenis: string | null
tajuk halaman
- wordsJenis: integer | null Format: int64
_count bilangan perkataan pada halaman
- pageJenis: string | null
URL halaman
URL halaman berkaitan - pageJenis: object | null · Response36Afe1097B20_PageSummary
_summary mengandungi data pautan balik untuk halaman ini
- 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 kepage - 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
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 apabila pautan balik terakhir bagi halaman ini hilang
menunjukkan tarikh dan masa apabila perangkak kami melawat halaman dan halaman bertindak balas 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
- 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
page - referringJenis: integer | null Format: int64
_ips bilangan alamat IP perujuk
bilangan alamat IP yang menunjuk ke halaman ini - referringJenis: object | null
_links _attributes - propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _countries - propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _platform _types - 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 - propertyJenis: integer | null Format: int64
Name Signed 64-bit integers (long type).
- referringJenis: object | null
_links _types - 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 Signed 64-bit integers (long type).
- referringJenis: integer | null Format: int64
_pages menunjukkan bilangan halaman yang menunjuk ke
page - referringJenis: integer | null Format: int64
_pages _nofollow bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke
page - referringJenis: integer | null Format: int64
_subnets bilangan subrangkaian perujuk
- prevJenis: string | null
_visited tarikh sebelum lawatan terkini perangkak kami ke halaman
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:2017-01-24 13:20:59 +00:00 - serverJenis: string | null
versi pelayan
- sizeJenis: integer | null
menunjukkan saiz halaman, dalam bait
- statusJenis: integer | null
_code kod status umum
anda boleh menemui senarai penuh kod respons di sini
Nota: kami sangat mengesyorkan agar sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan direka bentuk - tldJenis: string | null
- typeJenis: string | null
jenis elemen
- itemsJenis: integer | null Format: int64
_count bilangan item dalam array
items - targetJenis: string | null
targetdalam 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/domain_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
}
]'
{
"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,
"main_domain": null,
"domain": null,
"tld": null,
"page": null,
"ip": null,
"first_visited": null,
"prev_visited": null,
"fetch_time": null,
"status_code": null,
"location": null,
"size": null,
"encoded_size": null,
"content_encoding": null,
"media_type": null,
"server": null,
"meta": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"social_media_tags": "[Max Depth Exceeded]"
},
"page_summary": {
"0": "[",
"1": "M",
"2": "a",
"3": "x",
"4": " ",
"5": "D",
"6": "e",
"7": "p",
"8": "t",
"9": "h",
"10": " ",
"11": "E",
"12": "x",
"13": "c",
"14": "e",
"15": "e",
"16": "d",
"17": "e",
"18": "d",
"19": "]",
"referring_main_domains_nofollow": "[Max Depth Exceeded]",
"referring_links_tld": "[Max Depth Exceeded]",
"referring_links_types": "[Max Depth Exceeded]",
"referring_links_attributes": "[Max Depth Exceeded]",
"referring_links_platform_types": "[Max Depth Exceeded]",
"referring_links_semantic_locations": "[Max Depth Exceeded]",
"referring_links_countries": "[Max Depth Exceeded]"
}
}
]
}
]
}
]
}