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

Pesaing SERP

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

Pesaing SERP

​

Domain yang berkongsi kedudukan dengan anda bagi satu set keywords, bersama bilangan kata kunci yang dikongsi. Memulangkan se_type, seed_keywords, total_count, items_count dan items. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Ini pesaing carian, ditentukan oleh kedudukan bersama. Padanan graf pautan ialah post_dataforseo_backlinks_competitors_live, dan kedua-dua senarai sering tidak sependapat - itu sendiri bermaklumat.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.0192.
  • 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, match, not_match, ilike, not_ilike, like, not_like
      anda boleh menggunakan operator % dengan like dan not_like, serta ilike dan not_ilike untuk memadankan sebarang rentetan dengan sifar atau lebih aksara
      contoh:
      ["median_position","in",[1,10]]

      [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]

      [["domain","not_like","%wikipedia.org%"],
      "and",
      [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
      untuk maklumat lanjut tentang penapis, rujuk Dataforseo Labs - Filters atau panduan pusat bantuan

      Objek kosong
    • include_subdomains
      Jenis: boolean | null

      menunjukkan sama ada subdomain akan disertakan dalam carian
      medan pilihan
      jika ditetapkan kepada false, subdomain akan diabaikan
      nilai lalai: true

    • item_types
      Jenis: array string[] | null

      jenis hasil carian
      menunjukkan jenis hasil carian yang disertakan dalam respons
      medan pilihan

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

    • keywords
      Jenis: array string[]

      array kata kunci
      medan wajib
      hasil akan berdasarkan kata kunci yang anda tentukan dalam array ini
      pengekodan UTF-8;
      kata kunci akan ditukar kepada format huruf kecil;
      anda boleh menentukan maksimum 200 kata kunci

      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini

    • language_code
      Jenis: string | null

      pengecam bahasa unik
      medan wajib jika anda tidak menentukan language_name
      Nota: anda mesti menentukan language_name atau language_code
      anda boleh menerima senarai bahasa yang tersedia dengan parameter language_code dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      en

    • language_name
      Jenis: string

      nama penuh bahasa
      medan wajib jika anda tidak menentukan language_code
      Nota: anda mesti menentukan language_name atau language_code
      anda boleh menerima senarai bahasa yang tersedia dengan parameter language_name dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      English

    • limit
      Jenis: integer | null

      bilangan maksimum domain yang dikembalikan
      medan pilihan
      nilai lalai: 100
      nilai maksimum: 1000

    • location_code
      Jenis: integer

      pengecam lokasi unik
      medan wajib jika anda tidak menentukan location_name
      Nota: anda mesti menentukan location_name atau location_code
      anda boleh menerima senarai lokasi yang tersedia dengan parameter location_code dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      2840

    • location_name
      Jenis: string

      nama penuh lokasi
      medan wajib jika anda tidak menentukan location_code
      Nota: anda mesti menentukan location_name atau location_code
      anda boleh menerima senarai lokasi yang tersedia dengan parameter location_name dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      United Kingdom

    • offset
      Jenis: integer | null

      offset dalam array hasil domain yang dipulangkan
      medan pilihan
      nilai lalai: 0
      jika anda menentukan nilai 10, sepuluh domain pertama dalam array hasil akan dilangkau dan data akan disediakan untuk domain 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
      koma digunakan sebagai pemisah
      contoh:
      ["avg_position,asc"]
      peraturan lalai:
      ["rating,desc"]
      ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan susunan dalam satu permintaan
      anda harus menggunakan koma untuk memisahkan beberapa peraturan susunan
      contoh:
      ["avg_position,asc","etv,desc"]

    • 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

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
    • 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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
        • 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 pesaing SERP yang dikesan dan data berkaitan

            • avg_position
              Jenis: number | null Format: float

              kedudukan purata domain bagi kata kunci yang ditentukan
              min aritmetik nilai dalam array keywords_positions

            • domain
              Jenis: string | null

              nama domain pesaing SERP yang dikesan

            • etv
              Jenis: number | null

              anggaran volum trafik
              mewakili anggaran trafik bulanan yang dibawa kata kunci yang ditentukan ke laman web
              dikira sebagai jumlah hasil darab nilai volum carian kata kunci yang ditentukan dan kadar CTR (click-through-rate) pada kedudukan tertentu dalam SERP
              ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

            • keywords_count
              Jenis: integer | null Format: int64

              bilangan kata kunci yang ditentukan yang mempunyai kedudukan dalam SERP bagi domain

            • keywords_positions
              Jenis: object | null

              kedudukan kata kunci
              kedudukan SERP yang dipegang domain berkaitan dalam SERP bagi kata kunci yang ditentukan

              • propertyName
                Jenis: array (integer | null)[] | null
            • median_position
              Jenis: number | null

              kedudukan median domain bagi kata kunci yang ditentukan
              median nilai dalam array keywords_positions

            • rating
              Jenis: number | null

              jurang antara kedudukan kata kunci terbesar yang mungkin dan kedudukan sebenar
              mewakili kadar keterlihatan relatif domain dalam SERP bagi kata kunci yang ditentukan
              dikira sebagai sum(100-keywords_positions)

            • relevant_serp_items
              Jenis: integer | null

              bilangan elemen SERP yang berkaitan dengan domain
              mewakili bilangan hasil carian dalam SERP yang berkaitan dengan domain bagi kata kunci yang ditentukan

            • se_type
              Jenis: string | null

              jenis enjin carian

            • visibility
              Jenis: number | null

              kadar keterlihatan SERP
              mewakili kadar keterlihatan laman web berdasarkan kedudukan SERP kata kunci yang ditentukan
              kata kunci dengan kedudukan dalam julat 1 hingga 10 diberi indeks keterlihatan dari 1 hingga 0.1
              kata kunci dengan kedudukan dalam julat 11 hingga 20 mempunyai indeks keterlihatan tetap 0.05
              kata kunci dengan kedudukan dari 20 hingga 100 mempunyai indeks keterlihatan bersamaan 0

          • 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_nulln

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST
            jika tiada data, nilainya ialah_nulln

          • se_type
            Jenis: string | null

            jenis enjin carian

          • seed_keywords
            Jenis: array (string | null)[] | null

            kata kunci yang ditentukan dalam permintaan
            kata kunci dipulangkan dengan %## yang dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

          • total_count
            Jenis: integer | null Format: int64

            jumlah keseluruhan 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/serp_competitors/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

{
  "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,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

SERP Competitors