# API Taburan Penilaian – Analisis Kandungan

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/content_analysis/rating_distribution/live`

**Tags:** DataForSEO

Membahagikan sitasi sesuatu kata kunci kepada kumpulan penilaian dan melaporkan set metrik penuh bagi setiap satu. Memulangkan satu entri setiap kumpulan dengan `min`, `max` dan objek `metrics` yang mengandungi `total_count`, `rank`, `top_domains` (setiap satu `domain` dan `count`), `sentiment_connotations` (anger, happiness, love, sadness, share, fun), `connotation_types` (positive, negative, neutral), `text_categories`, `page_categories`, `page_types`, `countries` dan `languages`. `rank_scale` memilih cara pembahagian. Untuk metrik yang sama tanpa pembahagian, gunakan `post_dataforseo_content_summary_live`; untuk sentimen sahaja, `post_dataforseo_content_sentiment_analysis_live`.

### Rujukan harga

- Pemeteran: kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0,0276.
- 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](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [Search endpoint](<https://docs.dataforseo.com/v3/content_analysis/search/live/?bash>)
- [API Analisis Kandungan - Penapis](<https://docs.dataforseo.com/v3/content_analysis/filters>)
- [artikel pusat bantuan ini.](<https://dataforseo.com/help-center/what-are-the-initial-dataset-filters-and-how-do-they-work>)
- [artikel Pusat Bantuan ini](<https://dataforseo.com/help-center/using-the-rank_scale-parameter-in-content-analysis-api>)
- [Categories](<https://docs.dataforseo.com/v3/content_analysis/categories/>)
- [Locations](<https://docs.dataforseo.com/v3/content_analysis/locations/>)
- [Languages](<https://docs.dataforseo.com/v3/content_analysis/languages/>)

## 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": {
          "keyword": {
            "type": "string",
            "description": "<em>kata kunci sasaran</em><br><strong>medan wajib</strong><br>pengekodan UTF-8<br>kata kunci akan ditukar kepada format huruf kecil;<br><strong>Nota</strong>: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik; <br>contoh: <br><code>\"keyword\": \"\\\"tesla palo alto\\\"\"</code><p>ketahui lebih lanjut tentang peraturan dan had medan <code>keyword</code> dan <code>keywords</code> dalam API DataForSEO dalam artikel Pusat Bantuan ini"
          },
          "keyword_fields": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "<em>medan kata kunci sasaran dan kata kunci sasaran</em><br>medan pilihan<br>gunakan parameter ini untuk menapis set data mengikut kata kunci yang perlu terkandung dalam medan tertentu;<br>medan yang boleh anda tentukan: <code>title</code>, <code>main_title</code>, <code>previous_title</code>, <code>snippet</code><br>anda boleh menyatakan beberapa medan;<br><strong>Nota</strong>: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik; <br>contoh:<br>`\"keyword_fields\": {<br>\"snippet\": \"\\\"logitech mouse\\\"\",<br>\"main_title\": \"sale\"<br>}`"
          },
          "page_type": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>jenis halaman sasaran</em><br>medan pilihan<br>gunakan parameter ini untuk menapis set data mengikut jenis halaman<br>nilai yang mungkin: <br><code>\"ecommerce\"</code>, <code>\"news\"</code>, <code>\"blogs\"</code>, <code>\"message-boards\"</code>, <code>\"organization\"</code>"
          },
          "internal_list_limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>bilangan maksimum elemen dalam array dalaman</em><br>medan pilihan<br>anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam array berikut:<br><code>top_domains</code><br><code>text_categories</code><br><code>page_categories</code><br><code>countries</code><br><code>languages</code><br>nilai lalai: <code>1</code><br>nilai maksimum: <code>20</code>"
          },
          "search_mode": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>jenis pengumpulan hasil</em><br>medan pilihan<br>jenis pengumpulan yang mungkin:<br><code>as_is</code> - memulangkan semua sitasi bagi <code>keyword</code> sasaran<br><code>one_per_domain</code> - memulangkan satu sitasi <code>keyword</code> setiap domain<br>nilai lalai: <code>as_is</code>"
          },
          "positive_connotation_threshold": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>ambang konotasi positif</em><br>medan pilihan<br>dinyatakan sebagai ambang indeks kebarangkalian untuk sentimen positif berkaitan kandungan sitasi<br>jika anda menentukan medan ini, objek <code>connotation_types</code> dalam respons hanya akan mengandungi data sitasi dengan kebarangkalian sentimen <code>positive</code> lebih besar daripada atau sama dengan nilai yang ditentukan<br>nilai yang mungkin: daripada <code>0</code> hingga <code>1</code><br>nilai lalai: <code>0.4</code>"
          },
          "sentiments_connotation_threshold": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>ambang konotasi sentimen</em><br>medan pilihan<br>dinyatakan sebagai ambang indeks kebarangkalian untuk konotasi sentimen berkaitan kandungan sitasi<br>jika anda menentukan medan ini, objek <code>sentiment_connotations</code> dalam respons hanya akan mengandungi data sitasi yang kebarangkalian setiap sentimennya lebih besar daripada atau sama dengan nilai yang ditentukan<br>nilai yang mungkin: daripada <code>0</code> hingga <code>1</code><br>nilai lalai: <code>0.4</code>"
          },
          "initial_dataset_filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>parameter penapisan set data awal</em><br>medan pilihan<br>parameter penapisan awal yang digunakan pada medan dalam Search endpoint<br><strong>anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)</strong><br>anda harus menetapkan operator logik <code>and</code>, <code>or</code> antara syarat<br>operator berikut disokong:<br><code>regex</code>, <code>not_regex</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>,<code>not_like</code>, <code>has</code>, <code>has_not</code>, <code>match</code>, <code>not_match</code><br>anda boleh menggunakan operator <code>%</code> dengan <code>like</code> dan <code>not_like</code> untuk memadankan sebarang rentetan dengan sifar atau lebih aksara<br>contoh:<br><code>[\"domain\",\"&lt;&gt;\", \"logitech.com\"]</code><p><code>[[\"domain\",\"&lt;&gt;\",\"logitech.com\"],\"and\",[\"content_info.connotation_types.negative\",\"&gt;\",1000]]</code><p><code>[[\"domain\",\"&lt;&gt\",\"logitech.com\"]],<br>\"and\",<br>[[\"content_info.connotation_types.negative\",\"&gt;\",1000],<br>\"or\",<p>[\"content_info.text_category\",\"has\",10994]]]</code><br>untuk maklumat lanjut tentang penapis, rujuk API Analisis Kandungan - Penapis<br>ketahui lebih lanjut tentang penapis set data awal dalam artikel pusat bantuan ini."
          },
          "rank_scale": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>menentukan skala yang digunakan untuk mengira dan memaparkan nilai <code>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 yang mungkin:<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 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": [
          {
            "keyword": "logitech",
            "search_mode": "as_is",
            "internal_list_limit": 10
          }
        ]
      }
    ]
  },
  "example": [
    {
      "keyword": "logitech",
      "search_mode": "as_is",
      "internal_list_limit": 10
    }
  ]
}
```

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

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

`#/components/schemas/Response36Afe1097B20_ContentAnalysisCategoriesInfo`

```json
{
  "properties": {
    "category": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo`

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

### Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResultInfo

`#/components/schemas/Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis elemen"
    },
    "min": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>penilaian minimum pada skala taburan</strong></em>"
    },
    "max": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>penilaian maksimum pada skala taburan</strong></em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_ContentAnalysisSummaryInfo"
        }
      ],
      "description": "<em>mengandungi metrik taburan penilaian</strong></em>"
    }
  }
}
```

### Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo`

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

### Response36Afe1097B20_ContentAnalysisSummaryInfo

`#/components/schemas/Response36Afe1097B20_ContentAnalysisSummaryInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "jenis elemen"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda</em>",
      "format": "int64"
    },
    "rank": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>kedudukan semua URL yang memetik <code>keyword</code></em><br>jumlah ternormal bagi kedudukan semua URL yang memetik <code>keyword</code> sasaran"
    },
    "top_domains": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_TopDomainInfo"
          }
        ]
      },
      "description": "<em>domain teratas yang memetik kata kunci sasaran</em><br>mengandungi objek dengan domain teratas yang memetik kata kunci sasaran dan bilangan petikan bagi setiap domain"
    },
    "sentiment_connotations": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>konotasi sentimen</em><br>mengandungi sentimen (reaksi emosi) berkaitan petikan kata kunci sasaran dan bilangan petikan bagi setiap sentimen<br>konotasi sentimen tersedia: <code>anger</code>, <code>happiness</code>, <code>love</code>, <code>sadness</code>, <code>share</code>, <code>fun</code>"
    },
    "connotation_types": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>jenis konotasi</em><br>mengandungi jenis sentimen (polariti sentimen) berkaitan petikan kata kunci dan bilangan petikan bagi setiap jenis sentimen<br>jenis konotasi sentimen tersedia: <code>positive</code>, <code>negative</code>, <code>neutral</code>"
    },
    "text_categories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ContentAnalysisCategoriesInfo"
          }
        ]
      },
      "description": "<em>kategori teks</em><br>mengandungi objek dengan kategori teks dan bilangan petikan dalam setiap kategori teks<br>untuk mendapatkan senarai penuh kategori yang tersedia, rujuk endpoint Categories"
    },
    "page_categories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ContentAnalysisCategoriesInfo"
          }
        ]
      },
      "description": "<em>kategori halaman</em><br>mengandungi objek dengan kategori halaman dan bilangan petikan dalam setiap kategori halaman<br>untuk mendapatkan senarai penuh kategori yang tersedia, rujuk endpoint Categories"
    },
    "page_types": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>jenis halaman</em><br>mengandungi jenis halaman dan bilangan petikan bagi setiap jenis halaman"
    },
    "countries": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>negara</em><br>mengandungi negara dan bilangan petikan di setiap negara<br>untuk mendapatkan senarai penuh negara yang tersedia, rujuk endpoint Locations"
    },
    "languages": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>bahasa</em><br>mengandungi bahasa dan bilangan petikan dalam setiap bahasa<br>untuk mendapatkan senarai penuh bahasa yang tersedia, rujuk endpoint Languages"
    }
  }
}
```

### Response36Afe1097B20_TopDomainInfo

`#/components/schemas/Response36Afe1097B20_TopDomainInfo`

```json
{
  "properties": {
    "domain": {
      "type": [
        "string",
        "null"
      ]
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int64"
    }
  }
}
```
