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

Ikhtisar Peringkat Domain

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

Ikhtisar Peringkat Domain

​

Jejak pencarian sebuah domain: jumlah kata kunci organik dan berbayar, perkiraan trafik dan nilai trafik, menurut location_code. Mengembalikan se_type, target, total_count, items_count, dan items. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Untuk angka yang sama dari waktu ke waktu, gunakan post_dataforseo_labs_google_historical_rank_live; untuk banyak domain sekaligus, post_dataforseo_labs_google_bulk_traffic_estimation_live.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,0121.
  • 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)[]
    • ignore_synonyms
      Tipe: boolean | null

      abaikan kata kunci yang sangat mirip
      field opsional
      jika disetel ke true, semua kata kunci yang sangat mirip akan dikecualikan dari perhitungan peringkat dan lalu lintas, hasil akan didasarkan pada data kata kunci utama dari kelompok sinonim
      nilai default: false

    • language_code
      Tipe: string | null

      kode bahasa
      field opsional
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      abaikan field ini untuk mendapatkan hasil untuk semua bahasa yang tersedia
      contoh:
      en

    • language_name
      Tipe: string | null

      nama lengkap bahasa
      field opsional
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      abaikan field ini untuk mendapatkan hasil untuk semua bahasa yang tersedia
      contoh:
      English

    • limit
      Tipe: integer | null

      jumlah maksimum hasil yang dikembalikan untuk domain
      field opsional
      nilai default: 100
      nilai maksimum: 1000

    • location_code
      Tipe: integer | null

      kode lokasi
      field opsional
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      abaikan field ini untuk mendapatkan hasil untuk semua lokasi yang tersedia
      contoh:
      2840

    • location_name
      Tipe: string | null

      nama lengkap lokasi
      field opsional
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      abaikan field ini untuk mendapatkan hasil untuk semua lokasi yang tersedia
      contoh:
      United Kingdom

    • offset
      Tipe: integer | null

      offset dalam array hasil item yang dikembalikan
      field opsional
      nilai default: 0
      jika Anda menentukan nilai 10, sepuluh items pertama dalam array hasil akan dilewati dan data akan disediakan untuk item berikutnya

    • 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

    • target
      Tipe: string

      domain
      field wajib
      nama domain situs web target
      domain harus ditentukan tanpa https:// dan www.

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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 data peringkat dan trafik

            • language_code
              Tipe: string | null

              kode bahasa dalam array POST

            • location_code
              Tipe: integer | null

              kode lokasi dalam array POST

            • metrics
              Tipe: object | null

              data peringkat yang relevan dengan domain yang ditentukan

              • propertyName
                Tipe: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Tipe: object | null

                  distribusi metrik berbasis clickstream menurut usia
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                  • propertyName
                    Tipe: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Tipe: number | null Format: double

                  volume trafik perkiraan berdasarkan data clickstream
                  dihitung sebagai produk dari click-through-rate dan nilai volume pencarian clickstream dari semua kata kunci yang diperingkatkan domain
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • clickstream_gender_distribution
                  Tipe: object | null

                  distribusi metrik berbasis clickstream perkiraan menurut gender
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                  • propertyName
                    Tipe: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • count
                  Tipe: integer | null Format: int64

                  jumlah total SERP organik yang berisi domain atau subdomain

                • estimated_paid_traffic_cost
                  Tipe: number | null

                  perkiraan biaya mengubah trafik pencarian organik menjadi berbayar
                  mewakili perkiraan biaya bulanan (USD) untuk menjalankan iklan bagi semua kata kunci dalam kategori yang diperingkatkan domain atau subdomain
                  metrik dihitung sebagai produk dari nilai etv organik dan cpc berbayar dan menunjukkan biaya mendorong volume trafik organik bulanan perkiraan melalui iklan PPC di Google Search
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • etv
                  Tipe: number | null

                  volume trafik perkiraan
                  perkiraan trafik organik bulanan ke domain atau subdomain
                  dihitung sebagai produk dari CTR (click-through-rate) dan nilai volume pencarian semua kata kunci dalam kategori yang diperingkatkan domain atau subdomain
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • is_down
                  Tipe: integer | null

                  peringkat turun
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang turun

                • is_lost
                  Tipe: integer | null

                  elemen berperingkat yang hilang
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang sebelumnya muncul di SERP, tetapi tidak ditemukan selama pemeriksaan terakhir

                • is_new
                  Tipe: integer | null

                  jumlah elemen berperingkat baru
                  menunjukkan berapa banyak elemen berperingkat baru yang ditemukan untuk target yang ditentukan

                • is_up
                  Tipe: integer | null

                  peringkat naik
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang naik

                • pos_1
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #1

                • pos_11_20
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #11-20

                • pos_2_3
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #2-3

                • pos_21_30
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #21-30

                • pos_31_40
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #31-40

                • pos_4_10
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #4-10

                • pos_41_50
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #41-50

                • pos_51_60
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #51-60

                • pos_61_70
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #61-70

                • pos_71_80
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #71-80

                • pos_81_90
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #81-90

                • pos_91_100
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #91-100

            • se_type
              Tipe: string | null

              jenis mesin pencari

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • se_type
            Tipe: string | null

            jenis mesin pencari

          • target
            Tipe: string | null

            domain target dalam array POST

          • 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/dataforseo_labs/google/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Domain Rank Overview