v0.2.0-beta

OpenAPI 3.1.0

Pesaing SERP

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

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

Pesaing SERP

Domain yang berperingkat bersama Anda untuk sekumpulan keywords, beserta berapa banyak kata kunci yang mereka bagi. Mengembalikan se_type, seed_keywords, total_count, items_count, dan items. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Ini adalah pesaing pencarian, ditentukan oleh peringkat bersama. Padanan graf tautan adalah post_dataforseo_backlinks_competitors_live, dan kedua daftar sering tidak sepakat - yang itu sendiri informatif.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.0192.
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, match, not_match, ilike, not_ilike, like, not_like
  Anda dapat menggunakan operator % dengan like dan not_like, serta ilike dan not_ilike untuk mencocokkan string apa pun dengan nol atau lebih karakter
  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 informasi selengkapnya tentang filter, lihat Dataforseo Labs - Filters atau panduan pusat bantuan
  
  Objek kosong
- include_subdomains
  Tipe: boolean | null
  
  menunjukkan apakah subdomain akan disertakan dalam pencarian
  field opsional
  jika disetel ke false, subdomain akan diabaikan
  nilai default: true
- item_types
  Tipe: array string[] | null
  
  jenis hasil pencarian
  menunjukkan jenis hasil pencarian yang disertakan dalam respons
  field opsional
  
  nilai yang mungkin:
  ["organic", "paid", "featured_snippet", "local_pack"]
  nilai default:
  ["organic", "paid"]
- keywords
  Tipe: array string[]
  
  array kata kunci
  field wajib
  hasil akan didasarkan pada kata kunci yang Anda tentukan dalam array ini
  pengodean UTF-8;
  kata kunci akan diubah ke format huruf kecil;
  Anda dapat menentukan maksimum 200 kata kunci
  
  pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan
- language_code
  Tipe: string | null
  
  pengenal bahasa unik
  field wajib jika Anda tidak menentukan language_name
  Catatan: Anda harus menentukan language_name atau language_code
  Anda dapat menerima daftar bahasa yang tersedia dengan parameter language_code-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  en
- language_name
  Tipe: string
  
  nama lengkap bahasa
  field wajib jika Anda tidak menentukan language_code
  Catatan: Anda harus menentukan language_name atau language_code
  Anda dapat menerima daftar bahasa yang tersedia dengan parameter language_name-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  English
- limit
  Tipe: integer | null
  
  jumlah maksimum domain yang dikembalikan
  field opsional
  nilai default: 100
  nilai maksimum: 1000
- location_code
  Tipe: integer
  
  pengenal lokasi unik
  field wajib jika Anda tidak menentukan location_name
  Catatan: Anda harus menentukan location_name atau location_code
  Anda dapat menerima daftar lokasi yang tersedia dengan parameter location_code-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  2840
- location_name
  Tipe: string
  
  nama lengkap lokasi
  field wajib jika Anda tidak menentukan location_code
  Catatan: Anda harus menentukan location_name atau location_code
  Anda dapat menerima daftar lokasi yang tersedia dengan parameter location_name-nya dengan membuat permintaan terpisah ke
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  contoh:
  United Kingdom
- offset
  Tipe: integer | null
  
  offset dalam array hasil domain yang dikembalikan
  field opsional
  nilai default: 0
  jika Anda menentukan nilai 10, sepuluh domain pertama dalam array hasil akan dilewati dan data akan disediakan untuk domain 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
  koma digunakan sebagai pemisah
  contoh:
  ["avg_position,asc"]
  aturan default:
  ["rating,desc"]
  perhatikan bahwa Anda tidak dapat menetapkan lebih dari tiga aturan pengurutan dalam satu permintaan
  Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
  contoh:
  ["avg_position,asc","etv,desc"]
- 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

Respons

200
Tipe: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
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 pesaing SERP yang terdeteksi dan data terkait

avg_position
Tipe: number | null Format: float

posisi rata-rata domain untuk kata kunci yang ditentukan
rata-rata aritmetika nilai dalam array keywords_positions

domain
Tipe: string | null

nama domain pesaing SERP yang terdeteksi

etv
Tipe: number | null

volume trafik perkiraan
mewakili perkiraan trafik bulanan yang didorong kata kunci yang ditentukan ke situs web
dihitung sebagai jumlah produk dari nilai volume pencarian kata kunci yang ditentukan dan tingkat CTR (click-through-rate) pada posisi tertentu di SERP
pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

keywords_count
Tipe: integer | null Format: int64

jumlah kata kunci yang ditentukan yang memiliki posisi di SERP untuk domain

keywords_positions
Tipe: object | null

posisi kata kunci
posisi SERP yang dipegang domain terkait di SERP untuk kata kunci yang ditentukan

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

posisi median domain untuk kata kunci yang ditentukan
median nilai dalam array keywords_positions

rating
Tipe: number | null

selisih antara posisi kata kunci terbesar yang mungkin dan posisi aktual
mewakili tingkat visibilitas relatif domain di SERP untuk kata kunci yang ditentukan
dihitung sebagai sum(100-keywords_positions)

relevant_serp_items
Tipe: integer | null

jumlah elemen SERP yang relevan dengan domain
mewakili jumlah hasil pencarian di SERP yang relevan dengan domain untuk kata kunci yang ditentukan

se_type
Tipe: string | null

jenis mesin pencari

visibility
Tipe: number | null

tingkat visibilitas SERP
mewakili tingkat visibilitas situs web berdasarkan posisi SERP kata kunci yang ditentukan
kata kunci dengan posisi dalam rentang 1 hingga 10 diberi indeks visibilitas dari 1 hingga 0,1
kata kunci dengan posisi dalam rentang 11 hingga 20 memiliki indeks visibilitas tetap 0,05
kata kunci dengan posisi dari 20 hingga 100 memiliki indeks visibilitas sama dengan 0

items_count
Tipe: integer | null Format: int64

jumlah hasil yang dikembalikan dalam array items

language_code
Tipe: string | null

kode bahasa dalam array POST
jika tidak ada data, nilainya adalah_nulln

location_code
Tipe: integer | null

kode lokasi dalam array POST
jika tidak ada data, nilainya adalah_nulln

se_type
Tipe: string | null

jenis mesin pencari

seed_keywords
Tipe: array (string | null)[] | null

kata kunci yang ditentukan dalam permintaan
kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)

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

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

Tampilkan 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,
          "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 berhasil

Pesaing SERP

AutentikasiRequired

DataForSEO

Pesaing SERP

Referensi harga