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

API Trend Frasa – Analisis Kandungan

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

DataForSEO

​

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

DataForSEO Operasi

API Trend Frasa – Analisis Kandungan

​

Metrik ringkasan untuk satu kata kunci, diulang setiap tempoh masa. Setiap entri membawa date bersama 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. date_from, date_to dan date_group (day, week, month) menetapkan julat dan kebutiran. Gunakannya untuk melihat sama ada sebutan sesuatu frasa meningkat atau menurun; untuk satu titik masa, gunakan post_dataforseo_content_summary_live. Untuk menjejak keseluruhan kategori produk dan bukan satu frasa, gunakan post_dataforseo_content_category_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)[]
    • date_from
      Jenis: string

      tarikh mula julat masa
      medan wajib
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • date_group
      Jenis: string | null

      julat masa yang akan digunakan untuk mengumpulkan hasil
      medan pilihan
      nilai lalai: month
      nilai yang mungkin: day, week, month

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      jika anda tidak menentukan medan ini, tarikh hari ini akan digunakan secara lalai
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • 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, match, not_match
      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": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}

      • 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"

    • 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

    • search_mode
      Jenis: string | null

      jenis pengumpulan hasil
      medan pilihan
      jenis pengumpulan yang mungkin:
      as_is - memulangkan data semua sitasi bagi keyword sasaran
      one_per_domain - memulangkan data satu sitasi keyword setiap domain
      nilai lalai: as_is

    • 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_ContentAnalysisPhraseTrendsLiveResponseInfo
    • 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_ContentAnalysisPhraseTrendsLiveTaskInfo
        • 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 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).

          • date
            Jenis: string | null

            tarikh data disediakan

          • 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 bagi tarikh tertentu

          • sentiment_connotations
            Jenis: object | null

            konotasi sentimen
            mengandungi sentimen (reaksi emosi) berkaitan petikan kata kunci sasaran dan bilangan petikan bagi setiap sentimen
            konotasi 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/phrase_trends/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/phrase_trends/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "date_from": "2022-09-01",
    "date_group": "month"
  }
]'

{
  "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,
          "date": 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 berjaya

Content Analysis – Phrase Trends API