# Jaringan Perujuk

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/backlinks/referring_networks/live`

**Tags:** DataForSEO

Merangkum domain perujuk ke jaringan di belakangnya - satu baris per `network_address` dengan `referring_domains` serta `rank`, `backlinks`, `first_seen`, `lost_date`, `backlinks_spam_score`, `broken_backlinks`, dan `broken_pages`. `network_address_type` memilih IP atau subnet. Di tingkat inilah skema tautan menjadi terlihat: banyak domain di satu subnet adalah satu operator, bukan banyak dukungan. Tampilan yang belum dirangkum adalah `post_dataforseo_backlinks_referring_domains_live`.

### Referensi harga

- Pengukuran: biaya respons yang dilaporkan.
- Perkiraan referensi per permintaan: USD 0,0276.
- 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.

## Related links

- [di sini.](<https://docs.dataforseo.com/v3/backlinks/filters/?bash>)
- [endpoint ini](<https://docs.dataforseo.com/v3/backlinks/backlinks/live>)
- [artikel Pusat Bantuan ini](<https://dataforseo.com/help-center/what_is_rank_in_backlinks_api#rank_scale>)
- [artikel pusat bantuan ini](<https://dataforseo.com/help-center/what_is_rank_in_backlinks_api>)
- [di sini](<https://www.w3schools.com/html/html5_semantic_elements.asp>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "description": "<em>domain, subdomain, atau halaman web untuk mendapatkan jaringan perujuk</em><br><strong>field wajib</strong><br>domain atau subdomain harus ditentukan tanpa <code>https://</code> dan <code>www.</code><br>halaman harus ditentukan dengan URL absolut (termasuk <code>http://</code> atau <code>https://</code>)"
          },
          "network_address_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>menunjukkan jenis jaringan untuk mendapatkan data</em><br>field opsional<br>nilai yang tersedia: <code>ip</code>, <code>subnet</code><br>nilai default: <code>ip</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>jumlah maksimum jaringan yang dikembalikan</em><br>field opsional<br>nilai default: <code>100</code><br>nilai maksimum: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>offset dalam array hasil jaringan yang dikembalikan</em><br>field opsional<br>nilai default: <code>0</code><br>jika Anda menentukan nilai <code>10</code>, sepuluh domain pertama dalam array hasil akan dilewati dan data akan disediakan untuk halaman berikutnya"
          },
          "internal_list_limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>jumlah maksimum elemen dalam array internal</em><br>field opsional<br>Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut:<br><code>referring_links_tld</code><br><code>referring_links_types</code><br><code>referring_links_attributes</code><br><code>referring_links_platform_types</code><br><code>referring_links_semantic_locations</code><p>nilai default: <code>10</code><br>nilai maksimum: <code>1000</code>"
          },
          "backlinks_status_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tentukan backlink mana yang dikembalikan dan dihitung</em><br>field opsional<br>Anda dapat menggunakan field ini untuk memilih backlink mana yang akan dikembalikan dan digunakan untuk metrik teragregasi <code>target</code> Anda;<br>nilai yang mungkin: <br><code>all</code> - semua backlink akan dikembalikan dan dihitung;<br><code>live</code> - backlink yang ditemukan selama pemeriksaan terakhir akan dikembalikan dan dihitung;<br><code>lost</code> - backlink yang hilang akan dikembalikan dan dihitung;<p>nilai default: <code>live</code>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>array parameter pemfilteran hasil</em><br>field opsional<br><strong>Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)</strong><br>Anda harus menyetel operator logika <code>and</code>, <code>or</code> di antara kondisi<br>operator berikut didukung:<br><code>regex</code>, <code>not_regex</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code>, <code>ilike</code>, <code>not_ilike</code>, <code>match</code>, <code>not_match</code><br>Anda dapat menggunakan operator <code>%</code> dengan <code>like</code> dan <code>not_like</code> untuk mencocokkan string apa pun dengan nol atau lebih karakter<br>contoh:<br><code>[\"referring_pages\",\"&gt;\",\"1\"]</code><p><code>[[\"referring_pages\",\"&gt;\",\"2\"],<br>\"and\",<br>[\"backlinks\",\"&gt;\",\"10\"]]</code><p><code>[[\"first_seen\",\">\",\"2017-10-23 11:31:45 +00:00\"],<br>\"and\",<br>[[\"network_address\",\"like\",\"194.1.%\"],\"or\",[\"referring_ips\",\"&gt;\",\"10\"]]]</code><p>Daftar lengkap filter yang tersedia dapat dilihat di sini."
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>aturan pengurutan hasil</em><br>field opsional<br>Anda dapat menggunakan nilai yang sama seperti dalam array <code>filters</code> untuk mengurutkan hasil<br>jenis pengurutan yang tersedia:<br><code>asc</code> - hasil akan diurutkan dalam urutan menaik<br><code>desc</code> - hasil akan diurutkan dalam urutan menurun<br>Anda harus menggunakan koma untuk menyetel jenis pengurutan<br>contoh:<br><code>[\"backlinks,desc\"]</code><br><strong>perhatikan bahwa Anda tidak dapat menyetel lebih dari tiga aturan pengurutan dalam satu permintaan</strong><br>Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan<br>contoh:<br><code>[\"backlinks,desc\",\"rank,asc\"]</code>"
          },
          "backlinks_filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>memfilter backlink dari <code>target</code> Anda</em><br>field opsional<br>Anda dapat menggunakan field ini untuk memfilter backlink awal yang akan disertakan dalam kumpulan data untuk metrik agregat <code>target</code> Anda<br>Anda dapat memfilter backlink berdasarkan semua field yang tersedia dalam respons endpoint ini<br>dengan parameter ini, Anda dapat menyertakan hanya backlink dofollow dalam respons dan membuat kumpulan data backlink yang fleksibel untuk menghitung metrik<br>contoh:<br><code>\"backlinks_filters\": [[\"dofollow\", \"=\", true]]</code>"
          },
          "include_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan apakah subdomain dari <code>target</code> akan disertakan dalam pencarian</em><br>field opsional<br>jika disetel ke <code>false</code>, subdomain akan diabaikan<br>nilai default: <code>true</code>"
          },
          "include_indirect_links": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan apakah tautan tidak langsung ke <code>target</code> akan disertakan dalam hasil</em><br>field opsional<br>jika ditetapkan ke <code>true</code>, hasil akan menyertakan data tentang tautan tidak langsung yang mengarah ke halaman yang mengalihkan ke target, atau mengarah ke halaman kanonis<br>jika ditetapkan ke <code>false</code>, tautan tidak langsung akan diabaikan<br>nilai default: <code>true</code>"
          },
          "exclude_internal_backlinks": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan apakah backlink dari subdomain <code>target</code> dikecualikan</em><br>field opsional<br>jika ditetapkan ke <code>false</code>, backlink dari subdomain <code>target</code> akan dilewati dan Anda tidak akan menerima domain yang sama dalam respons;<br>nilai default: <code>true</code>"
          },
          "rank_scale": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>menentukan skala yang digunakan untuk menghitung dan menampilkan nilai <code>rank</code>, <code>domain_from_rank</code>, dan <code>page_from_rank</code></em><br>field opsional<p>Anda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000<p>nilai yang tersedia:<br><code>one_hundred</code> — nilai rank ditampilkan pada skala 0–100<br><code>one_thousand</code> — nilai rank ditampilkan pada skala 0–1000<p>nilai default: <code>one_thousand</code><p>pelajari lebih lanjut tentang cara parameter ini bekerja dan cara metrik peringkat dihitung dalam artikel Pusat Bantuan ini"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>pengenal tugas yang ditentukan pengguna</em><br>field opsional<br><em>batas karakter adalah 255</em><br>Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil<br>Anda akan menemukan nilai <code>tag</code> yang ditentukan di objek <code>data</code> pada respons"
          }
        },
        "example": [
          {
            "target": "backlinko.com",
            "network_address_type": "subnet",
            "limit": 5,
            "order_by": [
              "rank,desc"
            ],
            "exclude_internal_backlinks": true,
            "backlinks_filters": [
              "dofollow",
              "=",
              true
            ],
            "filters": [
              "backlinks",
              ">",
              100
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "backlinko.com",
      "network_address_type": "subnet",
      "limit": 5,
      "order_by": [
        "rank,desc"
      ],
      "exclude_internal_backlinks": true,
      "backlinks_filters": [
        "dofollow",
        "=",
        true
      ],
      "filters": [
        "backlinks",
        ">",
        100
      ]
    }
  ]
}
```

## Responses

### 200 — Operasi berhasil

Headers:
- `X-Request-Id` (string) — Pengenal permintaan yang harus disertakan saat menghubungi dukungan Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveResponseInfo"
    }
  ]
}
```

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BacklinksReferringNetworksLiveItem

`#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis elemen"
    },
    "network_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>alamat subjaringan atau IP perujuk</em>"
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>peringkat jaringan</em><br>volume peringkat yang diteruskan jaringan perujuk ke <code>target</code><br><code>rank</code> dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan - prinsip yang digunakan dalam algoritma Google PageRank asli<br>pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini"
    },
    "backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan jumlah backlink yang menunjuk ke <code>target</code></em>",
      "format": "int64"
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal dan waktu saat perayap kami pertama kali menemukan backlink</em><br>dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>contoh:<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "lost_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal dan waktu saat backlink terakhir dari domain ini hilang</em><br>menunjukkan tanggal dan waktu saat perayap kami mengunjungi halaman dan halaman merespons dengan kode status 4xx atau 5xx, atau saat backlink terakhir dihapus<br>dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>contoh:<br><code>2017-01-24 13:20:59 +00:00</code>"
    },
    "broken_backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah backlink rusak</em><br>jumlah backlink rusak yang menunjuk ke domain",
      "format": "int64"
    },
    "broken_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah halaman rusak</em><br>jumlah halaman yang merespons dengan kode status 4xx atau 5xx tempat backlink menunjuk"
    },
    "referring_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan jumlah domain perujuk</em><br>domain perujuk mencakup subdomain yang dihitung sebagai domain terpisah untuk metrik ini",
      "format": "int64"
    },
    "referring_domains_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah domain yang menunjuk setidaknya satu tautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_main_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan jumlah domain utama perujuk</em>",
      "format": "int64"
    },
    "referring_main_domains_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah domain utama yang menunjuk setidaknya satu tautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_ips": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah alamat IP perujuk</em><br>jumlah alamat IP yang menunjuk ke halaman ini",
      "format": "int64"
    },
    "referring_subnets": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah subjaringan perujuk</em>",
      "format": "int64"
    },
    "referring_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan jumlah halaman yang menunjuk ke <code>target</code> yang ditentukan</em>",
      "format": "int64"
    },
    "referring_pages_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah halaman perujuk yang menunjuk setidaknya satu tautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_links_tld": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>domain tingkat atas dari tautan perujuk</em><br>berisi domain tingkat atas dan jumlah tautan perujuk untuk masing-masing"
    },
    "referring_links_types": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>jenis tautan perujuk</em><br>menunjukkan jenis tautan perujuk dan jumlah tautan untuk setiap jenis<br>nilai yang mungkin:<br><code>anchor</code>, <code>image</code>, <code>link</code>, <code>meta</code>, <code>canonical</code>, <code>alternate</code>, <code>redirect</code>"
    },
    "referring_links_attributes": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>atribut tautan dari tautan perujuk</em><br>menunjukkan atribut tautan dari tautan perujuk dan jumlah tautan untuk setiap atribut"
    },
    "referring_links_platform_types": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>jenis platform perujuk</em><br>menunjukkan jenis platform perujuk dan jumlah tautan per platform<p>nilai yang mungkin: <code>cms</code>, <code>blogs</code>, <code>ecommerce</code>, <code>message-boards</code>, <code>wikis</code>, <code>news</code>, <code>organization</code>"
    },
    "referring_links_semantic_locations": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>lokasi semantik dari tautan perujuk</em><br>menunjukkan elemen semantik dalam HTML tempat tautan perujuk berada dan jumlah tautan untuk setiap lokasi semantik<p>Anda dapat melihat daftar lengkap elemen semantik di sini<br>contoh:<br><code>article</code>, <code>section</code>, <code>summary</code>"
    },
    "referring_links_countries": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>kode negara ISO dari tautan perujuk</em><br>menunjukkan kode negara ISO dari domain tempat tautan perujuk berada dan jumlah tautan per negara"
    }
  }
}
```

### Response36Afe1097B20_BacklinksReferringNetworksLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveTaskInfo"
              }
            ]
          },
          "description": "<em>array tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BacklinksReferringNetworksLiveResultInfo

`#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>target</code> dalam array POST</em>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>total item relevan dalam database</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah item dalam array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveItem"
          }
        ]
      },
      "description": "<em>array items</em>"
    }
  }
}
```

### Response36Afe1097B20_BacklinksReferringNetworksLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksReferringNetworksLiveResultInfo"
              }
            ]
          },
          "description": "<em>array hasil</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi API saat ini"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "total waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah tugas dalam array tasks yang dikembalikan dengan error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "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": {
      "type": [
        "string",
        "null"
      ],
      "description": "pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "waktu eksekusi, detik"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total biaya tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "jumlah elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Jalur URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST"
    }
  }
}
```
