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

Canlı ‘DataForSEO 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ı ‘DataForSEO Search Volume’ Görevlerini Oluşturma

​

Reklam platformlarından değil, tıklama akışı panellerinden türetilen arama hacmi; bir keywords listesi için. use_clickstream karışımı değiştirir. location_code, language_code, use_clickstream, 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. Tıklama akışı hacmi post_dataforseo_keywords_gads_search_volume_live ile sık sık çelişir ve asıl mesele de bu: biri reklamverenlere gösterileni, diğeri insanların ne yaptığını ölçer.

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)[]
    • keywords
      Tür: array string[]

      hedef anahtar sözcükler
      zorunlu alan
      UTF-8 kodlaması
      bu dizide belirtebileceğiniz maksimum anahtar sözcük sayısı: 1000
      anahtar sözcükler küçük harf biçimine dönüştürülür

      Not: bazı semboller ve karakterler (ör. UTF sembolleri, emojiler) kullanılamaz
      hangi sembollerin ve karakterlerin kullanılabileceği hakkında bilgi için bu makaleye bakın

      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
      kullanılabilir dillerin ve language_code değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages adresine ayrı bir istek göndererek alabilirsiniz
      örnek:
      en

    • language_name
      Tür: string

      arama motoru dilinin tam adı
      language_code belirtmezseniz zorunlu alan
      kullanılabilir dillerin ve language_name değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages adresine ayrı bir istek göndererek alabilirsiniz
      örnek:
      English

    • location_code
      Tür: integer

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

    • location_name
      Tür: string

      arama motoru konumunun tam adı
      location_code belirtmezseniz zorunlu alan
      kullanılabilir konumların ve location_name değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages adresine ayrı bir istek göndererek alabilirsiniz
      örnek:
      United Kingdom

    • 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

    • use_clickstream
      Tür: boolean | null

      sonuçları sağlamak için clickstream verilerini kullan
      isteğe bağlı alan
      true olarak ayarlanırsa clickstream verilerine dayalı DataForSEO arama hacmi değerlerini alırsınız;
      false olarak ayarlanırsa DataForSEO arama hacmini hesaplamak için Bing arama hacmi verileri kullanılır;
      varsayılan değer: true;
      Not: Bing arama hacmi, Bing Search Volume History Locations ve Bing Ads Locations uç noktalarında sağlanan konumlar için kullanılabilir; diğer tüm konumlar için arama hacmi değerleri, bu parametreyi false olarak ayarlasanız bile clickstream verilerine göre hesaplanır

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo
    • 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_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo
        • 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

            anahtar kelimeler dizisi
            anahtar kelimeleri ve arama hacmi oranlarını içerir

            • keyword
              Tür: string | null

              POST dizisinde sağlanan anahtar kelime

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

              aylık arama hacmi oranları
              bir yılın belirli bir ayındaki arama hacmi oranlarını içeren nesne dizisi

              • 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_volume
              Tür: integer | null Biçim: int64

              bir anahtar kelimenin güncel arama hacmi oranı

          • items_count
            Tür: integer | null

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

          • language_code
            Tür: string | null

            POST dizisindeki dil kodu

            Not: POST dizisindeki anahtar kelime yanlış yazılmış görünüyorsa veriler doğru yazılmış anahtar kelime için döndürülür;
            anahtar kelimelerin yazımını kontrol etmek ve doğrulamak için Google Ads API işlevini kullanırız, bu bağlantıdan daha fazla bilgi edinebilirsiniz

          • location_code
            Tür: integer | null

            POST dizisindeki konum kodu
            veri yoksa değer null olur

          • use_clickstream
            Tür: boolean | null

            use_clickstream parametresinin etkin olup olmadığını belirtir
            olası değerler: true, false

        • 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/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Setting Live ‘DataForSEO Search Volume’ Tasks