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

Subdomain

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

Subdomain

​

Subdomain dari sebuah target dan jejak pencarian masing-masing. Dipaginasi dengan limit, offset, dan offset_token; gunakan token setelah halaman pertama. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Berguna ketika lalu lintas sebuah domain terkonsentrasi di tempat selain www - subdomain dokumentasi atau blog yang menopang situs tidak terlihat di post_dataforseo_labs_google_domain_rank_overview_live.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.1356.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan 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
      contoh:
      ["metrics.paid.count",">",0]

      [["metrics.paid.count",">",0],"and",["metrics.paid.etv",">","50"]]

      [["metrics.organic.count",">","10"],
      "and",
      [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
      untuk informasi selengkapnya tentang filter, lihat Dataforseo Labs - Filters atau panduan pusat bantuan

      Objek kosong
    • historical_serp_mode
      Tipe: string | null

      mode pengumpulan data
      field opsional
      Anda dapat menggunakan field ini untuk memfilter hasil;
      jenis pemfilteran yang mungkin:
      live — mengembalikan metrik untuk SERP tempat target yang ditentukan saat ini memiliki hasil pemeringkatan;
      lost — mengembalikan metrik untuk SERP tempat target yang ditentukan sebelumnya memiliki hasil pemeringkatan, tetapi tidak memilikinya selama pemeriksaan terakhir;
      all — mengembalikan metrik untuk kedua jenis SERP.
      nilai default: live

    • ignore_synonyms
      Tipe: boolean | null

      abaikan kata kunci yang sangat mirip
      field opsional
      jika disetel ke true, hanya kata kunci inti yang akan dikembalikan, semua kata kunci yang sangat mirip akan dikecualikan;
      nilai default: false

    • include_clickstream_data
      Tipe: boolean | null

      sertakan atau kecualikan data dari metrik berbasis clickstream dalam hasil
      field opsional
      jika parameter disetel ke true, Anda akan menerima field clickstream_etv, clickstream_gender_distribution, dan clickstream_age_distribution dengan data clickstream dalam respons
      nilai default: false
      dengan parameter ini diaktifkan, Anda akan dikenakan biaya dua kali lipat untuk permintaan

      pelajari lebih lanjut tentang cara metrik berbasis clickstream dihitung dalam artikel pusat bantuan ini

    • item_types
      Tipe: array string[] | null

      tampilkan hasil menurut jenis item
      field opsional
      menunjukkan jenis hasil pencarian yang disertakan dalam respons

      Catatan: jika array item_types berisi jenis item yang berbeda dari organic, hasil akan diurutkan berdasarkan jenis item pertama dalam array; Anda tidak akan dapat mengurutkan dan memfilter hasil berdasarkan jenis hasil pencarian yang tidak disertakan dalam respons;

      nilai yang mungkin:
      ["organic", "paid", "featured_snippet", "local_pack"]
      nilai default:
      ["organic", "paid"]

    • 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 kata kunci yang dikembalikan
      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 kata kunci yang dikembalikan
      field opsional
      nilai default: 0
      jika Anda menentukan nilai 10, sepuluh kata kunci pertama dalam array hasil akan dilewati dan data akan disediakan untuk kata kunci berikutnya

    • 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 menentukan jenis pengurutan
      contoh:
      ["metrics.paid.etv,asc"]
      Catatan: Anda dapat menetapkan tidak lebih dari tiga aturan pengurutan dalam satu permintaan
      Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
      contoh:
      ["metrics.organic.etv,desc","metrics.paid.count,asc"]

      aturan default:
      ["metrics.organic.count,desc"]
      Catatan: jika array item_types berisi jenis item yang berbeda dari organic, hasil akan diurutkan berdasarkan jenis item pertama dalam array

    • 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_DataforseoLabsGoogleSubdomainsLiveResponseInfo
    • 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_DataforseoLabsGoogleSubdomainsLiveTaskInfo
        • 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 subdomain dan data terkait

            • metrics
              Tipe: object | null

              data peringkat yang relevan dengan subdomain

              • 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

            • subdomain
              Tipe: string | null

              subdomain yang dikembalikan

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

{
  "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,
              "subdomain": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Subdomains