# Gambaran Keseluruhan Kedudukan Domain

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live`

**Tags:** DataForSEO

Jejak carian sesuatu domain: kiraan kata kunci organik dan berbayar, anggaran trafik dan nilai trafik, mengikut `location_code`. Memulangkan `se_type`, `target`, `total_count`, `items_count` dan `items`. Dibungkus dalam sampul DataForSEO: data dalam `tasks[0].result`, hasil dalam `tasks[0].status_code` - permintaan yang ditolak masih memulangkan HTTP 200. Untuk nombor yang sama dari semasa ke semasa, gunakan `post_dataforseo_labs_google_historical_rank_live`; untuk banyak domain sekali gus, `post_dataforseo_labs_google_bulk_traffic_estimation_live`.

### Rujukan harga

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

- [artikel pusat bantuan ini](<https://dataforseo.com/help-center/how-is-etv-calculated>)
- [artikel pusat bantuan ini](<https://dataforseo.com/help-center/how-is-traffic-cost-calculated>)
- [artikel pusat bantuan ini](<https://dataforseo.com/help-center/whats-clickstream-estimated-traffic-volume-and-how-is-it-calculated>)
- [artikel pusat bantuan ini](<https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them>)

## 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</em><br><strong>medan wajib</strong><br>nama domain laman web sasaran<br>domain harus ditentukan tanpa <code>https://</code> dan <code>www.</code>"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nama penuh lokasi</em><br>medan pilihan<br>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>location_code</code><br>anda boleh mendapatkan senarai lokasi tersedia bersama <code>location_name</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>abaikan medan ini untuk mendapatkan hasil bagi semua lokasi tersedia<br>contoh:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>kod lokasi</em><br>medan pilihan<br>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>location_name</code><br>anda boleh mendapatkan senarai lokasi tersedia bersama <code>location_code</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>abaikan medan ini untuk mendapatkan hasil bagi semua lokasi tersedia<br>contoh:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nama penuh bahasa</em><br>medan pilihan<br>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>language_code</code><br>anda boleh mendapatkan senarai bahasa tersedia bersama <code>language_name</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>abaikan medan ini untuk mendapatkan hasil bagi semua bahasa tersedia<br>contoh:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>kod bahasa</em><br>medan pilihan<br>jika anda menggunakan medan ini, anda tidak perlu menentukan <code>language_name</code><br>anda boleh mendapatkan senarai bahasa tersedia bersama <code>language_code</code> masing-masing dengan membuat permintaan berasingan ke <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>abaikan medan ini untuk mendapatkan hasil bagi semua bahasa tersedia<br>contoh:<br><code class=\"long-string\">en</code>"
          },
          "ignore_synonyms": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>abaikan kata kunci yang sangat serupa</em><br>medan pilihan<br>jika ditetapkan kepada <code class=\"prettyprint\">true</code>, semua kata kunci yang sangat serupa akan dikecualikan daripada pengiraan kedudukan dan trafik, hasil akan berdasarkan data untuk kata kunci utama daripada kumpulan sinonim<br>nilai lalai: <code>false</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>bilangan maksimum hasil yang dipulangkan untuk domain</em><br>medan pilihan<br>nilai lalai: <code>100</code><br>nilai maksimum: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>offset dalam tatasusunan hasil item yang dipulangkan</em><br>medan pilihan<br>nilai lalai: <code>0</code><br>jika anda menetapkan nilai <code>10</code>, sepuluh <code>items</code> pertama dalam tatasusunan hasil akan dilangkau dan data akan disediakan untuk item seterusnya"
          },
          "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": "dataforseo.com",
            "language_name": "English",
            "location_code": 2840
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "language_name": "English",
      "location_code": 2840
    }
  ]
}
```

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

### 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_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_DataforseoLabsGoogleDomainRankOverviewLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>jenis enjin carian</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kod lokasi dalam array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kod bahasa dalam array POST</em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo"
      },
      "description": "<em>data kedudukan yang berkaitan dengan domain yang ditentukan</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo`

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

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>jenis enjin carian</em>"
    },
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>domain sasaran dalam array POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kod lokasi dalam array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>kod bahasa dalam array POST</em>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan hasil yang dipulangkan dalam array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem"
          }
        ]
      },
      "description": "<em>mengandungi data kedudukan dan trafik</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo`

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

### Response36Afe1097B20_DataforseoLabsMetricsInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo`

```json
{
  "type": "object",
  "properties": {
    "pos_1": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #1</em>"
    },
    "pos_2_3": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #2-3</em>"
    },
    "pos_4_10": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #4-10</em>"
    },
    "pos_11_20": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #11-20</em>"
    },
    "pos_21_30": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #21-30</em>"
    },
    "pos_31_40": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #31-40</em>"
    },
    "pos_41_50": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #41-50</em>"
    },
    "pos_51_60": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #51-60</em>"
    },
    "pos_61_70": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #61-70</em>"
    },
    "pos_71_80": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #71-80</em>"
    },
    "pos_81_90": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #81-90</em>"
    },
    "pos_91_100": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan SERP organik tempat domain atau subdomain menduduki #91-100</em>"
    },
    "etv": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>anggaran volum trafik</em><br>anggaran trafik organik bulanan ke domain atau subdomain<br>dikira sebagai hasil darab CTR (click-through-rate) dan nilai volum carian semua kata kunci dalam kategori yang diduduki domain atau subdomain<br>ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah keseluruhan SERP organik yang mengandungi domain atau subdomain</em>",
      "format": "int64"
    },
    "estimated_paid_traffic_cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>anggaran kos menukar trafik carian organik kepada berbayar</em><br>mewakili anggaran kos bulanan (USD) untuk menjalankan iklan bagi semua kata kunci dalam kategori yang diduduki domain atau subdomain<br>metrik dikira sebagai hasil darab nilai <code>etv</code> organik dan <code>cpc</code> berbayar dan menunjukkan kos memacu anggaran volum trafik organik bulanan melalui pengiklanan PPC dalam Google Search<br>ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini"
    },
    "is_new": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>bilangan elemen berkedudukan baharu</em><br>menunjukkan berapa banyak elemen berkedudukan baharu ditemui bagi sasaran yang dinyatakan"
    },
    "is_up": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kedudukan meningkat</em><br>menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah meningkat"
    },
    "is_down": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kedudukan menurun</em><br>menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah menurun"
    },
    "is_lost": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>elemen berkedudukan yang hilang</em><br>menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan sebelum ini muncul dalam SERP, tetapi tidak ditemui semasa semakan terakhir"
    },
    "clickstream_etv": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>anggaran volum trafik berdasarkan data clickstream</em><br>dikira sebagai hasil darab click-through-rate dan nilai volum carian clickstream semua kata kunci yang diduduki domain<br>untuk mendapatkan hasil bagi medan ini, parameter <code>include_clickstream_data</code> mesti ditetapkan kepada <code>true</code><br>ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini",
      "format": "double"
    },
    "clickstream_gender_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>taburan anggaran metrik berasaskan clickstream mengikut jantina</em><br>untuk mendapatkan hasil bagi medan ini, parameter <code>include_clickstream_data</code> mesti ditetapkan kepada <code>true</code><br>ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini"
    },
    "clickstream_age_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>taburan metrik berasaskan clickstream mengikut umur</em><br>untuk mendapatkan hasil bagi medan ini, parameter <code>include_clickstream_data</code> mesti ditetapkan kepada <code>true</code><br>ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini"
    }
  }
}
```
