Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Persilangan Halaman

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

Persilangan Halaman

​

Halaman yang memaut ke beberapa URL sasaran sekali gus, bukan domainnya. ⚠️ targets ialah objek berkunci kedudukan dan menerima URL penuh, bukan domain kosong. Setiap baris membawa page_intersection dan summary bagi setiap sasaran. Padanan peringkat domain ialah post_dataforseo_backlinks_domain_intersection_live, yang patut dicuba dahulu.

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.

Badan
application/json
  • Jenis: array (object | null)[]
    • 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 dalaman daripada subdomain ke target akan dikecualikan daripada hasil
      medan pilihan
      jika ditetapkan kepada true, hasil tidak akan menyertakan data tentang pautan balik dalaman daripada subdomain domain yang sama dengan target
      jika ditetapkan kepada false, pautan dalaman akan disertakan dalam hasil
      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 halaman perujuk yang memaut ke targets tetapi tidak memaut ke exclude_targets
      contoh:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"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.rank",">","80"]

      [["2.page_from_rank",">","55"],
      "and",
      ["1.original","=","true"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]

      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 targets 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:
      attributes
      domain_from_platform_type

      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 URL 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 pautan balik yang dipulangkan
      medan pilihan

      nilai lalai: 100
      nilai maksimum: 1000

    • offset
      Jenis: integer | null

      offset dalam tatasusunan hasil pautan balik 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:
      ["rank,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:
      ["domain_from_rank,desc","page_from_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": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        Jenis: string | null
Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
    • 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_BacklinksPageIntersectionLiveTaskInfo
        • 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 data pautan balik dan domain perujuk yang berkaitan

            • page_intersection
              Jenis: object | null

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

              • propertyName
                Jenis: array (object | null)[] | null
                • alt
                  Jenis: string | null

                  teks alternatif imej
                  medan ini akan bernilai null jika type pautan balik bukan image

                • anchor
                  Jenis: string | null

                  teks sauh pautan balik

                • attributes
                  Jenis: array (string | null)[] | null

                  atribut pautan bagi pautan perujuk
                  contoh:
                  nofollow

                • backlink_spam_score
                  Jenis: integer | null

                  skor spam pautan balik
                  ketahui lebih lanjut tentang cara metrik dikira di halaman Pusat Bantuan ini

                • dofollow
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik ialah dofollow
                  jika false, pautan balik ialah nofollow

                • domain_from
                  Jenis: string | null

                  domain yang merujuk domain atau halaman web sasaran

                • domain_from_country
                  Jenis: string | null

                  kod negara ISO bagi domain perujuk

                • domain_from_ip
                  Jenis: string | null

                  alamat IP domain perujuk

                • domain_from_is_ip
                  Jenis: boolean | null

                  menunjukkan sama ada domain ialah IP
                  jika true, domain berfungsi sebagai alamat IP dan tidak mempunyai nama domain

                • domain_from_platform_type
                  Jenis: array (string | null)[] | null

                  jenis platform domain perujuk

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

                • domain_from_rank
                  Jenis: integer | null

                  kedudukan domain bagi domain perujuk
                  menunjukkan kedudukan domain pada masa perangkak kami terakhir melihat pautan balik;
                  domain_from_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

                • domain_to
                  Jenis: string | null

                  domain yang dituju pautan balik

                • first_seen
                  Jenis: string | null

                  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

                • group_count
                  Jenis: integer | null Format: int64

                  menunjukkan jumlah bilangan pautan balik daripada domain ini
                  sebagai contoh, jika mode ditetapkan kepada one_per_domain, medan ini akan menunjukkan jumlah bilangan pautan balik yang datang daripada domain ini

                • indirect_link_path
                  Jenis: array (object | null)[] | null

                  laluan pautan tidak langsung
                  menunjukkan URL atau urutan URL yang membawa ke url_to

                  • status_code
                    Jenis: integer | null

                    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

                  • type
                    Jenis: string | null

                    jenis elemen

                  • url
                    Jenis: string | null

                    URL pautan tidak langsung

                • is_broken
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik rosak
                  jika true, pautan balik menunjuk ke halaman yang membalas dengan kod status 4xx atau 5xx

                • is_indirect_link
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik ialah pautan tidak langsung
                  jika true, pautan balik ialah pautan tidak langsung yang menunjuk ke halaman yang mengalih ke url_to, atau menunjuk ke halaman kanonikal

                • is_lost
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik telah dialih keluar
                  jika true, pautan balik atau seluruh halaman telah dialih keluar

                • is_new
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik baharu
                  jika true, pautan balik ditemui pada halaman semasa perangkak kami terakhir melawatnya

                • item_type
                  Jenis: string | null

                  jenis pautan
                  nilai yang mungkin:
                  anchor, image, link, meta, canonical, alternate, redirect

                • last_seen
                  Jenis: string | null

                  tarikh terkini perangkak kami melawati pautan balik
                  dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  contoh:
                  2019-11-15 12:57:46 +00:00

                • links_count
                  Jenis: integer | null Format: int64

                  bilangan pautan balik serupa yang ditemui pada halaman perujuk

                • original
                  Jenis: boolean | null

                  menunjukkan sama ada pautan balik hadir pada halaman perujuk semasa perangkak kami mula-mula melawatnya

                • page_from_encoding
                  Jenis: string | null

                  pengekodan aksara halaman perujuk
                  contoh:
                  utf-8

                • page_from_external_links
                  Jenis: integer | null

                  bilangan pautan luaran yang ditemui pada halaman perujuk

                • page_from_internal_links
                  Jenis: integer | null

                  bilangan pautan dalaman yang ditemui pada halaman perujuk

                • page_from_language
                  Jenis: string | null

                  bahasa halaman perujuk
                  dalam format ISO 639-1
                  contoh:
                  en

                • page_from_rank
                  Jenis: integer | null

                  kedudukan halaman bagi halaman perujuk
                  page_from_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

                • page_from_size
                  Jenis: integer | null

                  saiz halaman perujuk, dalam bait
                  contoh:
                  63357

                • page_from_status_code
                  Jenis: integer | null

                  kod status HTTP yang dikembalikan oleh halaman perujuk
                  contoh:
                  200

                • page_from_title
                  Jenis: string | null

                  tajuk halaman perujuk

                • prev_seen
                  Jenis: string | null

                  tarikh sebelum lawatan terkini perangkak kami ke pautan balik
                  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 pautan balik
                  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

                • semantic_location
                  Jenis: string | null

                  menunjukkan elemen semantik dalam HTML tempat pautan balik ditemui
                  anda boleh mendapatkan senarai penuh elemen semantik di sini
                  contoh:
                  article, section, summary

                • text_post
                  Jenis: string | null

                  petikan selepas teks sauh

                • text_pre
                  Jenis: string | null

                  petikan teks sebelum teks sauh

                • tld_from
                  Jenis: string | null

                  domain peringkat teratas bagi URL perujuk

                • type
                  Jenis: string | null

                  jenis elemen

                • url_from
                  Jenis: string | null

                  URL halaman tempat pautan balik ditemui

                • url_from_https
                  Jenis: boolean | null

                  menunjukkan sama ada URL perujuk dilindungi dengan HTTPS
                  jika true, URL perujuk dilindungi dengan HTTPS

                • url_to
                  Jenis: string | null

                  URL yang dituju pautan balik

                • url_to_https
                  Jenis: boolean | null

                  menunjukkan sama ada URL yang dituju pautan balik dilindungi dengan HTTPS
                  jika true, URL dilindungi dengan HTTPS

                • url_to_redirect_target
                  Jenis: string | null

                  URL sasaran pengalihan
                  halaman sasaran yang dituju pengalihan

                • url_to_spam_score
                  Jenis: integer | null

                  skor spam halaman yang dirujuk
                  jika nilainya null, perangkak kami belum melawati halaman web yang dituju pautan
                  ketahui lebih lanjut tentang cara metrik dikira di halaman Pusat Bantuan ini

                • url_to_status_code
                  Jenis: integer | null

                  kod status halaman yang dirujuk
                  jika nilainya null, perangkak kami belum melawati halaman web yang dituju pautan
                  contoh:
                  200

            • summary
              Jenis: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              mengandungi ringkasan persilangan halaman

              • 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

            targets daripada array POST

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

            jumlah keseluruhan hasil yang berkaitan dengan permintaan

        • 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
Request Example for post/v1/beta/dataforseo/backlinks/page_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

{
  "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": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Page Intersection