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

Pautan Balik

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

Pautan Balik

​

Pautan masuk individu ke satu target, satu baris bagi setiap pautan. Memulangkan total_count, items_count, items dan search_after_token untuk penomboran halaman - gunakan token itu dan bukan offset selepas beberapa halaman pertama. mode dan custom_mode mengawal pengumpulan, backlinks_status_type memilih live, lost atau semua. Untuk kiraan dan bukan baris, gunakan post_dataforseo_backlinks_summary_live; untuk domain yang memaut dikumpulkan, post_dataforseo_backlinks_referring_domains_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_status_type
      Jenis: string | null

      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 teragregat target anda;
      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

    • custom_mode
      Jenis: object | null

      jenis pengelompokan hasil terperinci
      medan pilihan
      gunakan objek ini untuk mendapatkan bilangan pautan balik tertentu bagi setiap field
      jika anda menggunakan custom_mode, maka mode akan diabaikan
      contoh:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Jenis: object | null
    • 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

    • 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:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      anda boleh menggunakan operator % dengan like dan not_like untuk memadankan mana-mana rentetan dengan sifar atau lebih aksara
      contoh:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

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

      Senarai penuh penapis yang tersedia boleh dilihat di sini.

      Objek kosong
    • 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

    • limit
      Jenis: integer | null

      bilangan maksimum pautan balik yang dipulangkan
      medan pilihan

      nilai lalai: 100
      nilai maksimum: 1000

    • mode
      Jenis: string | null

      jenis pengelompokan hasil
      medan pilihan
      jenis pengelompokan yang tersedia:
      as_is - memulangkan semua pautan balik
      one_per_domain - memulangkan satu pautan balik bagi setiap domain
      one_per_anchor - memulangkan satu pautan balik bagi setiap sauh

      nilai lalai: as_is

    • 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;
      Nota: nilai maksimum ialah 20,000, gunakan search_after_token jika anda ingin mendapatkan lebih banyak hasil

    • 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

    • search_after_token
      Jenis: string | null

      token untuk permintaan seterusnya
      medan pilihan
      disediakan dalam medan yang sama bagi respons setiap permintaan;
      gunakan parameter ini untuk mengelakkan tamat masa semasa cuba memperoleh lebih daripada 20,000 hasil dalam satu permintaan;
      dengan menetapkan nilai search_after_token unik daripada tatasusunan respons, anda akan mendapat hasil seterusnya bagi tugas asal;
      nilai search_after_token adalah unik bagi setiap tugas seterusnya;
      Nota: jika search_after_token ditetapkan dalam permintaan, semua parameter lain harus sama dengan permintaan sebelumnya

    • 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

    • target
      Jenis: string

      domain, subdomain atau halaman web untuk mendapatkan pautan balik
      medan wajib
      domain atau subdomain harus ditentukan tanpa https:// dan www.
      halaman harus ditentukan dengan URL mutlak (termasuk http:// atau https://)

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo
    • 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_BacklinksBacklinksLiveTaskInfo
        • 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

          • custom_mode
            Jenis: object | null

            mod tersuai yang ditentukan dalam array POST

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

            mengandungi data pautan balik dan domain perujuk yang berkaitan

            • 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
              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

            • image_url
              Jenis: string | null

              URL imej
              URL yang menghala ke imej pada sumber asal atau storan DataForSEO (jika sumber asal tidak tersedia)

            • 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, 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
              kedudukan yang disalurkan oleh pautan balik tersebut kepada target
              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

            • ranked_keywords_info
              Jenis: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Jenis: integer | null Format: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_100
                Jenis: integer | null Format: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_3
                Jenis: integer | null Format: int64

                Signed 64-bit integers (long type).

            • 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 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

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam array items

          • mode
            Jenis: string | null

            mod yang ditentukan dalam array POST

          • search_after_token
            Jenis: string | null

            token untuk permintaan berikutnya
            dengan menentukan search_after_token unik semasa menetapkan tugas baharu, anda akan memperoleh hasil berikutnya bagi tugas awal;
            nilai search_after_token adalah unik bagi setiap tugas berikutnya

          • target
            Jenis: string | null

            domain sasaran dalam array POST

          • 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/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

Operasi berjaya

Backlinks