# Ringkasan Deret Waktu Backlink

**API:** Data API

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

**Tags:** DataForSEO

Metrik backlink inti satu `target` dari waktu ke waktu, dikelompokkan menurut `group_range` (hari, minggu, bulan). Mengembalikan `date_from`, `date_to`, `group_range`, dan satu item per periode. Untuk perolehan dan kehilangan alih-alih total, gunakan `post_dataforseo_backlinks_timeseries_new_lost_live`. Endpoint ini tidak menerima parameter batas, jadi satu-satunya tuas adalah memanggilnya lebih jarang.

### Referensi harga

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

- [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>)

## 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 untuk mendapatkan data</em><br><strong>field wajib</strong><br>domain harus ditentukan tanpa <code>https://</code> dan <code>www.</code><br>contoh:<br><code>\"forbes.com\"</code>"
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tanggal mulai rentang waktu</em><br>field opsional<br>field ini menunjukkan tanggal yang akan digunakan sebagai ambang untuk data ringkasan;<p>nilai minimum: <code>2019-01-30</code><br>nilai maksimum tidak boleh melebihi tanggal yang ditentukan dalam <code>date_to</code><br>format tanggal: <code>\"yyyy-mm-dd\"</code><br>contoh:<br><code>\"2021-01-01\"</code>"
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>tanggal berakhir rentang waktu</em><br>field opsional<br>jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default<br>nilai minimum tidak boleh mendahului tanggal yang ditentukan dalam <code>date_from</code><br>nilai maksimum: tanggal hari ini<br>format tanggal: <code>\"yyyy-mm-dd\"</code><br>contoh:<br><code>\"2021-01-15\"</code>"
          },
          "group_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>rentang waktu yang akan digunakan untuk mengelompokkan hasil</em><br>field opsional<br>nilai default: <code>month</code><br>nilai yang tersedia: <code>day</code>, <code>week</code>, <code>month</code>, <code>year</code><p><strong>catatan:</strong> untuk <code>day</code>, kami akan mengembalikan item yang sesuai dengan semua tanggal antara dan termasuk <code>date_from</code> dan <code>date_to</code>;<br>untuk <code>week</code>/<code>month</code>/<code>year</code>, kami akan mengembalikan item yang sesuai dengan minggu/bulan/tahun penuh, di mana setiap item akan menunjukkan hari terakhir minggu/bulan/tahun tersebut<p>misalnya, jika Anda menentukan: <br><code>\"group_range\": \"month\",<br>\"date_from\": \"2022-03-23\",<br>\"date_to\": \"2022-05-13\"</code><br>kami akan mengembalikan item yang berada di antara 2022-03-01 dan 2022-05-31, yaitu tiga item yang sesuai dengan tanggal berikut: <code>2022-03-31</code>, <code>2022-04-30</code>, <code>2022-05-31</code><p>jika tidak ada data untuk <code>day</code>/<code>week</code>/<code>month</code>/<code>year</code> tertentu, kami akan mengembalikan <code>0</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>"
          },
          "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": "dataforseo.com",
            "date_from": "2021-12-01",
            "date_to": "2022-02-01",
            "group_range": "month"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "date_from": "2021-12-01",
      "date_to": "2022-02-01",
      "group_range": "month"
    }
  ]
}
```

## 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_BacklinksTimeseriesSummaryLiveResponseInfo"
    }
  ]
}
```

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

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesSummaryLiveItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis elemen"
    },
    "date": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal dan waktu saat data untuk target disimpan</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>"
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>peringkat <code>target</code> untuk <code>date</code> tertentu</em><br>pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini"
    },
    "backlinks": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah backlink untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "backlinks_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah backlink nofollow untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "referring_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah halaman yang menunjuk ke <code>target</code> untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "referring_pages_nofollow": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah halaman perujuk yang menunjuk setidaknya satu tautan nofollow ke <code>target</code> untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "referring_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah domain perujuk untuk <code>date</code> tertentu</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> untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "referring_main_domains": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah domain utama perujuk untuk <code>date</code> tertentu</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> untuk <code>date</code> tertentu</em>",
      "format": "int64"
    },
    "referring_ips": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah alamat IP perujuk untuk <code>date</code> tertentu</em><br>jumlah alamat IP yang menunjuk ke halaman ini",
      "format": "int64"
    },
    "referring_subnets": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah subjaringan perujuk untuk <code>date</code> tertentu</em>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo`

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

### Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResultInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>target</code> dari array POST</em>"
    },
    "date_from": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal mulai rentang waktu</em><br>dalam format UTC: “yyyy-mm-dd”<br>contoh:<br><code>2019-01-01</code>"
    },
    "date_to": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tanggal akhir rentang waktu</em><br>dalam format UTC: <code>\"yyyy-mm-dd\"</code><br>contoh:<br><code>\"2019-01-15\"</code>"
    },
    "group_range": {
      "type": [
        "string",
        "null"
      ],
      "description": "group_range dari array POST"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah hasil yang dikembalikan dalam array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesSummaryLiveItem"
          }
        ]
      },
      "description": "<em>berisi data ringkasan yang relevan</em>"
    }
  }
}
```

### Response36Afe1097B20_BacklinksTimeseriesSummaryLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_BacklinksTimeseriesSummaryLiveTaskInfo`

```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_BacklinksTimeseriesSummaryLiveResultInfo"
              }
            ]
          },
          "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"
    }
  }
}
```
