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

API Carian – 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 Carian – Analisis Kandungan

​

Menyenaraikan halaman individu yang menyitasi sesuatu kata kunci, bukan jumlah keseluruhan. Setiap item membawa url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score dan page_category, bersama total_count dan items_count. filters menerima medan yang disenaraikan oleh get_dataforseo_content_available_filters. Untuk kiraan dan taburan dan bukan halaman, gunakan post_dataforseo_content_summary_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)[]
    • filters
      Jenis: array (object | null)[] | null

      array parameter penapisan hasil
      medan pilihan
      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, match, not_match
      anda boleh menggunakan operator % dengan like dan not_like untuk memadankan sebarang rentetan dengan sifar atau lebih aksara
      contoh:
      ["country","=", "US"]

      [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]

      [["domain_rank",">",800],
      "and",
      [["page_types","has","ecommerce"],
      "or",

      ["content_info.text_category","has",10994]]]
      untuk maklumat lanjut tentang penapis, rujuk API Analisis Kandungan - Penapis

      Objek kosong
    • 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
    • limit
      Jenis: integer | null

      bilangan maksimum sitasi yang dikembalikan
      medan pilihan
      nilai lalai: 100
      nilai maksimum: 1000

    • offset
      Jenis: integer | null

      offset dalam array hasil sitasi yang dipulangkan
      medan pilihan
      nilai lalai: 0
      jika anda menentukan nilai 10, sepuluh sitasi pertama dalam array hasil akan dilangkau dan data akan disediakan untuk sitasi berikutnya
      Nota: kami mengesyorkan menggunakan parameter ini hanya semasa mendapatkan sehingga 10,000 hasil
      untuk mendapatkan lebih daripada 10,000 hasil, gunakan offset_token sebaliknya.

    • offset_token
      Jenis: string | null

      token offset untuk permintaan seterusnya
      medan pilihan
      disediakan dalam medan yang sama pada respons bagi setiap permintaan;
      gunakan parameter ini untuk mengelakkan tamat masa semasa cuba mendapatkan lebih daripada 10,000 hasil dalam satu permintaan;
      dengan menentukan nilai offset_token unik daripada array respons, anda akan mendapat hasil seterusnya bagi tugas awal;
      nilai offset_token adalah unik bagi setiap tugas seterusnya
      Nota: jika offset_token ditentukan dalam permintaan, semua parameter lain kecuali limit tidak akan diambil kira semasa memproses tugas
      ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami

    • order_by
      Jenis: array string[] | null

      peraturan susunan hasil
      medan pilihan
      anda boleh menggunakan nilai yang sama seperti dalam array filters untuk menyusun hasil
      jenis susunan yang mungkin:
      asc - hasil akan disusun dalam susunan menaik
      desc - hasil akan disusun dalam susunan menurun
      anda harus menggunakan koma untuk menyediakan jenis susunan
      contoh:
      ["content_info.sentiment_connotations.anger,desc"]
      peraturan lalai:
      ["content_info.sentiment_connotations.anger,desc"]
      ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan susunan dalam satu permintaan
      anda harus menggunakan koma untuk memisahkan beberapa peraturan susunan
      contoh:
      ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]

    • 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 domain_rank dan url_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 semua sitasi bagi keyword sasaran
      one_per_domain - memulangkan 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_ContentAnalysisSearchLiveResponseInfo
    • 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_ContentAnalysisSearchLiveTaskInfo
        • 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

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

            mengandungi petikan dan data berkaitan

            • content_info
              Jenis: object | null · Response36Afe1097B20_AnalysisContentInfo

              mengandungi data tentang petikan daripada url tertentu

              • author
                Jenis: string | null

                pengarang kandungan

              • connotation_types
                Jenis: object | null

                jenis konotasi
                mengandungi jenis sentimen (polariti sentimen) berkaitan petikan yang diberikan dan indeks kebarangkalian bagi setiap jenis sentimen
                jenis konotasi sentimen yang mungkin: positive, negative, neutral

                • propertyName
                  Jenis: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • content_quality_score
                Jenis: integer | null

                skor kualiti kandungan
                nilai ini dikira berdasarkan bilangan perkataan, ayat dan aksara yang terkandung dalam kandungan

              • content_type
                Jenis: string | null

                jenis kandungan
                contoh:
                page_content, comment

              • date_published
                Jenis: string | null

                tarikh dan masa kandungan diterbitkan
                dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
                contoh:
                2017-01-24 13:20:59 +00:00

              • group_date
                Jenis: string | null

                tarikh dan masa kumpulan petikan
                menunjukkan tarikh penerbitan kandungan atau tarikh dan masa perayap kami melawat halaman buat kali pertama;
                medan ini boleh digunakan untuk mengumpulkan petikan mengikut tarikh dan memaparkan trend petikan;
                tarikh dan masa diberikan dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
                contoh:
                2017-01-24 13:20:59 +00:00

              • highlighted_text
                Jenis: string | null

                teks yang diserlahkan daripada snippet

              • language
                Jenis: string | null

                bahasa utama domain
                untuk mendapatkan senarai penuh bahasa yang tersedia, rujuk endpoint Languages

              • level
                Jenis: integer | null

                tahap tajuk title
                menunjukkan tahap tag h daripada 1 (teratas) hingga 6 (terbawah)

              • main_title
                Jenis: string | null

                tajuk halaman

              • previous_title
                Jenis: string | null

                tajuk blok kandungan sebelumnya

              • rating
                Jenis: object | null · Response36Afe1097B20_ContententRatingInfo

                penilaian kandungan
                penilaian berkaitan content_info

                • max_rating_value
                  Jenis: number | null Format: double

                  nilai maksimum untuk nama penilaian

                • name
                  Jenis: string | null

                  nama penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

                • rating_count
                  Jenis: integer | null Format: int64

                  bilangan undian

                • rating_value
                  Jenis: number | null Format: double

                  nilai penilaian

                • relative_rating
                  Jenis: number | null Format: double

                  penilaian relatif

              • semantic_location
                Jenis: string | null

                lokasi semantik
                menunjukkan elemen semantik dalam HTML tempat petikan kata kunci sasaran berada
                contoh:
                article, header

              • sentiment_connotations
                Jenis: object | null

                konotasi sentimen
                mengandungi sentimen (reaksi emosi) berkaitan petikan yang diberikan dan indeks kebarangkalian bagi setiap sentimen
                konotasi sentimen yang mungkin: anger, happiness, love, sadness, share, fun

                • propertyName
                  Jenis: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • snippet
                Jenis: string | null

                petikan kandungan

              • snippet_length
                Jenis: integer | null

                panjang aksara petikan

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

                metrik penglibatan media sosial
                data tentang interaksi media sosial yang berkaitan dengan kandungan berdasarkan benaman tapak web yang dibangunkan dan disokong oleh platform media sosial

                • like_count
                  Jenis: integer | null Format: int64

                  bilangan suka

                • type
                  Jenis: string | null

                  jenis elemen

              • text_category
                Jenis: array integer[] | null

                kategori teks
                untuk mendapatkan senarai penuh kategori tersedia, rujuk endpoint Categories

              • title
                Jenis: string | null

                tajuk hasil

            • country
              Jenis: string | null

              kod negara pendaftaran domain
              untuk mendapatkan senarai penuh negara yang tersedia, rujuk endpoint Locations

            • domain
              Jenis: string | null

              nama domain

            • domain_rank
              Jenis: integer | null

              kedudukan domain
              nilai ini berdasarkan data backlink bagi domain tertentu daripada DataForSEO Backlink Index;
              domain_rank dikira berdasarkan kaedah pemeringkatan nod dalam pangkalan data bertautan – prinsip yang digunakan dalam algoritma Google PageRank asal
              pelajari lebih lanjut tentang metrik dan cara pengiraannya dalam artikel pusat bantuan ini

            • fetch_time
              Jenis: string | null

              tarikh dan masa perayap kami melawat halaman
              dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              contoh:
              2017-01-24 13:20:59 +00:00

            • language
              Jenis: string | null

              bahasa utama domain
              untuk mendapatkan senarai penuh bahasa yang tersedia, rujuk endpoint Languages

            • main_domain
              Jenis: string | null

              domain utama

            • page_category
              Jenis: array integer[] | null

              mengandungi semua kategori halaman yang berkaitan
              kategori produk dan perkhidmatan yang berkaitan dengan halaman
              untuk mendapatkan senarai penuh kategori yang tersedia, rujuk endpoint Categories

            • page_types
              Jenis: array string[] | null

              jenis halaman

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

              penilaian yang ditemui pada halaman
              semua penilaian yang ditemui pada halaman berdasarkan mikrodat

              • max_rating_value
                Jenis: number | null Format: double

                nilai maksimum untuk nama penilaian

              • name
                Jenis: string | null

                nama penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

              • rating_count
                Jenis: integer | null Format: int64

                bilangan undian

              • rating_value
                Jenis: number | null Format: double

                nilai penilaian

              • relative_rating
                Jenis: number | null Format: double

                penilaian relatif

            • score
              Jenis: number | null

              skor prominens petikan
              nilai ini berdasarkan url_rank, domain_rank, kehadiran keyword dalam title, main_title, url, snippet
              semakin tinggi score, semakin bernilai petikan berkaitan

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

              metrik penglibatan media sosial
              data tentang interaksi media sosial yang berkaitan dengan kandungan berdasarkan benaman tapak web yang dibangunkan dan disokong oleh platform media sosial

              • like_count
                Jenis: integer | null Format: int64

                bilangan suka

              • type
                Jenis: string | null

                jenis elemen

            • spam_score
              Jenis: integer | null

              skor spam backlink bagi url
              nilai ini berdasarkan data backlink bagi URL tertentu daripada DataForSEO Backlink Index;
              pelajari lebih lanjut tentang cara metrik dikira di halaman pusat bantuan ini

            • type
              Jenis: string | null

              jenis elemen

            • url
              Jenis: string | null

              URL tempat petikan ditemui

            • url_rank
              Jenis: integer | null

              kedudukan url
              nilai ini berdasarkan data backlink bagi URL tertentu daripada DataForSEO Backlink Index;
              url_rank dikira berdasarkan kaedah pemeringkatan nod dalam pangkalan data bertautan – prinsip yang digunakan dalam algoritma Google PageRank asal
              pelajari lebih lanjut tentang metrik dan cara pengiraannya dalam artikel pusat bantuan ini

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam array items

          • offset_token
            Jenis: string | null

            token offset untuk permintaan seterusnya
            anda boleh menggunakan rentetan yang disediakan dalam medan ini untuk mendapatkan hasil seterusnya bagi tugas awal;
            nota: nilai offset_token adalah unik bagi setiap tugas seterusnya

          • total_count
            Jenis: integer | null Format: int64

            jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda

        • 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/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Content Analysis – Search API