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

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

​

Mendaftar halaman individual yang menyitasi sebuah kata kunci, bukan totalnya. 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 field yang didaftarkan oleh get_dataforseo_content_available_filters. Untuk jumlah dan distribusi alih-alih halaman, gunakan post_dataforseo_content_summary_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)[]
    • filters
      Tipe: array (object | null)[] | null

      array parameter filter hasil
      field opsional
      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, match, not_match
      Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
      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 informasi selengkapnya tentang filter, lihat API Analisis Konten - Filter

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

      jumlah maksimum sitasi yang dikembalikan
      field opsional
      nilai default: 100
      nilai maksimum: 1000

    • offset
      Tipe: integer | null

      offset dalam array hasil sitasi yang dikembalikan
      field opsional
      nilai default: 0
      jika Anda menentukan nilai 10, sepuluh sitasi pertama dalam array hasil akan dilewati dan data akan disediakan untuk sitasi berikutnya
      Catatan: kami menyarankan menggunakan parameter ini hanya saat mengambil hingga 10.000 hasil
      untuk mengambil lebih dari 10.000 hasil, gunakan offset_token sebagai gantinya.

    • offset_token
      Tipe: string | null

      token offset untuk permintaan berikutnya
      field opsional
      disediakan di field yang sama pada respons untuk setiap permintaan;
      gunakan parameter ini untuk menghindari waktu tunggu saat mencoba memperoleh lebih dari 10.000 hasil dalam satu permintaan;
      dengan menentukan nilai offset_token unik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal;
      nilai offset_token unik untuk setiap tugas berikutnya
      Catatan: jika offset_token ditentukan dalam permintaan, semua parameter lain kecuali limit tidak akan diperhitungkan saat memproses tugas
      pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami

    • order_by
      Tipe: array string[] | null

      aturan pengurutan hasil
      field opsional
      Anda dapat menggunakan nilai yang sama seperti di array filters untuk mengurutkan hasil
      jenis pengurutan yang mungkin:
      asc - hasil akan diurutkan dalam urutan menaik
      desc - hasil akan diurutkan dalam urutan menurun
      Anda harus menggunakan koma untuk menyiapkan jenis pengurutan
      contoh:
      ["content_info.sentiment_connotations.anger,desc"]
      aturan default:
      ["content_info.sentiment_connotations.anger,desc"]
      perhatikan bahwa Anda tidak dapat menetapkan lebih dari tiga aturan pengurutan dalam satu permintaan
      Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
      contoh:
      ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]

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

    • rank_scale
      Tipe: string | null

      menentukan skala yang digunakan untuk menghitung dan menampilkan nilai domain_rank dan url_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

    • 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_ContentAnalysisSearchLiveResponseInfo
    • 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_ContentAnalysisSearchLiveTaskInfo
        • 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

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

            berisi kutipan dan data terkait

            • content_info
              Tipe: object | null · Response36Afe1097B20_AnalysisContentInfo

              berisi data tentang kutipan dari url tertentu

              • author
                Tipe: string | null

                penulis konten

              • connotation_types
                Tipe: object | null

                jenis konotasi
                berisi jenis sentimen (polaritas sentimen) terkait kutipan yang diberikan dan indeks probabilitas untuk setiap jenis sentimen
                jenis konotasi sentimen yang mungkin: positive, negative, neutral

                • propertyName
                  Tipe: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • content_quality_score
                Tipe: integer | null

                skor kualitas konten
                nilai ini dihitung berdasarkan jumlah kata, kalimat, dan karakter yang dikandung konten

              • content_type
                Tipe: string | null

                jenis konten
                contoh:
                page_content, comment

              • date_published
                Tipe: string | null

                tanggal dan waktu konten diterbitkan
                dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
                contoh:
                2017-01-24 13:20:59 +00:00

              • group_date
                Tipe: string | null

                tanggal dan waktu grup kutipan
                menunjukkan tanggal publikasi konten atau tanggal dan waktu perayap kami mengunjungi halaman untuk pertama kali;
                field ini dapat digunakan untuk mengelompokkan kutipan berdasarkan tanggal dan menampilkan tren kutipan;
                tanggal dan waktu disediakan dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
                contoh:
                2017-01-24 13:20:59 +00:00

              • highlighted_text
                Tipe: string | null

                teks yang disorot dari snippet

              • language
                Tipe: string | null

                bahasa utama domain
                untuk mendapatkan daftar lengkap bahasa yang tersedia, lihat endpoint Languages

              • level
                Tipe: integer | null

                tingkat heading title
                menunjukkan tingkat tag h dari 1 (teratas) hingga 6 (terbawah)

              • main_title
                Tipe: string | null

                judul halaman

              • previous_title
                Tipe: string | null

                judul blok konten sebelumnya

              • rating
                Tipe: object | null · Response36Afe1097B20_ContententRatingInfo

                peringkat konten
                peringkat terkait content_info

                • max_rating_value
                  Tipe: number | null Format: double

                  nilai maksimum untuk nama peringkat

                • name
                  Tipe: string | null

                  nama peringkat di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

                • rating_count
                  Tipe: integer | null Format: int64

                  jumlah suara

                • rating_value
                  Tipe: number | null Format: double

                  nilai penilaian

                • relative_rating
                  Tipe: number | null Format: double

                  peringkat relatif

              • semantic_location
                Tipe: string | null

                lokasi semantik
                menunjukkan elemen semantik dalam HTML tempat kutipan kata kunci target berada
                contoh:
                article, header

              • sentiment_connotations
                Tipe: object | null

                konotasi sentimen
                berisi sentimen (reaksi emosional) terkait kutipan yang diberikan dan indeks probabilitas untuk setiap sentimen
                konotasi sentimen yang mungkin: anger, happiness, love, sadness, share, fun

                • propertyName
                  Tipe: integer | null Format: int64

                  Signed 64-bit integers (long type).

              • snippet
                Tipe: string | null

                cuplikan konten

              • snippet_length
                Tipe: integer | null

                panjang karakter cuplikan

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

                metrik keterlibatan media sosial
                data tentang interaksi media sosial yang terkait dengan konten berdasarkan embed situs web yang dikembangkan dan didukung oleh platform media sosial

                • like_count
                  Tipe: integer | null Format: int64

                  jumlah suka

                • type
                  Tipe: string | null

                  jenis elemen

              • text_category
                Tipe: array integer[] | null

                kategori teks
                untuk memperoleh daftar lengkap kategori yang tersedia, lihat endpoint Categories

              • title
                Tipe: string | null

                judul hasil

            • country
              Tipe: string | null

              kode negara pendaftaran domain
              untuk mendapatkan daftar lengkap negara yang tersedia, lihat endpoint Locations

            • domain
              Tipe: string | null

              nama domain

            • domain_rank
              Tipe: integer | null

              peringkat domain
              nilai ini berdasarkan data backlink untuk domain tertentu dari DataForSEO Backlink Index;
              domain_rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan – prinsip yang digunakan dalam algoritma Google PageRank asli
              pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

            • fetch_time
              Tipe: string | null

              tanggal dan waktu saat perayap kami mengunjungi halaman
              dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              contoh:
              2017-01-24 13:20:59 +00:00

            • language
              Tipe: string | null

              bahasa utama domain
              untuk mendapatkan daftar lengkap bahasa yang tersedia, lihat endpoint Languages

            • main_domain
              Tipe: string | null

              domain utama

            • page_category
              Tipe: array integer[] | null

              berisi semua kategori halaman yang relevan
              kategori produk dan layanan yang relevan untuk halaman
              untuk mendapatkan daftar lengkap kategori yang tersedia, lihat endpoint Categories

            • page_types
              Tipe: array string[] | null

              jenis halaman

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

              peringkat yang ditemukan di halaman
              semua peringkat yang ditemukan di halaman berdasarkan microdata

              • max_rating_value
                Tipe: number | null Format: double

                nilai maksimum untuk nama peringkat

              • name
                Tipe: string | null

                nama peringkat di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

              • rating_count
                Tipe: integer | null Format: int64

                jumlah suara

              • rating_value
                Tipe: number | null Format: double

                nilai penilaian

              • relative_rating
                Tipe: number | null Format: double

                peringkat relatif

            • score
              Tipe: number | null

              skor prominensi kutipan
              nilai ini berdasarkan url_rank, domain_rank, keberadaan keyword di title, main_title, url, snippet
              semakin tinggi score, semakin bernilai kutipan terkait

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

              metrik keterlibatan media sosial
              data tentang interaksi media sosial yang terkait dengan konten berdasarkan embed situs web yang dikembangkan dan didukung oleh platform media sosial

              • like_count
                Tipe: integer | null Format: int64

                jumlah suka

              • type
                Tipe: string | null

                jenis elemen

            • spam_score
              Tipe: integer | null

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

            • type
              Tipe: string | null

              jenis elemen

            • url
              Tipe: string | null

              URL tempat kutipan ditemukan

            • url_rank
              Tipe: integer | null

              peringkat url
              nilai ini berdasarkan data backlink untuk URL tertentu dari DataForSEO Backlink Index;
              url_rank dihitung berdasarkan metode pemeringkatan node dalam basis data bertautan – prinsip yang digunakan dalam algoritma Google PageRank asli
              pelajari lebih lanjut tentang metrik dan cara perhitungannya di artikel pusat bantuan ini

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • offset_token
            Tipe: string | null

            token offset untuk permintaan berikutnya
            Anda dapat menggunakan string yang disediakan di field ini untuk mendapatkan hasil berikutnya dari tugas awal;
            catatan: nilai offset_token unik untuk setiap tugas berikutnya

          • total_count
            Tipe: integer | null Format: int64

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

        • 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/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 berhasil

Content Analysis – Search API