Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Canlı ‘Search Volume’ Görevlerini Oluşturma

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

Canlı ‘Search Volume’ Görevlerini Oluşturma

​

Bir keywords listesi için Bing arama hacmi. keyword, location_code, language_code, search_partners, device, competition, cpc, search_volume, categories ve monthly_searches döndürür — Google eşdeğerinin döndürmediği categories alanına ve competition_index alanının olmamasına dikkat edin. 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 ikizi post_dataforseo_keywords_gads_search_volume_live; hedef kitle yalnızca Google'da değilse ikisini de çalıştırın. Bu uç noktanın gönderme ve getirme ikizleri, beklenemeyecek kadar büyük partiler için aynı işi eşzamansız olarak ve aynı fiyata yapar.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.09.
  • 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)[]
    • date_from
      Tür: string | null

      zaman aralığının başlangıç tarihi
      isteğe bağlı alan
      minimum değer: bugünün tarihinden itibaren 24 ay;
      bu alanı belirtmezseniz veriler son 12 ay için sağlanır;
      minimum değer: bugünün tarihinden iki yıl öncesi;
      Status uç noktası false değerini actual_data alanında döndürürse date_from iki ay öncesine ve daha öncesine ayarlanabilir;
      Status uç noktası true değerini actual_data alanında döndürürse date_from geçen aya ve daha öncesine ayarlanabilir;
      tarih biçimi: "yyyy-mm-dd"
      örnek:
      "2020-01-01"Not: geçen yılın tarihleri için özel bir zaman aralığı kullanmanızı önermiyoruz

    • date_to
      Tür: string | null

      zaman aralığının bitiş tarihi
      isteğe bağlı alan
      bu alanı belirtmezseniz veriler son 12 ay için sağlanır;
      minimum değer: bugünün tarihinden iki yıl öncesi;
      maksimum değer: bugünün tarihinden bir ay sonrası;
      not: geçen yılın tarihleri için özel bir zaman aralığı kullanmanızı önermiyoruz;
      tarih biçimi: "yyyy-mm-dd"
      örnek:
      "2020-03-15"Not: geçen yılın tarihleri için özel bir zaman aralığı kullanmanızı önermiyoruz

    • device
      Tür: string | null

      cihaz türü
      isteğe bağlı alan
      belirli bir cihaz türü için veri almak istiyorsanız bu alanı belirtin;
      olası değerler: all, mobile, desktop, tablet
      varsayılan değer: all

    • keywords
      Tür: array string[]

      anahtar sözcükler
      zorunlu alan
      Belirtebileceğiniz maksimum anahtar sözcük sayısı: 1000
      Her anahtar sözcük için maksimum karakter sayısı: 100
      belirtilen anahtar sözcükler küçük harfe dönüştürülür, veriler ayrı bir dizide sağlanır. DataForSEO API'lerinde keyword ve keywords alanlarının kuralları ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın

    • language_code
      Tür: string

      arama motoru dil kodu
      language_name belirtmezseniz zorunlu alan
      bu alanı kullanırsanız language_name belirtmeniz gerekmez
      desteklenen diller:
      en, fr, de

    • language_name
      Tür: string

      arama motoru dilinin tam adı
      language_code belirtmezseniz zorunlu alan
      bu alanı kullanırsanız language_code belirtmeniz gerekmez
      desteklenen diller:
      English, French, German

    • location_code
      Tür: integer

      arama motoru konum kodu
      location_name veya location_coordinate belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
      kullanılabilir arama motoru konumlarının ve location_code değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/locations adresine ayrı bir istek göndererek alabilirsiniz
      örnek:
      2840

    • location_coordinate
      Tür: string

      bir konumun GPS koordinatları
      location_name veya location_code belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
      location_coordinate parametresi "latitude,longitude" biçiminde belirtilmelidir
      veriler, belirtilen koordinatların ait olduğu ülke için sağlanır
      örnek:
      52.6178549,-155.352142

    • location_name
      Tür: string

      arama motoru konumunun tam adı
      location_code veya location_coordinate belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
      kullanılabilir arama motoru konumlarının ve location_name değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/locations adresine ayrı bir istek göndererek alabilirsiniz
      örnek:
      London,England,United Kingdom

    • search_partners
      Tür: boolean | null

      Bing arama iş ortakları türü
      isteğe bağlı alan
      true belirtirseniz sonuçlar Bing, Yahoo, AOL ve Bing, AOL ile Yahoo aramasını barındıran iş ortağı siteleri genelinde sahip olunan, işletilen ve sendikasyonlu ağlar için sağlanır.
      varsayılan değer: false - sonuçlar Bing, AOL ve Yahoo arama ağları için döndürülür

    • sort_by
      Tür: string | null

      sonuç sıralama parametreleri
      isteğe bağlı alan
      Sonuçları search_volume, cpc, competition veya relevance değerine göre azalan düzende sıralamak için bu parametreleri kullanın
      varsayılan değer: relevance

    • 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_KeywordsDataBingSearchVolumeLiveResponseInfo
    • 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_KeywordsDataBingSearchVolumeLiveTaskInfo
        • 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

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

            ürün ve hizmet kategorileri
            API'miz bu uç nokta için kategori döndürmez: parametre her zaman null olur

          • competition
            Tür: number | null

            rekabet
            verilen anahtar kelimeyle ilişkili göreli rekabet düzeyini yalnızca ücretli SERP'te gösterir. Bu değer Bing Ads verilerine dayanır.
            Olası değerler: 0.1, 0.5,0.90.1 - düşük rekabet,
            0.5 - orta rekabet,
            0.9 - yüksek rekabet;
            veri yoksa değer null olur

          • cpc
            Tür: number | null

            tıklama başına maliyet
            anahtar kelime için geçmişte ödenen ortalama tıklama başına maliyeti (USD) gösterir.
            veri yoksa değer null olur

          • device
            Tür: string | null

            POST dizisindeki cihaz türü
            veri yoksa değer null olur

          • keyword
            Tür: string | null

            POST dizisindeki anahtar sözcük

          • 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

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

            aylık aramalar
            bu anahtar kelime fikri için belirtilen coğrafi konumlarda hedeflenen (son on iki ay için mevcut olan) yaklaşık arama sayısını gösterir
            veri yoksa değer null olur

            • month
              Tür: integer | null

              Ay.

            • search_volume
              Tür: integer | null

              aylık ortalama arama hacmi oranı

            • year
              Tür: integer | null

              Yıl.

          • search_partners
            Tür: boolean | null

            yanıta iş ortağı ağlarından gelen verilerin dahil edilip edilmediğini belirtir

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

            aylık ortalama arama hacmi oranı
            kullanıcının hedeflemesine bağlı olarak verilen anahtar kelime fikrinin bing arama motorundaki (yaklaşık) arama sayısını gösterir;
            arama hacmi en yakın onluğa yuvarlanır;
            veri yoksa değer null olur

        • 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
Request Example for post/v1/beta/dataforseo/keywords_data/bing/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

{
  "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,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Setting Live ‘Search Volume’ Tasks