v0.2.0-beta

OpenAPI 3.1.0

Canlı App Store uygulama 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/apple/app_competitors/live

Canlı App Store uygulama rakipleri

Belirli bir uygulamayla ortak anahtar kelimeler için rekabet eden App Store uygulamaları. limit, offset ve offset_token ile sayfalanır; ilk sayfalardan sonra token kullanın. 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. Google Play ikizi: post_dataforseo_labs_google_app_competitors_live.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek maliyeti tahmini: USD 0.1356.
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)[]
- app_id
  Tür: string
  
  uygulamanın kimliği
  zorunlu alan
  App Store'daki mobil uygulamanın kimliği;
  kimliği App Store'da listelenen her uygulamanın URL'sinde bulabilirsiniz;
  örnek:
  https://apps.apple.com/us/app/id835599320 URL'sinde
  kimlik 835599320 değeridir
- 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
  desteklenen operatörler:
  <, <=, >, >=, =, <>, in, not_in
  örnek:
  ["intersections",">",500]
  
  [["competitor_metrics.app_store_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.app_store_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  filtreler hakkında daha fazla bilgi için Dataforseo Labs - Filters veya bu Yardım Merkezi kılavuzuna bakın
  
  Boş nesne
- language_code
  Tür: string | null
  
  dil kodu
  language_name belirtmezseniz zorunlu alan
  Not: language_name veya language_code değerlerinden biri belirtilmelidir
  kullanılabilir dillerin listesini language_code ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Not: bu uç nokta şu anda yalnızca İngilizce dilini destekler
  örnek:
  en
- language_name
  Tür: string
  
  dilin tam adı
  language_code belirtmezseniz zorunlu alan
  Not: language_name veya language_code değerlerinden biri belirtilmelidir
  kullanılabilir dillerin listesini language_name ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Not: bu uç nokta şu anda yalnızca İngilizce dilini destekler;
  örnek:
  English
- limit
  Tür: integer | null
  
  döndürülen maksimum uygulama sayısı
  isteğe bağlı alan
  varsayılan değer: 100
  maksimum değer: 1000
- location_code
  Tür: integer
  
  konum kodu
  location_name belirtmezseniz zorunlu alan
  Not: location_name veya location_code değerlerinden biri belirtilmelidir
  kullanılabilir konumların listesini location_code ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Not: bu uç nokta şu anda yalnızca ABD konumunu destekler;
  örnek:
  2840
- location_name
  Tür: string
  
  konumun tam adı
  location_code belirtmezseniz zorunlu alan
  Not: location_name veya location_code değerlerinden biri belirtilmelidir
  kullanılabilir konumların listesini location_name ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Not: bu uç nokta şu anda yalnızca ABD konumunu destekler;
  örnek:
  United States
- offset
  Tür: integer | null
  
  döndürülen uygulamaların sonuç dizisindeki kaydırma değeri
  isteğe bağlı alan
  varsayılan değer: 0
  10 değerini belirtirseniz sonuç dizisindeki ilk on uygulama atlanır ve veriler sonraki anahtar kelimeler 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 dizisindeki 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;
  sıralama türünü ayarlamak için virgül kullanmalısınız;
  örnek:
  ["intersections,asc"]
  Not: tek bir istekte en fazla üç sıralama kuralı ayarlayabilirsiniz;
  birden çok sıralama kuralını virgülle ayırmalısınız;
  örnek:
  ["intersections,desc","sum_position,asc"]
  
  varsayılan kural:
  ["intersections,desc"]
  Not: item_types dizisi organic dışında öğe türleri içeriyorsa sonuçlar dizideki ilk öğe türüne göre sıralanır
- 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_DataforseoLabsAppleAppCompetitorsLiveResponseInfo
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_DataforseoLabsAppleAppCompetitorsLiveTaskInfo
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

app_id
Tür: string | null

POST dizisindeki uygulama id'si

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

app_id ve rakip uygulamalarla ilgili verileri içerir

app_id
Tür: string | null

POST dizisindeki uygulama id'si

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

uygulamanın Google Play SERP'teki ortalama konumu
Not: ortalama konum yalnızca kesişen anahtar kelimeler için hesaplanır;
belirli bir uygulamanın değeri farklı hedef uygulamalarla birleştirildiğinde farklılık gösterebilir

competitor_metrics
Tür: object | null

kesişen anahtar kelimeler için metrikler
sağlanan rakip uygulamanın POST isteğindeki uygulamayla paylaştığı anahtar kelimelere ilişkin sıralama verileri;
not: bu dizide sıralama verileri döndürülen rakibin app_id değeri için sağlanır

propertyName
Tür: object · Response36Afe1097B20_AppMetricsInfo
count
Tür: integer | null Biçim: int64

ürünü içeren Amazon organik SERP'lerinin toplam sayısı

pos_1
Tür: integer | null

ürünün #1 sırada yer aldığı organik SERP sayısı

pos_11_100
Tür: integer | null

ürünün #11-100 aralığında sıralandığı organik SERP sayısı

pos_2_3
Tür: integer | null

ürünün #2-3 aralığında sıralandığı organik SERP sayısı

pos_4_10
Tür: integer | null

ürünün #4-10 aralığında sıralandığı organik SERP sayısı

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

ürünün organik SERP'te sıralandığı anahtar kelimelerin toplam arama hacmi

full_metrics
Tür: object | null

uygulamanın tüm anahtar kelimeleri için metrikler
sağlanan app_id değerinin sıralandığı tüm anahtar kelimelere ilişkin sıralama verilerinin tam genel görünümü

propertyName
Tür: object · Response36Afe1097B20_AppMetricsInfo
count
Tür: integer | null Biçim: int64

ürünü içeren Amazon organik SERP'lerinin toplam sayısı

pos_1
Tür: integer | null

ürünün #1 sırada yer aldığı organik SERP sayısı

pos_11_100
Tür: integer | null

ürünün #11-100 aralığında sıralandığı organik SERP sayısı

pos_2_3
Tür: integer | null

ürünün #2-3 aralığında sıralandığı organik SERP sayısı

pos_4_10
Tür: integer | null

ürünün #4-10 aralığında sıralandığı organik SERP sayısı

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

ürünün organik SERP'te sıralandığı anahtar kelimelerin toplam arama hacmi

intersections
Tür: integer | null

kesişen anahtar kelime sayısı

se_type
Tür: string | null

arama motoru türü

sum_position
Tür: integer | null

uygulamanın Google Play SERP'teki tüm konumlarının toplamı
Not: toplam konum yalnızca kesişen anahtar kelimeler için hesaplanır;
belirli bir uygulamanın değeri farklı hedef uygulamalarla birleştirildiğinde farklılık gösterebilir

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

location_code
Tür: integer | null

POST dizisindeki konum kodu

se_type
Tür: string | null

arama motoru tü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/apple/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "686449807",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

Ş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,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Canlı App Store uygulama rakipleri

Kimlik doğrulamaRequired

DataForSEO

Canlı App Store uygulama rakipleri

Fiyatlandırma referansı