v0.2.0-beta

OpenAPI 3.1.0

SERP Rakipleri

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

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

SERP Rakipleri

Bir keywords kümesi için sizinle birlikte sıralanan alan adları ve kaç tanesini paylaştıkları. se_type, seed_keywords, total_count, items_count ve items döndürür. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. ⚠️ Bunlar arama rakipleridir, paylaşılan sıralamalarla belirlenir. Bağlantı grafiğindeki eşdeğeri post_dataforseo_backlinks_competitors_live ve iki liste sık sık çelişir — bu da kendi başına bilgi vericidir.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.0192.
Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde

application/json

Tür: array (object | null)[]
- filters
  Tür: array (object | null)[] | null
  
  sonuç filtreleme parametreleri dizisi
  isteğe bağlı alan
  aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre)
  koşullar arasında and, or mantıksal operatörünü ayarlamalısınız
  şu operatörler desteklenir:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  % operatörünü like ve not_like ile, ayrıca ilike ve not_ilike ile kullanarak sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşebilirsiniz
  örnek:
  ["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]]]]
  filtreler hakkında daha fazla bilgi için Dataforseo Labs - Filters veya bu yardım merkezi kılavuzuna bakın
  
  Boş nesne
- include_subdomains
  Tür: boolean | null
  
  alt alan adlarının aramaya dahil edilip edilmeyeceğini belirtir
  isteğe bağlı alan
  false olarak ayarlanırsa alt alan adları yoksayılır
  varsayılan değer: true
- item_types
  Tür: array string[] | null
  
  arama sonucu türü
  yanıtta yer alan arama sonucu türünü belirtir
  isteğe bağlı alan
  
  olası değerler:
  ["organic", "paid", "featured_snippet", "local_pack"]
  varsayılan değer:
  ["organic", "paid"]
- keywords
  Tür: array string[]
  
  anahtar kelimeler dizisi
  zorunlu alan
  sonuçlar, bu dizide belirttiğiniz anahtar kelimelere dayanır
  UTF-8 kodlaması;
  anahtar kelimeler küçük harf biçimine dönüştürülür;
  en fazla 200 anahtar kelime belirtebilirsiniz
  
  DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın
- language_code
  Tür: string | null
  
  benzersiz dil tanımlayıcısı
  belirtmezseniz zorunlu alan language_name
  Not: language_name veya language_code değerlerinden birini belirtmeniz gerekir
  mevcut dillerin listesini language_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  örnek:
  en
- language_name
  Tür: string
  
  dilin tam adı
  belirtmezseniz zorunlu alan language_code
  Not: language_name veya language_code değerlerinden birini belirtmeniz gerekir
  mevcut dillerin listesini language_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  örnek:
  English
- limit
  Tür: integer | null
  
  döndürülen maksimum alan adı sayısı
  isteğe bağlı alan
  varsayılan değer: 100
  maksimum değer: 1000
- location_code
  Tür: integer
  
  benzersiz konum tanımlayıcısı
  belirtmezseniz zorunlu alan location_name
  Not: location_name veya location_code değerlerinden birini belirtmeniz gerekir
  mevcut konumların listesini location_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  örnek:
  2840
- location_name
  Tür: string
  
  konumun tam adı
  belirtmezseniz zorunlu alan location_code
  Not: location_name veya location_code değerlerinden birini belirtmeniz gerekir
  mevcut konumların listesini location_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  örnek:
  United Kingdom
- offset
  Tür: integer | null
  
  döndürülen alan adlarının sonuç dizisindeki offset
  isteğe bağlı alan
  varsayılan değer: 0
  10 değerini belirtirseniz sonuç dizisindeki ilk on alan adı atlanır ve veriler sonraki alan adları için sağlanır
- order_by
  Tür: array string[] | null
  
  sonuç sıralama kuralları
  isteğe bağlı alan
  sonuçları sıralamak için filters dizisindekiyle aynı değerleri kullanabilirsiniz
  olası sıralama türleri:
  asc — sonuçlar artan düzende sıralanır
  desc — sonuçlar azalan düzende sıralanır
  ayırıcı olarak virgül kullanılır
  örnek:
  ["avg_position,asc"]
  varsayılan kural:
  ["rating,desc"]
  tek bir istekte en fazla üç sıralama kuralı ayarlayabileceğinizi unutmayın
  birden çok sıralama kuralını virgülle ayırmalısınız
  örnek:
  ["avg_position,asc","etv,desc"]
- tag
  Tür: string | null
  
  kullanıcı tanımlı görev tanımlayıcısı
  isteğe bağlı alan
  karakter sınırı 255
  bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
  belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: array (object | null)[] | null

sonuç dizisi

items
Tür: array (object | null)[] | null

algılanan SERP rakiplerini ve ilgili verileri içerir

avg_position
Tür: number | null Biçim: float

alan adının belirtilen anahtar kelimeler için ortalama konumu
keywords_positions dizisindeki değerlerin aritmetik ortalaması

domain
Tür: string | null

algılanan SERP rakibinin alan adı

etv
Tür: number | null

tahmini trafik hacmi
belirtilen anahtar kelimelerin web sitesine yönlendirdiği tahmini aylık trafiği temsil eder
belirtilen anahtar kelimelerin arama hacmi değerleri ile SERP'teki belirli konumlardaki CTR (tıklama oranı) değerlerinin çarpımlarının toplamı olarak hesaplanır
metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

keywords_count
Tür: integer | null Biçim: int64

alan adının SERP'lerde konum sahibi olduğu belirtilen anahtar kelime sayısı

keywords_positions
Tür: object | null

anahtar kelime konumları
ilgili alan adının belirtilen anahtar kelimeler için SERP'te sahip olduğu konumlar

propertyName
Tür: array (integer | null)[] | null
median_position
Tür: number | null

alan adının belirtilen anahtar kelimeler için medyan konumu
keywords_positions dizisindeki değerlerin medyanı

rating
Tür: number | null

mümkün olan en yüksek ile gerçek anahtar kelime konumları arasındaki fark
alan adının belirtilen anahtar kelimeler için SERP'teki göreli görünürlük oranını temsil eder
sum(100-keywords_positions) olarak hesaplanır

relevant_serp_items
Tür: integer | null

alan adıyla ilgili SERP öğelerinin sayısı
belirtilen anahtar kelimeler için alan adıyla ilgili SERP'teki arama sonuçlarının sayısını temsil eder

se_type
Tür: string | null

arama motoru türü

visibility
Tür: number | null

SERP görünürlük oranı
belirtilen anahtar kelimelerin SERP konumlarına dayalı web sitesi görünürlük oranını temsil eder
1 ile 10 aralığındaki konumlara sahip anahtar kelimelere sırasıyla 1 ile 0,1 arasında görünürlük endeksi atanır
11 ile 20 aralığındaki konumlara sahip anahtar kelimeler 0,05 sabit görünürlük endeksine sahiptir
20 ile 100 arasındaki konumlara sahip anahtar kelimelerin görünürlük endeksi 0'dır

items_count
Tür: integer | null Biçim: int64

items dizisinde döndürülen sonuç sayısı

language_code
Tür: string | null

POST dizisindeki dil kodu
veri yoksa değer null olur

location_code
Tür: integer | null

POST dizisindeki konum kodu
veri yoksa değer null olur

se_type
Tür: string | null

arama motoru türü

seed_keywords
Tür: array (string | null)[] | null

istekte belirtilen anahtar kelimeler
anahtar kelime %## kodları çözülmüş olarak döndürülür ('+' karakteri boşluk karakteri olarak çözülür)

total_count
Tür: integer | null Biçim: int64

veritabanımızda isteğinizle ilgili toplam sonuç sayısı

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

API'nin geçerli sürümü
application/json
400

İstek işlenemedi. İstek parametrelerini kontrol edin.
401

Geçerli bir Felo API anahtarı gerekir.
402

Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
403

Hesabın bu işlemi gerçekleştirme izni yok.
429

İstek veya harcama sınırına ulaşıldı.
502

Hizmet isteği tamamlayamadı.
503

API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
504

İstek işlenirken hizmet zaman aşımına uğradı.
default

Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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

Şemayı göster

{
  "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
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

SERP Rakipleri

Kimlik doğrulamaRequired

DataForSEO

SERP Rakipleri

Fiyatlandırma referansı