Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0
Server:https://openapi.felo.ai
Pustaka Klien

DataForSEO

​

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

Backlink

​

Tautan masuk individual ke satu target, satu baris per tautan. Mengembalikan total_count, items_count, items, dan search_after_token untuk penomoran halaman - gunakan token itu, bukan offset, setelah beberapa halaman pertama. mode dan custom_mode mengatur pengelompokan, backlinks_status_type memilih live, lost, atau semua. Untuk jumlah, bukan baris, gunakan post_dataforseo_backlinks_summary_live; untuk domain yang menautkan secara berkelompok, post_dataforseo_backlinks_referring_domains_live.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,06.
  • Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • backlinks_status_type
      Tipe: string | null

      tentukan backlink mana yang dikembalikan dan dihitung
      field opsional
      Anda dapat menggunakan field ini untuk memilih backlink mana yang akan dikembalikan dan digunakan untuk metrik teragregasi target Anda;
      nilai yang mungkin:
      all - semua backlink akan dikembalikan dan dihitung;
      live - backlink yang ditemukan selama pemeriksaan terakhir akan dikembalikan dan dihitung;
      lost - backlink yang hilang akan dikembalikan dan dihitung;

      nilai default: live

    • custom_mode
      Tipe: object | null

      jenis pengelompokan hasil terperinci
      field opsional
      gunakan objek ini untuk mendapatkan jumlah backlink tertentu per field
      jika Anda menggunakan custom_mode, maka mode akan diabaikan
      contoh:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Tipe: object | null
    • exclude_internal_backlinks
      Tipe: boolean | null

      menunjukkan apakah backlink internal dari subdomain ke target akan dikecualikan dari hasil
      field opsional
      jika disetel ke true, hasil tidak akan menyertakan data tentang backlink internal dari subdomain domain yang sama dengan target
      jika disetel ke false, tautan internal akan disertakan dalam hasil
      nilai default: true

    • filters
      Tipe: array (object | null)[] | null

      array parameter pemfilteran hasil
      field opsional
      Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
      Anda harus menyetel operator logika and, or di antara kondisi
      operator berikut didukung:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
      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%"]]]

      Daftar lengkap filter yang tersedia dapat dilihat di sini.

      Objek kosong
    • include_subdomains
      Tipe: boolean | null

      menunjukkan apakah subdomain dari target akan disertakan dalam pencarian
      field opsional
      jika disetel ke false, subdomain akan diabaikan
      nilai default: true

    • limit
      Tipe: integer | null

      jumlah maksimum backlink yang dikembalikan
      field opsional

      nilai default: 100
      nilai maksimum: 1000

    • mode
      Tipe: string | null

      jenis pengelompokan hasil
      field opsional
      jenis pengelompokan yang tersedia:
      as_is - mengembalikan semua backlink
      one_per_domain - mengembalikan satu backlink per domain
      one_per_anchor - mengembalikan satu backlink per anchor

      nilai default: as_is

    • offset
      Tipe: integer | null

      offset dalam array hasil backlink yang dikembalikan
      field opsional

      nilai default: 0
      jika Anda menentukan nilai 10, sepuluh backlink pertama dalam array hasil akan dilewati dan data akan disediakan untuk backlink berikutnya;
      Catatan: nilai maksimum adalah 20,000, gunakan search_after_token jika Anda ingin mengambil lebih banyak hasil

    • order_by
      Tipe: array string[] | null

      aturan pengurutan hasil
      field opsional
      Anda dapat menggunakan nilai yang sama seperti dalam array filters untuk mengurutkan hasil
      jenis pengurutan yang tersedia:
      asc - hasil akan diurutkan dalam urutan menaik
      desc - hasil akan diurutkan dalam urutan menurun
      Anda harus menggunakan koma untuk menyetel jenis pengurutan
      contoh:
      ["rank,desc"]
      perhatikan bahwa Anda tidak dapat menyetel lebih dari tiga aturan pengurutan dalam satu permintaan
      Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
      contoh:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • rank_scale
      Tipe: string | null

      menentukan skala yang digunakan untuk menghitung dan menampilkan nilai rank, domain_from_rank, dan page_from_rank
      field opsional

      Anda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000

      nilai yang tersedia:
      one_hundred — nilai rank ditampilkan pada skala 0–100
      one_thousand — nilai rank ditampilkan pada skala 0–1000

      nilai default: one_thousand

      pelajari lebih lanjut tentang cara parameter ini bekerja dan cara metrik peringkat dihitung dalam artikel Pusat Bantuan ini

    • search_after_token
      Tipe: string | null

      token untuk permintaan berikutnya
      field opsional
      disediakan di field yang identik pada respons setiap permintaan;
      gunakan parameter ini untuk menghindari timeout saat mencoba memperoleh lebih dari 20,000 hasil dalam satu permintaan;
      dengan menentukan nilai search_after_token unik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal;
      nilai search_after_token unik untuk setiap tugas berikutnya;
      Catatan: jika search_after_token ditentukan dalam permintaan, semua parameter lain harus identik dengan permintaan sebelumnya

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • target
      Tipe: string

      domain, subdomain, atau halaman web untuk mendapatkan backlink
      field wajib
      domain atau subdomain harus ditentukan tanpa https:// dan www.
      halaman harus ditentukan dengan URL absolut (termasuk http:// atau https://)

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: array (object | null)[] | null

          array hasil

          • custom_mode
            Tipe: object | null

            mode khusus yang ditentukan dalam array POST

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

            berisi data backlink dan domain perujuk yang relevan

            • alt
              Tipe: string | null

              teks alternatif gambar
              field ini akan bernilai null jika type backlink bukan image

            • anchor
              Tipe: string | null

              teks anchor backlink

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

              atribut tautan dari tautan perujuk
              contoh:
              nofollow

            • backlink_spam_score
              Tipe: integer | null

              skor spam backlink
              pelajari lebih lanjut tentang cara metrik dihitung di halaman pusat bantuan ini

            • dofollow
              Tipe: boolean | null

              menunjukkan apakah backlink bersifat dofollow
              jika false, backlink bersifat nofollow

            • domain_from
              Tipe: string | null

              domain yang merujuk ke domain atau halaman web target

            • domain_from_country
              Tipe: string | null

              kode negara ISO domain perujuk

            • domain_from_ip
              Tipe: string | null

              alamat IP domain perujuk

            • domain_from_is_ip
              Tipe: boolean | null

              menunjukkan apakah domain berupa IP
              jika true, domain berfungsi sebagai alamat IP dan tidak memiliki nama domain

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

              jenis platform domain perujuk

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

            • domain_from_rank
              Tipe: integer | null

              peringkat domain dari domain perujuk
              domain_from_rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan - prinsip yang digunakan dalam algoritma Google PageRank asli
              pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

            • domain_to
              Tipe: string | null

              domain yang dituju backlink

            • first_seen
              Tipe: string | null

              tanggal dan waktu saat perayap kami pertama kali menemukan backlink
              dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              contoh:
              2019-11-15 12:57:46 +00:00

            • group_count
              Tipe: integer | null Format: int64

              menunjukkan jumlah total backlink dari domain ini
              sebagai contoh, jika mode disetel ke one_per_domain, field ini akan menunjukkan jumlah total backlink yang berasal dari domain ini

            • image_url
              Tipe: string | null

              URL gambar
              URL yang mengarah ke gambar di sumber asli atau penyimpanan DataForSEO (jika sumber asli tidak tersedia)

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

              jalur tautan tidak langsung
              menunjukkan URL atau urutan URL yang mengarah ke url_to

              • status_code
                Tipe: integer | null

                kode status umum
                Anda dapat menemukan daftar lengkap kode respons di sini
                Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi pengecualian atau kesalahan terkait

              • type
                Tipe: string | null

                jenis elemen

              • url
                Tipe: string | null

                URL tautan tidak langsung

            • is_broken
              Tipe: boolean | null

              menunjukkan apakah backlink rusak
              jika true, backlink menunjuk ke halaman yang merespons dengan kode status 4xx atau 5xx

            • is_indirect_link
              Tipe: boolean | null

              menunjukkan apakah backlink merupakan tautan tidak langsung
              jika true, backlink adalah tautan tidak langsung yang menunjuk ke halaman yang mengalihkan ke url_to, atau menunjuk ke halaman kanonis

            • is_lost
              Tipe: boolean | null

              menunjukkan apakah backlink telah dihapus
              jika true, backlink atau seluruh halaman telah dihapus

            • is_new
              Tipe: boolean | null

              menunjukkan apakah backlink baru
              jika true, backlink ditemukan di halaman saat perayap kami terakhir mengunjunginya

            • item_type
              Tipe: string | null

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

            • last_seen
              Tipe: string | null

              tanggal terbaru saat perayap kami mengunjungi backlink
              dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              contoh:
              2019-11-15 12:57:46 +00:00

            • links_count
              Tipe: integer | null Format: int64

              jumlah backlink identik yang ditemukan di halaman perujuk

            • original
              Tipe: boolean | null

              menunjukkan apakah backlink ada di halaman perujuk saat perayap kami pertama kali mengunjunginya

            • page_from_encoding
              Tipe: string | null

              pengodean karakter halaman perujuk
              contoh:
              utf-8

            • page_from_external_links
              Tipe: integer | null

              jumlah tautan eksternal yang ditemukan di halaman perujuk

            • page_from_internal_links
              Tipe: integer | null

              jumlah tautan internal yang ditemukan di halaman perujuk

            • page_from_language
              Tipe: string | null

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

            • page_from_rank
              Tipe: integer | null

              peringkat halaman dari halaman perujuk
              page_from_rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan - prinsip yang digunakan dalam algoritma Google PageRank asli
              pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

            • page_from_size
              Tipe: integer | null

              ukuran halaman perujuk, dalam byte
              contoh:
              63357

            • page_from_status_code
              Tipe: integer | null

              kode status HTTP yang dikembalikan halaman perujuk
              contoh:
              200

            • page_from_title
              Tipe: string | null

              judul halaman perujuk

            • prev_seen
              Tipe: string | null

              tanggal sebelum kunjungan terbaru perayap kami ke backlink
              dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              contoh:
              2019-11-15 12:57:46 +00:00

            • rank
              Tipe: integer | null

              peringkat backlink
              peringkat yang diteruskan backlink tersebut ke target
              rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan - prinsip yang digunakan dalam algoritma Google PageRank asli
              pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

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

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_100
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_3
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • semantic_location
              Tipe: string | null

              menunjukkan elemen semantik dalam HTML tempat backlink ditemukan
              Anda dapat melihat daftar lengkap elemen semantik di sini
              contoh:
              article, section, summary

            • text_post
              Tipe: string | null

              cuplikan setelah teks anchor

            • text_pre
              Tipe: string | null

              cuplikan sebelum teks anchor

            • tld_from
              Tipe: string | null

              domain tingkat atas dari URL perujuk

            • type
              Tipe: string | null

              jenis elemen

            • url_from
              Tipe: string | null

              URL halaman tempat backlink ditemukan

            • url_from_https
              Tipe: boolean | null

              menunjukkan apakah URL perujuk diamankan dengan HTTPS
              jika true, URL perujuk diamankan dengan HTTPS

            • url_to
              Tipe: string | null

              URL yang dituju backlink

            • url_to_https
              Tipe: boolean | null

              menunjukkan apakah URL yang dituju backlink diamankan dengan HTTPS
              jika true, URL diamankan dengan HTTPS

            • url_to_redirect_target
              Tipe: string | null

              URL target pengalihan
              halaman target yang dituju pengalihan

            • url_to_spam_score
              Tipe: integer | null

              skor spam halaman yang dirujuk
              jika nilainya null, perayap kami belum mengunjungi halaman web yang dituju tautan;
              pelajari lebih lanjut tentang cara metrik dihitung di halaman pusat bantuan ini

            • url_to_status_code
              Tipe: integer | null

              kode status halaman yang dirujuk
              jika nilainya null, perayap kami belum mengunjungi halaman web yang dituju tautan
              contoh:
              200

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • mode
            Tipe: string | null

            mode yang ditentukan dalam array POST

          • search_after_token
            Tipe: string | null

            token untuk permintaan berikutnya
            dengan menentukan search_after_token unik saat menetapkan tugas baru, Anda akan mendapatkan hasil lanjutan dari tugas awal;
            nilai search_after_token unik untuk setiap tugas berikutnya

          • target
            Tipe: string | null

            domain target dalam array POST

          • total_count
            Tipe: integer | null Format: int64

            jumlah total hasil yang relevan dengan permintaan

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat 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
        }
      ]
    }
  ]
}
Backlinks