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

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

​

Bir keywords listesi için Google Ads arama hacmi. keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc ve monthly_searches ile birlikte Google terimi düzelttiğinde spell 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. Bu klasik arama hacmi sayısıdır; insanların bir asistana ne sıklıkla sorduğunu görmek için post_dataforseo_ai_keyword_volume_live kullanı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
      tarih biçimi: "yyyy-mm-dd"
      minimum değer: geçerli tarihten 4 yıl öncesi
      varsayılan olarak son 12 aya ait veriler döndürülür;
      Not: belirtilen tarih, date_to içinde belirtilen tarihten ve/veya dünün tarihinden ileri olamaz;Status uç noktası actual_data alanında false döndürürse, date_from evvelsi ay ve öncesi olarak ayarlanabilir;
      Status uç noktası actual_data alanında true döndürürse, date_from son ay ve öncesi olarak ayarlanabilir

    • date_to
      Tür: string | null

      zaman aralığının bitiş tarihi
      isteğe bağlı alan
      Not: belirtilen tarih geçen aydan ileri olamaz; Google Ads geçerli aya ait veri döndürmez;
      bu alanı belirtmezseniz varsayılan olarak dünün tarihi kullanılır
      tarih biçimi: "yyyy-mm-dd"
      örnek:
      "2022-11-30"

    • include_adult_keywords
      Tür: boolean | null

      yetişkinlere yönelik içerikle ilişkili anahtar kelimeleri dahil et
      isteğe bağlı alan
      true olarak ayarlanırsa, yanıta yetişkinlere yönelik anahtar kelimeler dahil edilir
      varsayılan değer: false
      not: API, Google Ads kısıtlamaları nedeniyle bu tür anahtar kelimeler için veri döndürmeyebilir

    • keywords
      Tür: array string[]

      keywords
      zorunlu alan
      belirtebileceğiniz maksimum anahtar kelime sayısı: 1000
      her anahtar kelime için maksimum karakter sayısı: 80
      her anahtar kelime ifadesi için maksimum kelime sayısı: 10
      belirttiğiniz anahtar kelimeler küçük harf biçimine dönüştürülür
      Not #1: Google Ads belirli anahtar kelime grupları için veri döndürmeyebilir;
      Not #2: Google Ads benzer anahtar kelime grupları için birleşik arama hacmi değerleri sağlar
      benzer anahtar kelimeler için arama hacmi elde etmek üzere bu tür anahtar kelimeleri ayrı isteklerde göndermenizi öneririz;
      Not #3: Google Ads belirli sembol ve karakterlerin (ör. UTF sembolleri, emoji) kullanılmasına izin vermez, bu nedenle görev ayarlarken bunları kullanamazsınız;
      hangi sembol ve karakterlerin kullanılabileceği hakkında daha fazla bilgi için bu makaleye bakın

      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

      arama motoru dil kodu
      isteğe bağlı alan
      arama motorunun mevcut dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      örnek:
      en

    • language_name
      Tür: string | null

      arama motoru dilinin tam adı
      isteğe bağlı alan
      arama motorunun mevcut dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      örnek:
      English

    • location_code
      Tür: integer | null

      arama motoru konum kodu
      isteğe bağlı alan
      konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez;
      arama motorlarının mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      örnek:
      2840

    • location_coordinate
      Tür: string | null

      bir konumun GPS koordinatları
      isteğe bağlı alan
      konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
      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 | null

      arama motoru konumunun tam adı
      isteğe bağlı alan
      konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
      bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
      arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      örnek:
      London,England,United Kingdom

    • search_partners
      Tür: boolean | null

      Google arama iş ortaklarını dahil et
      isteğe bağlı alan
      true belirtirseniz, sonuçlar Google aramasını barındıran Google ve iş ortağı siteleri genelinde sahip olunan, işletilen ve sendikasyon ağları için iletilir;
      varsayılan değer: false – sonuçlar Google arama siteleri için döndürülür

    • sort_by
      Tür: string | null

      sonuç sıralama parametreleri
      isteğe bağlı alan
      sonuçları relevance, search_volume, competition_index, low_top_of_page_bid veya high_top_of_page_bid değerlerine 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 dizisinde bulacaksınız

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

          • competition
            Tür: string | null

            rekabet
            verilen anahtar kelimeyle ilişkili göreli rekabet miktarını yalnızca ücretli SERP'te gösterir;
            bu değer Google Ads verilerine dayanır ve şu değerleri alabilir: HIGH, MEDIUM, LOW;
            veri yoksa değer null olur;
            metrik hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

          • competition_index
            Tür: integer | null

            rekabet
            verilen anahtar kelimeyle ilişkili göreli rekabet miktarını yalnızca ücretli SERP'te gösterir;
            bu değer Google Ads verilerine dayanır ve 0 ile 100 arasında (dahil) olabilir;
            veri yoksa değer null olur;
            metrik hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

          • cpc
            Tür: number | null

            tıklama başına maliyet
            belirli bir anahtar kelime için gösterilen reklama yapılan her tıklama için ödenen tutarı (USD) belirtir

          • high_top_of_page_bid
            Tür: number | null

            reklamın ilk sayfanın üstünde gösterilmesi için maksimum teklif
            reklamların gösterildiği en düşük tekliflerin yaklaşık %80'inden yüksek olan değeri belirtir (reklamverenler için Google Ads istatistiklerine göre);
            değer, POST isteğinde belirtilen konuma göre farklılık gösterebilir

          • keyword
            Tür: string | null

            anahtar kelime
            anahtar kelime, çözülmüş %## ile döndürülür (artı işareti '+' bir boşluk karakterine çözülür)

          • 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

          • low_top_of_page_bid
            Tür: number | null

            reklamın ilk sayfanın üstünde gösterilmesi için minimum teklif
            reklamların gösterildiği en düşük tekliflerin yaklaşık %20'sinden yüksek olan değeri belirtir (reklamverenler için Google Ads istatistiklerine göre);
            değer, POST isteğinde belirtilen konuma göre farklılık gösterebilir

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

            aylık aramalar
            bu anahtar kelime fikri için belirtilen coğrafi konumlarda hedeflenen (varsayılan olarak 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 google.com'da veya google.com ile ortaklarında (yaklaşık) arama sayısını gösterir;
            veri yoksa değer null olur

          • spell
            Tür: string | null

            anahtar kelimenin doğru yazımı
            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

        • 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/google_ads/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

{
  "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,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Setting Live ‘Google Ads Search Volume’ Tasks