v0.2.0-beta

OpenAPI 3.1.0

Persilangan Domain

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

post/v1/beta/dataforseo/backlinks/domain_intersection/live

Persilangan Domain

Domain yang memaut ke beberapa sasaran sekali gus. ⚠️ targets di sini ialah objek berkunci kedudukan - {"1": "a.com", "2": "b.com"} - bukan array yang diterima endpoint pukal. exclude_targets mengeluarkan tapak daripada perbandingan. Setiap baris membawa domain_intersection dan summary bagi setiap sasaran. Gunakannya untuk mencari siapa yang memaut ke pesaing anda tetapi tidak ke anda. Padanan peringkat halaman ialah post_dataforseo_backlinks_page_intersection_live.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0,06.
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.

Badan

application/json

Jenis: array (object | null)[]
- backlinks_filters
 Jenis: array (object | null)[] | null
 
 menapis pautan balik target anda
 medan pilihan
 anda boleh menggunakan medan ini untuk menapis pautan balik awal yang akan disertakan dalam set data bagi metrik agregat target anda
 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
- backlinks_status_type
 Jenis: string | null
 
 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 targets;
 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
- exclude_internal_backlinks
 Jenis: boolean | null
 
 menunjukkan sama ada pautan balik daripada subdomain target dikecualikan
 medan pilihan
 jika ditetapkan kepada false, pautan balik daripada subdomain target akan dilangkau dan anda tidak akan menerima domain yang sama dalam respons;
 nilai lalai: true
- exclude_targets
 Jenis: array string[] | null
 
 domain, subdomain atau halaman web yang ingin anda kecualikan
 medan pilihan
 anda boleh menetapkan sehingga 10 domain, subdomain atau halaman web
 jika anda menggunakan tatasusunan ini, hasil akan mengandungi domain perujuk yang memaut ke targets tetapi tidak memaut ke exclude_targets
 contoh:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Jenis: array (object | null)[] | null
 
 tatasusunan parameter penapisan hasil
 medan pilihan
 anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
 anda harus menetapkan operator logik and, or antara syarat
 operator berikut disokong:
 regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
 anda boleh menggunakan operator % dengan like dan not_like untuk memadankan mana-mana rentetan dengan sifar atau lebih aksara
 contoh:
 ["1.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 Senarai penuh penapis yang tersedia boleh dilihat di sini.
 
 Objek kosong
- include_indirect_links
 Jenis: boolean | null
 
 menunjukkan sama ada pautan tidak langsung ke targets akan disertakan dalam hasil
 medan pilihan
 jika ditetapkan kepada true, hasil akan menyertakan data tentang pautan tidak langsung yang menuju ke halaman yang mengubah hala ke sasaran, atau menuju ke halaman kanonik
 jika ditetapkan kepada false, pautan tidak langsung akan diabaikan
 nilai lalai: true
- include_subdomains
 Jenis: boolean | null
 
 menunjukkan sama ada subdomain bagi target akan disertakan dalam carian
 medan pilihan
 jika ditetapkan kepada false, subdomain akan diabaikan
 nilai lalai: true
- internal_list_limit
 Jenis: integer | null
 
 bilangan maksimum elemen dalam tatasusunan dalaman
 medan pilihan
 anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam tatasusunan berikut:
 referring_links_tld
 referring_links_types
 referring_links_attributes
 referring_links_platform_types
 referring_links_semantic_locations
 
 nilai lalai: 10
 nilai maksimum: 1000
- intersection_mode
 Jenis: string | null
 
 menunjukkan sama ada pautan balik akan disilangkan
 medan pilihan
 gunakan medan ini untuk menyilangkan atau menggabungkan hasil bagi domain yang ditetapkan
 nilai tersedia: all, partial
 all - hasil berdasarkan semua pautan balik;
 partial - hasil berdasarkan pautan balik yang bersilang sahaja;
 nilai lalai: all
- limit
 Jenis: integer | null
 
 bilangan maksimum hasil yang dipulangkan
 medan pilihan
 nilai lalai: 100
 nilai maksimum: 1000
- offset
 Jenis: integer | null
 
 offset dalam tatasusunan hasil yang dipulangkan
 medan pilihan
 nilai lalai: 0
 jika anda menetapkan nilai 10, sepuluh pautan balik pertama dalam tatasusunan hasil akan dilangkau dan data akan disediakan untuk pautan balik seterusnya
- order_by
 Jenis: array string[] | null
 
 peraturan isihan hasil
 medan pilihan
 anda boleh menggunakan nilai yang sama seperti dalam tatasusunan filters untuk mengisih hasil
 jenis isihan yang tersedia:
 asc - hasil akan diisih mengikut susunan menaik
 desc - 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"]
- rank_scale
 Jenis: string | null
 
 menentukan skala yang digunakan untuk mengira dan memaparkan nilai rank, domain_from_rank dan page_from_rank
 medan pilihan
 
 anda 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–100
 one_thousand — nilai rank dipaparkan pada skala 0–1000
 
 nilai lalai: one_thousand
 
 ketahui lebih lanjut tentang cara parameter ini berfungsi dan cara metrik kedudukan dikira dalam artikel Pusat Bantuan ini
- tag
 Jenis: 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 nilai tag yang ditentukan dalam objek data respons
- targets
 Jenis: object | null
 
 domain, subdomain atau halaman web untuk mendapatkan pautan
 medan wajib
 anda boleh menetapkan sehingga 20 domain, subdomain atau halaman web
 domain atau subdomain harus ditentukan tanpa https:// dan www.
 halaman harus ditentukan dengan URL mutlak (termasuk http:// atau https://)
 contoh:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Jenis: string | null

Respons

200
Jenis: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

tasks
Jenis: array (object | null)[] | null

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

path
Jenis: array (string | null)[] | null

Laluan URL

result
Jenis: array (object | null)[] | null

tatasusunan hasil

items
Jenis: array (object | null)[] | null

mengandungi domain yang memaut ke semua targets daripada array POST

domain_intersection
Jenis: object | null

mengandungi data tentang domain yang memaut ke sasaran berkaitan yang ditentukan dalam array POST
data disediakan dalam objek berasingan yang sepadan dengan domain, subdomain atau halaman yang ditentukan dalam objek targets

propertyName
Jenis: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
Jenis: integer | null Format: int64

menunjukkan bilangan pautan balik

backlinks_spam_score
Jenis: integer | null Format: int64

purata skor spam pautan balik yang menunjuk ke target
ketahui lebih lanjut tentang cara metrik dikira di halaman Pusat Bantuan ini

broken_backlinks
Jenis: integer | null Format: int64

bilangan pautan balik rosak

broken_pages
Jenis: integer | null

bilangan halaman rosak

first_seen
Jenis: string | null

tarikh dan masa perangkak kami mula-mula menemui pautan balik daripada target ini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

lost_date
Jenis: string | null

tarikh dan masa pautan balik terakhir daripada target 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:
2019-11-15 12:57:46 +00:00

rank
Jenis: integer | null

kedudukan yang dirujuk kepada target daripada array POST
menunjukkan kedudukan yang dirujuk oleh domain perujuk (target di atas) kepada sasaran anda daripada array POST;
rank dikira 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

referring_domains
Jenis: integer | null Format: int64

bilangan domain perujuk

referring_domains_nofollow
Jenis: integer | null Format: int64

bilangan domain yang menunjuk sekurang-kurangnya satu pautan nofollow ke sasaran yang berkaitan

referring_ips
Jenis: integer | null Format: int64

bilangan alamat IP perujuk

referring_links_attributes
Jenis: object | null

atribut pautan bagi pautan perujuk
menunjukkan atribut pautan bagi pautan perujuk dan bilangan pautan bagi setiap atribut

propertyName
Jenis: integer | null

Integer numbers.

referring_links_countries
Jenis: object | null

kod negara ISO bagi pautan perujuk
menunjukkan kod negara ISO bagi domain tempat pautan perujuk berada dan bilangan pautan bagi setiap negara

referring_links_platform_types
Jenis: object | null

jenis platform perujuk
menunjukkan jenis platform perujuk dan bilangan pautan bagi setiap platform

nilai yang mungkin: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Jenis: integer | null

Integer numbers.

referring_links_semantic_locations
Jenis: object | null

lokasi semantik pautan perujuk
menunjukkan elemen semantik dalam HTML tempat pautan perujuk berada dan bilangan pautan bagi setiap lokasi semantik
anda boleh mendapatkan senarai penuh elemen semantik di sini

propertyName
Jenis: integer | null

Integer numbers.

referring_links_tld
Jenis: object | null

domain peringkat teratas bagi pautan perujuk
mengandungi domain peringkat teratas dan bilangan pautan perujuk bagi setiap satu

propertyName
Jenis: integer | null

Integer numbers.

referring_links_types
Jenis: object | null

jenis pautan perujuk
menunjukkan jenis pautan perujuk dan bilangan pautan bagi setiap jenis
nilai yang mungkin:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
Jenis: integer | null

Integer numbers.

referring_main_domains
Jenis: integer | null Format: int64

bilangan domain utama perujuk

referring_main_domains_nofollow
Jenis: integer | null Format: int64

bilangan domain utama yang menunjuk sekurang-kurangnya satu pautan nofollow ke target

referring_pages
Jenis: integer | null Format: int64

menunjukkan bilangan halaman yang menunjuk ke target

referring_pages_nofollow
Jenis: integer | null Format: int64

bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke target

referring_subnets
Jenis: integer | null Format: int64

bilangan subrangkaian perujuk

target
Jenis: string | null

domain yang memaut ke sasaran berkaitan daripada array POST

type
Jenis: string | null

jenis elemen

summary
Jenis: object | null · Response36Afe1097B20_IntersectionSummaryInfo

mengandungi ringkasan persilangan domain

intersections_count
Jenis: integer | null Format: int64

jumlah keseluruhan persilangan

items_count
Jenis: integer | null Format: int64

bilangan hasil yang dipulangkan dalam array items

targets
Jenis: object | null

domain sasaran, subdomain atau halaman web dalam array POST

propertyName
Jenis: string | null
total_count
Jenis: integer | null Format: int64

jumlah keseluruhan hasil yang berkaitan dengan permintaan anda

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

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

post/v1/beta/dataforseo/backlinks/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

Tunjukkan Skema

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Persilangan Domain

PengesahanRequired

DataForSEO

Persilangan Domain

Rujukan harga