v0.2.0-beta

OpenAPI 3.1.0

Subdomain

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

post/v1/beta/dataforseo/dataforseo_labs/google/subdomains/live

Subdomain

Subdomain bagi sesuatu target dan jejak carian setiap satunya. Dipaparkan mengikut halaman dengan limit, offset dan offset_token; gunakan token selepas halaman pertama. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Berguna apabila trafik domain tertumpu di tempat lain selain www - subdomain dokumen atau blog yang menampung laman tidak kelihatan dalam post_dataforseo_labs_google_domain_rank_overview_live.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.1356.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan 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
  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 maklumat lanjut tentang penapis, rujuk Dataforseo Labs - Filters atau panduan pusat bantuan
  
  Objek kosong
- historical_serp_mode
  Jenis: string | null
  
  mod pengumpulan data
  medan pilihan
  anda boleh menggunakan medan ini untuk menapis hasil;
  jenis penapisan yang tersedia:
  live — pulangkan metrik untuk SERP yang target yang ditentukan sedang mempunyai hasil kedudukan;
  lost — pulangkan metrik untuk SERP yang target yang ditentukan pernah mempunyai hasil kedudukan tetapi tidak mempunyainya semasa semakan terakhir;
  all — pulangkan metrik untuk kedua-dua jenis SERP.
  nilai lalai: live
- ignore_synonyms
  Jenis: boolean | null
  
  abaikan kata kunci yang sangat serupa
  medan pilihan
  jika ditetapkan kepada true, hanya kata kunci teras yang akan dipulangkan, semua kata kunci yang sangat serupa akan dikecualikan;
  nilai lalai: false
- include_clickstream_data
  Jenis: boolean | null
  
  sertakan atau kecualikan data daripada metrik berasaskan clickstream dalam hasil
  medan pilihan
  jika parameter ditetapkan kepada true, anda akan menerima medan clickstream_etv, clickstream_gender_distribution dan clickstream_age_distribution dengan data clickstream dalam respons
  nilai lalai: false
  dengan parameter ini didayakan, anda akan dikenakan caj dua kali ganda untuk permintaan
  
  ketahui lebih lanjut tentang cara metrik berasaskan clickstream dikira dalam artikel pusat bantuan ini
- item_types
  Jenis: array string[] | null
  
  paparkan hasil mengikut jenis item
  medan pilihan
  menunjukkan jenis hasil carian yang disertakan dalam respons
  
  Nota: jika array item_types mengandungi jenis item yang berbeza daripada organic, hasil akan disusun mengikut jenis item pertama dalam array; anda tidak akan dapat menyusun dan menapis hasil mengikut jenis hasil carian yang tidak disertakan dalam respons;
  
  nilai yang mungkin:
  ["organic", "paid", "featured_snippet", "local_pack"]
  nilai lalai:
  ["organic", "paid"]
- language_code
  Jenis: string | null
  
  kod bahasa
  medan pilihan
  jika anda menggunakan medan ini, anda tidak perlu menentukan language_name
  anda boleh mendapatkan senarai bahasa tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  abaikan medan ini untuk mendapatkan hasil bagi semua bahasa tersedia
  contoh:
  en
- language_name
  Jenis: string | null
  
  nama penuh bahasa
  medan pilihan
  jika anda menggunakan medan ini, anda tidak perlu menentukan language_code
  anda boleh mendapatkan senarai bahasa tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  abaikan medan ini untuk mendapatkan hasil bagi semua bahasa tersedia
  contoh:
  English
- limit
  Jenis: integer | null
  
  bilangan maksimum kata kunci yang dipulangkan
  medan pilihan
  nilai lalai: 100
  nilai maksimum: 1000
- location_code
  Jenis: integer | null
  
  kod lokasi
  medan pilihan
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_name
  anda boleh mendapatkan senarai lokasi tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  abaikan medan ini untuk mendapatkan hasil bagi semua lokasi tersedia
  contoh:
  2840
- location_name
  Jenis: string | null
  
  nama penuh lokasi
  medan pilihan
  jika anda menggunakan medan ini, anda tidak perlu menentukan location_code
  anda boleh mendapatkan senarai lokasi tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  abaikan medan ini untuk mendapatkan hasil bagi semua lokasi tersedia
  contoh:
  United Kingdom
- offset
  Jenis: integer | null
  
  offset dalam array hasil kata kunci yang dipulangkan
  medan pilihan
  nilai lalai: 0
  jika anda menentukan nilai 10, sepuluh kata kunci pertama dalam array hasil akan dilangkau dan data akan disediakan untuk kata kunci berikutnya
- 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 menentukan jenis susunan
  contoh:
  ["metrics.paid.etv,asc"]
  Nota: anda boleh menetapkan tidak lebih daripada tiga peraturan susunan dalam satu permintaan
  anda harus menggunakan koma untuk memisahkan beberapa peraturan susunan
  contoh:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  peraturan lalai:
  ["metrics.organic.count,desc"]
  Nota: jika array item_types mengandungi jenis item yang berbeza daripada organic, hasil akan disusun mengikut jenis item pertama dalam array
- 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
- target
  Jenis: string
  
  domain
  medan wajib
  nama domain laman web sasaran
  domain harus ditentukan tanpa https:// dan www.

Respons

200
Jenis: object | null · Response36Afe1097B20_DataforseoLabsGoogleSubdomainsLiveResponseInfo
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_DataforseoLabsGoogleSubdomainsLiveTaskInfo
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 subdomain dan data berkaitan

metrics
Jenis: object | null

data kedudukan yang berkaitan dengan subdomain

propertyName
Jenis: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
Jenis: object | null

taburan metrik berasaskan clickstream mengikut umur
untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

propertyName
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

clickstream_etv
Jenis: number | null Format: double

anggaran volum trafik berdasarkan data clickstream
dikira sebagai hasil darab click-through-rate dan nilai volum carian clickstream semua kata kunci yang diduduki domain
untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

clickstream_gender_distribution
Jenis: object | null

taburan anggaran metrik berasaskan clickstream mengikut jantina
untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

propertyName
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

count
Jenis: integer | null Format: int64

jumlah keseluruhan SERP organik yang mengandungi domain atau subdomain

estimated_paid_traffic_cost
Jenis: number | null

anggaran kos menukar trafik carian organik kepada berbayar
mewakili anggaran kos bulanan (USD) untuk menjalankan iklan bagi semua kata kunci dalam kategori yang diduduki domain atau subdomain
metrik dikira sebagai hasil darab nilai etv organik dan cpc berbayar dan menunjukkan kos memacu anggaran volum trafik organik bulanan melalui pengiklanan PPC dalam Google Search
ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

etv
Jenis: number | null

anggaran volum trafik
anggaran trafik organik bulanan ke domain atau subdomain
dikira sebagai hasil darab CTR (click-through-rate) dan nilai volum carian semua kata kunci dalam kategori yang diduduki domain atau subdomain
ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

is_down
Jenis: integer | null

kedudukan menurun
menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah menurun

is_lost
Jenis: integer | null

elemen berkedudukan yang hilang
menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan sebelum ini muncul dalam SERP, tetapi tidak ditemui semasa semakan terakhir

is_new
Jenis: integer | null

bilangan elemen berkedudukan baharu
menunjukkan berapa banyak elemen berkedudukan baharu ditemui bagi sasaran yang dinyatakan

is_up
Jenis: integer | null

kedudukan meningkat
menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah meningkat

pos_1
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #1

pos_11_20
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #11-20

pos_2_3
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #2-3

pos_21_30
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #21-30

pos_31_40
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #31-40

pos_4_10
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #4-10

pos_41_50
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #41-50

pos_51_60
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #51-60

pos_61_70
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #61-70

pos_71_80
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #71-80

pos_81_90
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #81-90

pos_91_100
Jenis: integer | null

bilangan SERP organik tempat domain atau subdomain menduduki #91-100

se_type
Jenis: string | null

jenis enjin carian

subdomain
Jenis: string | null

subdomain yang dipulangkan

items_count
Jenis: integer | null Format: int64

bilangan hasil yang dipulangkan dalam array items

language_code
Jenis: string | null

kod bahasa dalam array POST

location_code
Jenis: integer | null

kod lokasi dalam array POST

se_type
Jenis: string | null

jenis enjin carian

target
Jenis: string | null

domain dalam array POST

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

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
      ]
    ]
  }
]'

Tunjukkan Skema

{
  "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 berjaya

Subdomain

PengesahanRequired

DataForSEO

Subdomain

Rujukan harga