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

API Ringkasan – Analisis Kandungan

Pelayan:https://openapi.felo.ai
Pustaka Klien

DataForSEO

​

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

API Ringkasan – Analisis Kandungan

​

Pandangan agregat bagi setiap sitasi sesuatu kata kunci merentas indeks web. Memulangkan 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. Ini ialah hab keluarga kandungan: post_dataforseo_content_sentiment_analysis_live hanya memulangkan dua blok konotasi yang sudah termasuk di sini, jadi panggil endpoint ini melainkan anda memang mahukan muatan yang lebih kecil. Untuk halaman penyitasi individu dan bukan jumlah, gunakan post_dataforseo_content_search_live; untuk agregat yang sama dari semasa ke semasa, post_dataforseo_content_phrase_trends_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.

Badan
application/json
  • Jenis: array (object | null)[]
    • initial_dataset_filters
      Jenis: array (object | null)[] | null

      parameter penapisan set data awal
      medan pilihan
      parameter penapisan awal yang digunakan pada medan dalam Search endpoint
      anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
      anda harus menetapkan operator logik and, or antara syarat
      operator berikut disokong:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not
      anda boleh menggunakan operator % dengan like dan not_like untuk memadankan sebarang rentetan dengan sifar atau lebih aksara
      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 maklumat lanjut tentang penapis, rujuk API Analisis Kandungan - Penapis
      ketahui lebih lanjut tentang penapis set data awal dalam artikel pusat bantuan ini.

      Objek kosong
    • internal_list_limit
      Jenis: integer | null

      bilangan maksimum elemen dalam array dalaman
      medan pilihan
      anda boleh menggunakan medan ini untuk mengehadkan bilangan elemen dalam array berikut:
      top_domains
      text_categories
      page_categories
      countries
      languages
      nilai lalai: 1
      nilai maksimum: 20

    • keyword
      Jenis: string

      kata kunci sasaran
      medan wajib
      pengekodan UTF-8
      kata kunci akan ditukar kepada format huruf kecil;
      Nota: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik;
      contoh:
      "keyword": ""tesla palo alto""

      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini

    • keyword_fields
      Jenis: object | null

      medan kata kunci sasaran dan kata kunci sasaran
      medan pilihan
      gunakan parameter ini untuk menapis set data mengikut kata kunci yang perlu terkandung dalam medan tertentu;
      medan yang boleh anda tentukan: title, main_title, previous_title, snippet
      anda boleh menyatakan beberapa medan;
      Nota: untuk memadankan frasa tepat dan bukan kata kunci tunggal, gunakan tanda petik berganda dan garis condong terbalik;
      contoh:
      "keyword_fields": {
      "snippet": ""logitech mouse"",
      "main_title": "sale"
      }

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

      jenis halaman sasaran
      medan pilihan
      gunakan parameter ini untuk menapis set data mengikut jenis halaman
      nilai yang mungkin:
      "ecommerce", "news", "blogs", "message-boards", "organization"

    • positive_connotation_threshold
      Jenis: number | null

      ambang konotasi positif
      medan pilihan
      dinyatakan sebagai ambang indeks kebarangkalian untuk sentimen positif berkaitan kandungan sitasi
      jika anda menentukan medan ini, objek connotation_types dalam respons hanya akan mengandungi data sitasi dengan kebarangkalian sentimen positive lebih besar daripada atau sama dengan nilai yang ditentukan
      nilai yang mungkin: daripada 0 hingga 1
      nilai lalai: 0.4

    • rank_scale
      Jenis: string | null

      menentukan skala yang digunakan untuk mengira dan memaparkan nilai rank
      medan pilihan

      anda boleh menggunakan parameter ini untuk memilih sama ada nilai rank dipaparkan pada skala 0–100 atau 0–1000

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

      nilai lalai: one_thousand

      ketahui lebih lanjut tentang cara parameter ini berfungsi dalam artikel Pusat Bantuan ini

    • sentiments_connotation_threshold
      Jenis: number | null

      ambang konotasi sentimen
      medan pilihan
      dinyatakan sebagai ambang indeks kebarangkalian untuk konotasi sentimen berkaitan kandungan sitasi
      jika anda menentukan medan ini, objek sentiment_connotations dalam respons hanya akan mengandungi data sitasi yang
      kebarangkalian setiap sentimennya lebih besar daripada atau sama dengan nilai yang ditentukan
      nilai yang mungkin: daripada 0 hingga 1
      nilai lalai: 0.4

    • tag
      Jenis: string | null

      pengecam tugas yang ditentukan pengguna
      medan pilihan
      had aksara ialah 255
      anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
      anda akan menemui nilai tag yang ditentukan dalam objek data respons

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

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

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

          Laluan URL

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

          tatasusunan hasil

          • connotation_types
            Jenis: object | null

            jenis konotasi
            mengandungi jenis sentimen (polariti sentimen) berkaitan petikan kata kunci dan bilangan petikan bagi setiap jenis sentimen
            jenis konotasi sentimen tersedia: positive, negative, neutral

            • propertyName
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

          • countries
            Jenis: object | null

            negara
            mengandungi negara dan bilangan petikan di setiap negara
            untuk mendapatkan senarai penuh negara yang tersedia, rujuk endpoint Locations

            • propertyName
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

          • languages
            Jenis: object | null

            bahasa
            mengandungi bahasa dan bilangan petikan dalam setiap bahasa
            untuk mendapatkan senarai penuh bahasa yang tersedia, rujuk endpoint Languages

            • propertyName
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

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

            kategori halaman
            mengandungi objek dengan kategori halaman dan bilangan petikan dalam setiap kategori halaman
            untuk mendapatkan senarai penuh kategori yang tersedia, rujuk endpoint Categories

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

              Signed 64-bit integers (long type).

          • page_types
            Jenis: object | null

            jenis halaman
            mengandungi jenis halaman dan bilangan petikan bagi setiap jenis halaman

            • propertyName
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

          • rank
            Jenis: integer | null

            kedudukan semua URL yang memetik keyword
            jumlah ternormal bagi kedudukan semua URL yang memetik keyword sasaran

          • sentiment_connotations
            Jenis: object | null

            konotasi sentimen
            mengandungi sentimen (reaksi emosi) berkaitan petikan kata kunci sasaran dan bilangan petikan bagi setiap sentimen
            konotasi sentimen tersedia: anger, happiness, love, sadness, share, fun

            • propertyName
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

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

            kategori teks
            mengandungi objek dengan kategori teks dan bilangan petikan dalam setiap kategori teks
            untuk mendapatkan senarai penuh kategori yang tersedia, rujuk endpoint Categories

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

              Signed 64-bit integers (long type).

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

            domain teratas yang memetik kata kunci sasaran
            mengandungi objek dengan domain teratas yang memetik kata kunci sasaran dan bilangan petikan bagi setiap domain

            • count
              Jenis: integer | null Format: int64

              Signed 64-bit integers (long type).

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

            jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda

          • type
            Jenis: string | null

            jenis elemen

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

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

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      versi semasa API

    application/json
  • 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
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
        }
      ]
    }
  ]
}
Content Analysis – Summary API