# Ringkasan Pautan Balik

**API:** Data API

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

**Tags:** DataForSEO

Seluruh profil pautan balik satu `target` dalam satu panggilan: `first_seen`, `lost_date`, `rank`, `backlinks`, `backlinks_spam_score`, `crawled_pages`, `internal_links_count` dan blok `info`, bersama kiraan domain perujuk dan sauh. Ini hab keluarga - mulakan di sini, kemudian telusuri bahagian yang penting: `post_dataforseo_backlinks_backlinks_live` untuk pautan individu, `post_dataforseo_backlinks_referring_domains_live` untuk siapa yang memaut, `post_dataforseo_backlinks_anchors_live` untuk teks yang mereka gunakan. Endpoint ini tidak mengambil parameter had, jadi satu-satunya tuas ialah memanggilnya dengan lebih jarang.

### Rujukan harga

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

## Related links

- [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>)
- [halaman Pusat Bantuan ini](<https://dataforseo.com/help-center/what-is-spam-score-and-how-is-it-calculated>)
- [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 data</em><br><strong>medan wajib</strong><br>domain atau subdomain harus ditentukan tanpa <code>https://</code> dan <code>www.</code><br>halaman harus ditentukan dengan URL mutlak (termasuk <code>http://</code> atau <code>https://</code>)"
          },
          "include_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan sama ada subdomain bagi <code>target</code> akan disertakan dalam carian</em><br>medan pilihan<br>jika ditetapkan kepada <code>false</code>, subdomain akan diabaikan<br>nilai lalai: <code>true</code>"
          },
          "include_indirect_links": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan sama ada pautan tidak langsung ke <code>target</code> akan disertakan dalam hasil</em><br>medan pilihan<br>jika ditetapkan kepada <code>true</code>, hasil akan menyertakan data tentang pautan tidak langsung yang menunjuk ke halaman yang mengubah hala ke sasaran, atau menunjuk ke halaman kanonikal<br>jika ditetapkan kepada <code>false</code>, pautan tidak langsung akan diabaikan<br>nilai lalai: <code>true</code>"
          },
          "exclude_internal_backlinks": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>menunjukkan sama ada pautan balik dalaman daripada subdomain ke <code>target</code> akan dikecualikan daripada hasil</em><br>medan pilihan<br>jika ditetapkan kepada <code>true</code>, hasil tidak akan menyertakan data tentang pautan balik dalaman daripada subdomain domain yang sama dengan <code>target</code><br>jika ditetapkan kepada <code>false</code>, pautan dalaman akan disertakan dalam hasil<br>nilai lalai: <code>true</code>"
          },
          "internal_list_limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>bilangan maksimum elemen dalam tatasusunan dalaman</em><br>medan pilihan<br>anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam tatasusunan 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 lalai: <code>10</code><br>nilai maksimum: <code>1000</code>"
          },
          "backlinks_status_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tetapkan pautan balik yang hendak dikembalikan dan dikira</em><br>medan pilihan<br>anda boleh menggunakan medan ini untuk memilih pautan balik yang akan dikembalikan dan digunakan untuk metrik teragregat <code>target</code> anda;<br>nilai yang mungkin: <br><code>all</code> - semua pautan balik akan dikembalikan dan dikira;<br><code>live</code> - pautan balik yang ditemui semasa pemeriksaan terakhir akan dikembalikan dan dikira;<br><code>lost</code> - pautan balik yang hilang akan dikembalikan dan dikira;<p>nilai lalai: <code>live</code>"
          },
          "backlinks_filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>menapis pautan balik <code>target</code> anda</em><br>medan pilihan<br>anda boleh menggunakan medan ini untuk menapis pautan balik awal yang akan disertakan dalam set data bagi metrik agregat <code>target</code> anda<br>anda boleh menapis pautan balik mengikut semua medan yang tersedia dalam respons endpoint ini<br>dengan parameter ini, anda boleh menyertakan hanya pautan balik dofollow dalam respons dan mencipta set data pautan balik yang fleksibel untuk mengira metrik<br>contoh:<br><code>\"backlinks_filters\": [\"dofollow\", \"=\", true]</code>"
          },
          "rank_scale": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>menentukan skala yang digunakan untuk mengira dan memaparkan nilai <code>rank</code>, <code>domain_from_rank</code> dan <code>page_from_rank</code></em><br>medan pilihan<p>anda boleh menggunakan parameter ini untuk memilih sama ada nilai rank dipaparkan pada skala 0–100 atau 0–1000<p>nilai tersedia:<br><code>one_hundred</code> — nilai rank dipaparkan pada skala 0–100<br><code>one_thousand</code> — nilai rank dipaparkan pada skala 0–1000<p>nilai lalai: <code>one_thousand</code><p>ketahui lebih lanjut tentang cara parameter ini berfungsi dan cara metrik kedudukan dikira dalam artikel Pusat Bantuan ini"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>pengecam tugas yang ditentukan pengguna</em><br>medan pilihan<br><em>had aksara ialah 255</em><br>anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil<br>anda akan menemui nilai <code>tag</code> yang ditentukan dalam objek <code>data</code> respons"
          }
        },
        "example": [
          {
            "target": "explodingtopics.com",
            "internal_list_limit": 10,
            "include_subdomains": true,
            "backlinks_filters": [
              "dofollow",
              "=",
              true
            ],
            "backlinks_status_type": "all"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "explodingtopics.com",
      "internal_list_limit": 10,
      "include_subdomains": true,
      "backlinks_filters": [
        "dofollow",
        "=",
        true
      ],
      "backlinks_status_type": "all"
    }
  ]
}
```

## Responses

### 200 — Operasi berjaya

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

Schema: object | null

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

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

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BacklinksSummaryLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_BacklinksSummaryLiveResponseInfo`

```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_BacklinksSummaryLiveTaskInfo"
              }
            ]
          },
          "description": "<em>tatasusunan tugas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BacklinksSummaryLiveResultInfo

`#/components/schemas/Response36Afe1097B20_BacklinksSummaryLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>target</code> dalam array POST</em>"
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tarikh dan masa perangkak kami mula-mula menemui pautan balik untuk <code>target</code></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>tarikh dan masa pautan balik hilang</em><br>menunjukkan tarikh dan masa perangkak kami melawati sasaran dan sasaran membalas dengan kod status 4xx atau 5xx, atau apabila pautan balik terakhirnya dialih keluar<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>"
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kedudukan <code>target</code><br>ketahui lebih lanjut tentang metrik dan cara pengiraannya dalam artikel Pusat Bantuan ini"
    },
    "backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan bilangan pautan balik</em>",
      "format": "int64"
    },
    "backlinks_spam_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>skor spam pautan balik</em><br>memaparkan jumlah skor spam semua pautan balik yang menunjuk ke domain, subdomain atau halaman web <code>target</code>;<br>untuk mengetahui lebih lanjut cara metrik dikira, rujuk halaman Pusat Bantuan ini",
      "format": "int64"
    },
    "crawled_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan halaman yang dirangkak untuk <code>target</code></em>"
    },
    "info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_TargetInfo"
        }
      ],
      "description": "<em>maklumat tentang <code>target</code></em>"
    },
    "internal_links_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan pautan dalaman</em><br>dikira sebagai jumlah pautan dalaman pada halaman <code>target</code> yang ditentukan",
      "format": "int64"
    },
    "external_links_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan pautan luaran pada halaman</em><br>dikira sebagai jumlah pautan luaran pada halaman <code>target</code> yang ditentukan",
      "format": "int64"
    },
    "broken_backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan pautan balik rosak</em><br>bilangan pautan balik rosak yang menunjuk ke <code>target</code>",
      "format": "int64"
    },
    "broken_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan halaman rosak</em><br>bilangan halaman pada <code>target</code> yang membalas dengan kod status 4xx atau 5xx<p>ambil perhatian bahawa bilangan halaman rosak merangkumi halaman pada <code>target</code> yang ditemui dengan mengikut pautan luaran, tetapi mungkin juga merangkumi halaman yang ditemui dengan mengikut sitemap sasaran"
    },
    "referring_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan bilangan domain perujuk</em><br>domain perujuk merangkumi subdomain yang dikira sebagai domain berasingan untuk metrik ini",
      "format": "int64"
    },
    "referring_domains_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan domain yang menunjuk sekurang-kurangnya satu pautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_main_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan bilangan domain utama perujuk</em>",
      "format": "int64"
    },
    "referring_main_domains_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan domain utama yang menunjuk sekurang-kurangnya satu pautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_ips": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan alamat IP perujuk</em><br>bilangan alamat IP yang menunjuk ke halaman ini",
      "format": "int64"
    },
    "referring_subnets": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan subrangkaian perujuk</em>",
      "format": "int64"
    },
    "referring_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>menunjukkan bilangan halaman yang menunjuk ke sasaran</em>",
      "format": "int64"
    },
    "referring_pages_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke <code>target</code></em>",
      "format": "int64"
    },
    "referring_links_tld": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>domain peringkat teratas bagi pautan perujuk</em><br>mengandungi domain peringkat teratas dan bilangan pautan perujuk bagi setiap satu"
    },
    "referring_links_types": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>jenis pautan perujuk</em><br>menunjukkan jenis pautan perujuk dan bilangan pautan bagi 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 pautan bagi pautan perujuk</em><br>menunjukkan atribut pautan bagi pautan perujuk dan bilangan pautan bagi setiap atribut<br>contoh nilai:<br><code>nofollow</code>, <code>noopener</code>, <code>noreferrer</code>, <code>external</code>, <code>ugc</code>, <code>sponsored</code>"
    },
    "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 bilangan pautan bagi setiap 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 pautan perujuk</em><br>menunjukkan elemen semantik dalam HTML tempat pautan perujuk berada dan bilangan pautan bagi setiap lokasi semantik<p>anda boleh mendapatkan senarai penuh elemen semantik di sini<br>contoh nilai:<br><code>article</code>, <code>section</code>, <code>summary</code>, <code>\"\"</code>"
    },
    "referring_links_countries": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>kod negara ISO bagi pautan perujuk</em><br>menunjukkan kod negara ISO bagi domain tempat pautan perujuk berada dan bilangan pautan bagi setiap negara"
    }
  }
}
```

### Response36Afe1097B20_BacklinksSummaryLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_BacklinksSummaryLiveTaskInfo`

```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_BacklinksSummaryLiveResultInfo"
              }
            ]
          },
          "description": "<em>tatasusunan hasil</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "versi semasa API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "kod status umum; anda boleh menemui senarai penuh kod respons di sini"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "jumlah masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan tugas dalam array tasks yang dipulangkan dengan ralat",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "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": {
      "type": [
        "string",
        "null"
      ],
      "description": "mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "masa pelaksanaan, saat"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "jumlah kos tugas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "bilangan elemen dalam array hasil",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Laluan URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST"
    }
  }
}
```

### Response36Afe1097B20_TargetInfo

`#/components/schemas/Response36Afe1097B20_TargetInfo`

```json
{
  "type": "object",
  "properties": {
    "server": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>pelayan</em>"
    },
    "cms": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>sistem pengurusan kandungan</em>"
    },
    "platform_type": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>jenis platform</em>"
    },
    "ip_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>alamat IP <code>target</code></em>"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kod negara yang domain <code>target</code> ditentukan sebagai miliknya</em>"
    },
    "is_ip": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>menunjukkan sama ada <code>target</code> ialah IP</em><br>jika <code>true</code>, domain, subdomain atau halaman web berfungsi sebagai alamat IP dan tidak mempunyai nama domain"
    },
    "target_spam_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>skor spam <code>target</code></em><br>jika <code>target</code> ialah domain/subdomain, medan ini menunjukkan skor spam purata semua halaman domain/subdomain itu;<br>ketahui lebih lanjut tentang cara metrik dikira di halaman Pusat Bantuan ini"
    }
  }
}
```
