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

Gambaran Keseluruhan Kedudukan Domain

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

Gambaran Keseluruhan Kedudukan Domain

​

Jejak carian sesuatu domain: kiraan kata kunci organik dan berbayar, anggaran trafik dan nilai trafik, mengikut location_code. Memulangkan se_type, target, total_count, items_count dan items. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Untuk nombor yang sama dari semasa ke semasa, gunakan post_dataforseo_labs_google_historical_rank_live; untuk banyak domain sekali gus, post_dataforseo_labs_google_bulk_traffic_estimation_live.

Rujukan harga

  • Pemeteran: kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0,0121.
  • 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)[]
    • ignore_synonyms
      Jenis: boolean | null

      abaikan kata kunci yang sangat serupa
      medan pilihan
      jika ditetapkan kepada true, semua kata kunci yang sangat serupa akan dikecualikan daripada pengiraan kedudukan dan trafik, hasil akan berdasarkan data untuk kata kunci utama daripada kumpulan sinonim
      nilai lalai: false

    • 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 hasil yang dipulangkan untuk domain
      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 tatasusunan hasil item yang dipulangkan
      medan pilihan
      nilai lalai: 0
      jika anda menetapkan nilai 10, sepuluh items pertama dalam tatasusunan hasil akan dilangkau dan data akan disediakan untuk item seterusnya

    • 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_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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 data kedudukan dan trafik

            • language_code
              Jenis: string | null

              kod bahasa dalam array POST

            • location_code
              Jenis: integer | null

              kod lokasi dalam array POST

            • metrics
              Jenis: object | null

              data kedudukan yang berkaitan dengan domain yang ditentukan

              • 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

          • 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 sasaran 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
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 berjaya

Domain Rank Overview