v0.2.0-beta

OpenAPI 3.1.0

‘Bing Keyword Performance’ Sonuçlarını id ile Getirme

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

get/v1/beta/dataforseo/keywords_data/bing/keyword_performance/task_get/{id}

‘Bing Keyword Performance’ Sonuçlarını id ile Getirme

Kuyruğa alınmış bir Bing anahtar kelime performansı görevini id ile getirir. 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. 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. ⚠️ Yanıt boyutu, gönderme anında ayarlanan depth veya limit ile sabitlendi ve burada daraltılamaz; çok büyükse sayfalamak yerine daha küçük bir istek yeniden gönderin.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek tahmini: USD 0.012.
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.

Yol Parametreleri

id
Tür: string
gerekli

görev tanımlayıcısı
sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
görevin sonuçlarını istediğiniz zaman talep etmek için 30 gün boyunca kullanabilirsiniz

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_KeywordsDataBingKeywordPerformanceTaskGetResponseInfo
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_KeywordsDataBingKeywordPerformanceTaskGetTaskInfo
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

keyword
Tür: string | null

POST dizisindeki anahtar sözcük

keyword_kpi
Tür: object | null · Response36Afe1097B20_KeywordKpi

anahtar kelime metriklerini içeren nesne
veri yoksa değer null olur

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

masaüstü cihazlar için toplanan anahtar kelime verileri
veri yoksa değer null olur

ad_position
Tür: string | null

ilgili reklamın SERP'teki konumunu gösterir
şu değerleri alabilir:
FirstPage1: ilk arama sonuçları sayfasının sağ tarafında görünen ilk reklam
FirstPage2: ilk arama sonuçları sayfasının sağ tarafında görünen ikinci reklam
FirstPage3: ilk arama sonuçları sayfasının sağ tarafında görünen üçüncü reklam
FirstPage4: ilk arama sonuçları sayfasının sağ tarafında görünen dördüncü reklam
FirstPage5: ilk arama sonuçları sayfasının sağ tarafında görünen beşinci reklam
FirstPage6: ilk arama sonuçları sayfasının sağ tarafında görünen altıncı reklam
FirstPage7: ilk arama sonuçları sayfasının sağ tarafında görünen yedinci reklam
FirstPage8: ilk arama sonuçları sayfasının sağ tarafında görünen sekizinci reklam
FirstPage9: ilk arama sonuçları sayfasının sağ tarafında görünen dokuzuncu reklam
FirstPage10: ilk arama sonuçları sayfasının sağ tarafında görünen onuncu reklam
MainLine1: arama sonuçları sayfasının üstünde görünen ilk reklam
MainLine2: arama sonuçları sayfasının üstünde görünen ikinci reklam
MainLine3: arama sonuçları sayfasının üstünde görünen üçüncü reklam
MainLine4: arama sonuçları sayfasının üstünde görünen dördüncü reklam

average_bid
Tür: number | null Biçim: double

anahtar kelimenin ortalama teklifi

average_cpc
Tür: number | null Biçim: double

ortalama tıklama başına maliyet, USD
tüm tıklamaların maliyetinin tıklama sayısına bölünmesiyle hesaplanır

clicks
Tür: integer | null

reklam tıklamaları
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu tıklama sayısı

ctr
Tür: number | null Biçim: double

yüzde olarak tıklama oranı
tıklama sayısının gösterim sayısına bölünüp sonucun 100 ile çarpılmasıyla hesaplanır

impressions
Tür: integer | null

reklam gösterimleri
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu gösterim sayısı

total_cost
Tür: number | null Biçim: int64

reklamın toplam maliyeti, USD
belirtilen anahtar kelimenin ve eşleme türünün son ay içinde kullanılmasının maliyeti

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

mobil cihazlar için toplanan anahtar kelime verileri
veri yoksa değer null olur

ad_position
Tür: string | null

ilgili reklamın SERP'teki konumunu gösterir
şu değerleri alabilir:
FirstPage1: ilk arama sonuçları sayfasının sağ tarafında görünen ilk reklam
FirstPage2: ilk arama sonuçları sayfasının sağ tarafında görünen ikinci reklam
FirstPage3: ilk arama sonuçları sayfasının sağ tarafında görünen üçüncü reklam
FirstPage4: ilk arama sonuçları sayfasının sağ tarafında görünen dördüncü reklam
FirstPage5: ilk arama sonuçları sayfasının sağ tarafında görünen beşinci reklam
FirstPage6: ilk arama sonuçları sayfasının sağ tarafında görünen altıncı reklam
FirstPage7: ilk arama sonuçları sayfasının sağ tarafında görünen yedinci reklam
FirstPage8: ilk arama sonuçları sayfasının sağ tarafında görünen sekizinci reklam
FirstPage9: ilk arama sonuçları sayfasının sağ tarafında görünen dokuzuncu reklam
FirstPage10: ilk arama sonuçları sayfasının sağ tarafında görünen onuncu reklam
MainLine1: arama sonuçları sayfasının üstünde görünen ilk reklam
MainLine2: arama sonuçları sayfasının üstünde görünen ikinci reklam
MainLine3: arama sonuçları sayfasının üstünde görünen üçüncü reklam
MainLine4: arama sonuçları sayfasının üstünde görünen dördüncü reklam

average_bid
Tür: number | null Biçim: double

anahtar kelimenin ortalama teklifi

average_cpc
Tür: number | null Biçim: double

ortalama tıklama başına maliyet, USD
tüm tıklamaların maliyetinin tıklama sayısına bölünmesiyle hesaplanır

clicks
Tür: integer | null

reklam tıklamaları
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu tıklama sayısı

ctr
Tür: number | null Biçim: double

yüzde olarak tıklama oranı
tıklama sayısının gösterim sayısına bölünüp sonucun 100 ile çarpılmasıyla hesaplanır

impressions
Tür: integer | null

reklam gösterimleri
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu gösterim sayısı

total_cost
Tür: number | null Biçim: int64

reklamın toplam maliyeti, USD
belirtilen anahtar kelimenin ve eşleme türünün son ay içinde kullanılmasının maliyeti

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

tablet cihazlar için toplanan anahtar kelime verileri
veri yoksa değer null olur

ad_position
Tür: string | null

ilgili reklamın SERP'teki konumunu gösterir
şu değerleri alabilir:
FirstPage1: ilk arama sonuçları sayfasının sağ tarafında görünen ilk reklam
FirstPage2: ilk arama sonuçları sayfasının sağ tarafında görünen ikinci reklam
FirstPage3: ilk arama sonuçları sayfasının sağ tarafında görünen üçüncü reklam
FirstPage4: ilk arama sonuçları sayfasının sağ tarafında görünen dördüncü reklam
FirstPage5: ilk arama sonuçları sayfasının sağ tarafında görünen beşinci reklam
FirstPage6: ilk arama sonuçları sayfasının sağ tarafında görünen altıncı reklam
FirstPage7: ilk arama sonuçları sayfasının sağ tarafında görünen yedinci reklam
FirstPage8: ilk arama sonuçları sayfasının sağ tarafında görünen sekizinci reklam
FirstPage9: ilk arama sonuçları sayfasının sağ tarafında görünen dokuzuncu reklam
FirstPage10: ilk arama sonuçları sayfasının sağ tarafında görünen onuncu reklam
MainLine1: arama sonuçları sayfasının üstünde görünen ilk reklam
MainLine2: arama sonuçları sayfasının üstünde görünen ikinci reklam
MainLine3: arama sonuçları sayfasının üstünde görünen üçüncü reklam
MainLine4: arama sonuçları sayfasının üstünde görünen dördüncü reklam

average_bid
Tür: number | null Biçim: double

anahtar kelimenin ortalama teklifi

average_cpc
Tür: number | null Biçim: double

ortalama tıklama başına maliyet, USD
tüm tıklamaların maliyetinin tıklama sayısına bölünmesiyle hesaplanır

clicks
Tür: integer | null

reklam tıklamaları
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu tıklama sayısı

ctr
Tür: number | null Biçim: double

yüzde olarak tıklama oranı
tıklama sayısının gösterim sayısına bölünüp sonucun 100 ile çarpılmasıyla hesaplanır

impressions
Tür: integer | null

reklam gösterimleri
anahtar kelimenin ve eşleme türünün son ay içinde oluşturduğu gösterim sayısı

total_cost
Tür: number | null Biçim: int64

reklamın toplam maliyeti, USD
belirtilen anahtar kelimenin ve eşleme türünün son ay içinde kullanılmasının maliyeti

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

month
Tür: integer | null

Integer numbers.

year
Tür: integer | null

verilerin sağlandığı yılı belirtir
örnek:
2020

month

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

get/v1/beta/dataforseo/keywords_data/bing/keyword_performance/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Ş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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}

Başarılı işlem

‘Bing Keyword Performance’ Sonuçlarını id ile Getirme

Kimlik doğrulamaRequired

DataForSEO

‘Bing Keyword Performance’ Sonuçlarını id ile Getirme

Fiyatlandırma referansı