Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

API Distribusi Peringkat – Analisis Konten

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

API Distribusi Peringkat – Analisis Konten

​

Membagi sitasi sebuah kata kunci ke dalam kelompok peringkat dan melaporkan set metrik lengkap untuk masing-masing. Mengembalikan satu entri per kelompok dengan min, max, dan objek metrics yang berisi total_count, rank, top_domains (masing-masing 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 pengelompokan. Untuk metrik yang sama tanpa pengelompokan, gunakan post_dataforseo_content_summary_live; untuk sentimen saja, post_dataforseo_content_sentiment_analysis_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.

Isi
application/json
  • Tipe: array (object | null)[]
    • initial_dataset_filters
      Tipe: array (object | null)[] | null

      parameter filter set data awal
      field opsional
      parameter filter awal yang berlaku untuk field di Search endpoint
      Anda dapat menambahkan beberapa filter sekaligus (maksimal 8 filter)
      Anda harus menetapkan operator logika and, or di antara kondisi
      operator berikut didukung:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
      Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
      contoh:
      ["domain","<>", "logitech.com"]

      [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]

      [["domain","<&gt","logitech.com"]],
      "and",
      [["content_info.connotation_types.negative",">",1000],
      "or",

      ["content_info.text_category","has",10994]]]
      untuk informasi selengkapnya tentang filter, lihat API Analisis Konten - Filter
      pelajari lebih lanjut tentang filter set data awal di artikel pusat bantuan ini.

      Objek kosong
    • internal_list_limit
      Tipe: integer | null

      jumlah maksimum elemen dalam array internal
      field opsional
      Anda dapat menggunakan field ini untuk membatasi jumlah elemen dalam array berikut:
      top_domains
      text_categories
      page_categories
      countries
      languages
      nilai default: 1
      nilai maksimum: 20

    • keyword
      Tipe: string

      kata kunci target
      field wajib
      pengodean UTF-8
      kata kunci akan diubah ke format huruf kecil;
      Catatan: untuk mencocokkan frasa persis alih-alih kata kunci mandiri, gunakan tanda kutip ganda dan garis miring terbalik;
      contoh:
      "keyword": ""tesla palo alto""

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • keyword_fields
      Tipe: object | null

      field kata kunci target dan kata kunci target
      field opsional
      gunakan parameter ini untuk memfilter set data berdasarkan kata kunci yang harus dimuat oleh field tertentu;
      field yang dapat Anda tentukan: title, main_title, previous_title, snippet
      Anda dapat menunjukkan beberapa field;
      Catatan: untuk mencocokkan frasa persis alih-alih kata kunci mandiri, gunakan tanda kutip ganda dan garis miring terbalik;
      contoh:
      "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}

      • propertyName
        Tipe: string | null
    • page_type
      Tipe: array string[] | null

      jenis halaman target
      field opsional
      gunakan parameter ini untuk memfilter set data berdasarkan jenis halaman
      nilai yang mungkin:
      "ecommerce", "news", "blogs", "message-boards", "organization"

    • positive_connotation_threshold
      Tipe: number | null

      ambang konotasi positif
      field opsional
      ditentukan sebagai ambang indeks probabilitas untuk sentimen positif terkait konten sitasi
      jika Anda menentukan field ini, objek connotation_types dalam respons hanya akan berisi data sitasi dengan probabilitas sentimen positive lebih besar dari atau sama dengan nilai yang ditentukan
      nilai yang mungkin: dari 0 hingga 1
      nilai default: 0.4

    • rank_scale
      Tipe: string | null

      menentukan skala yang digunakan untuk menghitung dan menampilkan nilai rank
      field opsional

      Anda dapat menggunakan parameter ini untuk memilih apakah nilai rank disajikan pada skala 0–100 atau 0–1000

      nilai yang mungkin:
      one_hundred — nilai rank ditampilkan pada skala 0–100
      one_thousand — nilai rank ditampilkan pada skala 0–1000

      nilai default: one_thousand

      pelajari lebih lanjut tentang cara parameter ini bekerja di artikel Pusat Bantuan ini

    • search_mode
      Tipe: string | null

      jenis pengelompokan hasil
      field opsional
      jenis pengelompokan yang mungkin:
      as_is - mengembalikan semua sitasi untuk keyword target
      one_per_domain - mengembalikan satu sitasi keyword per domain
      nilai default: as_is

    • sentiments_connotation_threshold
      Tipe: number | null

      ambang konotasi sentimen
      field opsional
      ditentukan sebagai ambang indeks probabilitas untuk konotasi sentimen terkait konten sitasi
      jika Anda menentukan field ini, objek sentiment_connotations dalam respons hanya akan berisi data sitasi yang probabilitas setiap sentimennya lebih besar dari atau sama dengan nilai yang ditentukan
      nilai yang mungkin: dari 0 hingga 1
      nilai default: 0.4

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: array (object | null)[] | null

          array hasil

          • max
            Tipe: number | null

            peringkat maksimum pada skala distribusi

          • metrics
            Tipe: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            berisi metrik distribusi peringkat

            • connotation_types
              Tipe: object | null

              jenis konotasi
              berisi jenis sentimen (polaritas sentimen) yang terkait dengan kutipan kata kunci dan jumlah kutipan per jenis sentimen
              jenis konotasi sentimen yang tersedia: positive, negative, neutral

              • propertyName
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • countries
              Tipe: object | null

              negara
              berisi negara dan jumlah kutipan di setiap negara
              untuk mendapatkan daftar lengkap negara yang tersedia, lihat endpoint Locations

              • propertyName
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • languages
              Tipe: object | null

              bahasa
              berisi bahasa dan jumlah kutipan di setiap bahasa
              untuk mendapatkan daftar lengkap bahasa yang tersedia, lihat endpoint Languages

              • propertyName
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • page_categories
              Tipe: array (object | null)[] | null

              kategori halaman
              berisi objek dengan kategori halaman dan jumlah kutipan di setiap kategori halaman
              untuk mendapatkan daftar lengkap kategori yang tersedia, lihat endpoint Categories

              • category
                Tipe: array (integer | null)[] | null
              • count
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • page_types
              Tipe: object | null

              jenis halaman
              berisi jenis halaman dan jumlah kutipan per jenis halaman

              • propertyName
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • rank
              Tipe: integer | null

              peringkat semua URL yang mengutip keyword
              jumlah ternormalisasi peringkat semua URL yang mengutip keyword target

            • sentiment_connotations
              Tipe: object | null

              konotasi sentimen
              berisi sentimen (reaksi emosional) yang terkait dengan kutipan kata kunci target dan jumlah kutipan per sentimen
              konotasi sentimen yang tersedia: anger, happiness, love, sadness, share, fun

              • propertyName
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • text_categories
              Tipe: array (object | null)[] | null

              kategori teks
              berisi objek dengan kategori teks dan jumlah kutipan di setiap kategori teks
              untuk mendapatkan daftar lengkap kategori yang tersedia, lihat endpoint Categories

              • category
                Tipe: array (integer | null)[] | null
              • count
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

            • top_domains
              Tipe: array (object | null)[] | null

              domain teratas yang mengutip kata kunci target
              berisi objek dengan domain teratas yang mengutip kata kunci target dan jumlah kutipan per domain

              • count
                Tipe: integer | null Format: int64

                Signed 64-bit integers (long type).

              • domain
                Tipe: string | null
            • total_count
              Tipe: integer | null Format: int64

              jumlah total hasil di basis data kami yang relevan dengan permintaan Anda

            • type
              Tipe: string | null

              jenis elemen

          • min
            Tipe: number | null

            peringkat minimum pada skala distribusi

          • type
            Tipe: string | null

            jenis elemen

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          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
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 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
Request Example for post/v1/beta/dataforseo/content_analysis/rating_distribution/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "internal_list_limit": 10
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "type": null,
          "min": null,
          "max": null,
          "metrics": {
            "type": null,
            "total_count": null,
            "rank": null,
            "top_domains": [
              "[Max Depth Exceeded]"
            ],
            "sentiment_connotations": null,
            "connotation_types": null,
            "text_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_types": null,
            "countries": null,
            "languages": null
          }
        }
      ]
    }
  ]
}

Operasi berhasil

Content Analysis – Rating Distribution API