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

Halaman Berkaitan

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

Halaman Berkaitan

​

Halaman mana bagi laman target yang memperoleh kedudukannya, disusun mengikut trafik yang dibawanya. 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. Gunakan untuk mencari halaman yang wajar dipertahankan atau dikembangkan. Untuk kata kunci di sebaliknya gunakan post_dataforseo_labs_google_kw_for_site_live; untuk halaman yang memperoleh pautan dan bukan kedudukan, gunakan post_dataforseo_backlinks_domain_pages_summary_live.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.015.
  • 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.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]

      [[""metrics.organic.count",">",50"],
      "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 halaman 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 halaman yang dipulangkan
      medan pilihan
      nilai lalai: 0
      jika anda menentukan nilai 10, sepuluh halaman pertama dalam array hasil akan dilangkau dan data akan disediakan untuk halaman seterusnya

    • 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_DataforseoLabsGoogleRelevantPagesLiveResponseInfo
    • 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_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
        • 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

            halaman berkaitan dan data berkaitan

            • metrics
              Jenis: object | null

              metrik kedudukan dan trafik untuk halaman berkaitan

              • 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

            • page_address
              Jenis: string | null

              URL mutlak halaman berkaitan

            • 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
            jika tiada data, nilainya ialah null

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST
            jika tiada data, nilainya ialah null

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

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

Operasi berjaya

Relevant Pages