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

API Ringkasan – 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 Ringkasan – Analisis Konten

​

Tampilan agregat atas setiap sitasi sebuah kata kunci di seluruh indeks web. Mengembalikan 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. Ini adalah pusat keluarga konten: post_dataforseo_content_sentiment_analysis_live hanya mengembalikan dua blok konotasi yang sudah termasuk di sini, jadi panggil endpoint ini kecuali Anda memang menginginkan payload yang lebih kecil. Untuk halaman penyitasi individual alih-alih total, gunakan post_dataforseo_content_search_live; untuk agregat yang sama dari waktu ke waktu, post_dataforseo_content_phrase_trends_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
      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": {
      "snippet": ""logitech mouse"",
      "main_title": "sale"
      }

      • 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

    • 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_ContentAnalysisSummaryLiveResponseInfo
    • 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_ContentAnalysisSummaryLiveTaskInfo
        • 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

          • 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

        • 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/summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "internal_list_limit": 8,
    "positive_connotation_threshold": 0.5
  }
]'

{
  "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,
          "total_count": null,
          "rank": null,
          "top_domains": [
            {
              "domain": null,
              "count": null
            }
          ],
          "sentiment_connotations": null,
          "connotation_types": null,
          "text_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_types": null,
          "countries": null,
          "languages": null
        }
      ]
    }
  ]
}

Operasi berhasil

Content Analysis – Summary API