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

Geçmiş toplu trafik tahmini

Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Geçmiş toplu trafik tahmini

​

Mevcut geçmişin her noktasında çok sayıda alan adı için tahmini organik trafik — post_dataforseo_labs_google_bulk_traffic_estimation_live arkasındaki zaman serisi. Bu uç nokta limit parametresi almaz, ancak öğe başına değil çağrı başına fiyatlandırılır, bu yüzden tüm listeyi tek seferde gönderin. 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 alan adlarıyla tarihleri çarpar; iki listeyi de kısa tutun. Kullanılabilir tarihler get_dataforseo_labs_google_available_history kaynağından gelir.

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

      zaman aralığının başlangıç tarihi
      isteğe bağlı alan
      bu alanı belirtmezseniz veriler önceki 12 ay için sağlanır
      olası minimum değer: 2020-10-01
      tarih biçimi: "yyyy-mm-dd"

    • date_to
      Tür: string | null

      zaman aralığının bitiş tarihi
      isteğe bağlı alan
      bu alanı belirtmezseniz varsayılan olarak bugünün tarihi kullanılır;
      tarih biçimi: "yyyy-mm-dd"
      örnek:
      "2021-04-01"

    • ignore_synonyms
      Tür: boolean | null

      çok benzer anahtar kelimeleri yoksay
      isteğe bağlı alan
      true olarak ayarlanırsa_ yalnızca temel anahtar kelimeler döndürülür, çok benzeyen tüm anahtar kelimeler hariç tutulur;
      varsayılan değer: falsen

    • item_types
      Tür: array string[] | null

      sonuçları öğe türüne göre göster
      isteğe bağlı alan
      yanıtta yer alan arama sonucu türünü belirtir;
      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;
      olası değerler:
      ["organic", "paid", "featured_snippet", "local_pack"]
      varsayılan değer:
      ["organic", "paid"]

    • language_code
      Tür: string | null

      dil kodu
      bu alanı kullanırsanız language_name belirtmeniz gerekmez
      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
      tüm mevcut diller için sonuçları almak üzere bu alanı yoksayın
      örnek:
      en

    • language_name
      Tür: string | null

      dilin tam adı
      bu alanı kullanırsanız language_code belirtmeniz gerekmez
      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
      tüm mevcut diller için sonuçları almak üzere bu alanı yoksayın
      örnek:
      English

    • location_code
      Tür: integer | null

      konum kodu
      bu alanı kullanırsanız location_name belirtmeniz gerekmez
      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
      tüm mevcut konumlar için sonuçları almak üzere bu alanı yoksayın
      örnek:
      2840

    • location_name
      Tür: string | null

      konumun tam adı
      bu alanı kullanırsanız location_code belirtmeniz gerekmez
      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
      tüm mevcut konumlar için sonuçları almak üzere bu alanı yoksayın
      ö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

    • targets
      Tür: array string[]

      hedef alan adları ve alt alan adları
      zorunlu alan
      bu alanda alan adları ve alt alan adları belirtebilirsiniz;
      alan adları ve alt alan adları https:// ve www. olmadan belirtilmelidir;
      en fazla 1000 alan adı veya alt alan adı ayarlayabilirsiniz

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

            ilgili trafik tahmini verilerini içeren öğe dizisi

            • metrics
              Tür: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo

              belirtilen alan adıyla ilgili trafik verileri

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

                Google SERP'teki öne çıkan snippet sonuçlarından gelen trafik verileri

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

                  alan adını içeren toplam organik SERP sayısı

                • etv
                  Tür: number | null

                  tahmini trafik hacmi
                  alan adına gelen tahmini aylık organik trafik
                  alan adının sıralandığı tüm anahtar kelimelerin CTR (tıklama oranı) ve arama hacmi değerlerinin çarpımı olarak hesaplanır
                  bu metriğin nasıl hesaplandığı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz

                • month
                  Tür: integer | null

                  verilerin sağlandığı ay

                • year
                  Tür: integer | null

                  verilerin sağlandığı yıl

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

                SERP'teki yerel paket sonuçlarından gelen trafik verileri

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

                  alan adını içeren toplam organik SERP sayısı

                • etv
                  Tür: number | null

                  tahmini trafik hacmi
                  alan adına gelen tahmini aylık organik trafik
                  alan adının sıralandığı tüm anahtar kelimelerin CTR (tıklama oranı) ve arama hacmi değerlerinin çarpımı olarak hesaplanır
                  bu metriğin nasıl hesaplandığı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz

                • month
                  Tür: integer | null

                  verilerin sağlandığı ay

                • year
                  Tür: integer | null

                  verilerin sağlandığı yıl

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

                organik aramadan gelen trafik verileri

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

                  alan adını içeren toplam organik SERP sayısı

                • etv
                  Tür: number | null

                  tahmini trafik hacmi
                  alan adına gelen tahmini aylık organik trafik
                  alan adının sıralandığı tüm anahtar kelimelerin CTR (tıklama oranı) ve arama hacmi değerlerinin çarpımı olarak hesaplanır
                  bu metriğin nasıl hesaplandığı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz

                • month
                  Tür: integer | null

                  verilerin sağlandığı ay

                • year
                  Tür: integer | null

                  verilerin sağlandığı yıl

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

                ücretli aramadan gelen trafik verileri

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

                  alan adını içeren toplam organik SERP sayısı

                • etv
                  Tür: number | null

                  tahmini trafik hacmi
                  alan adına gelen tahmini aylık organik trafik
                  alan adının sıralandığı tüm anahtar kelimelerin CTR (tıklama oranı) ve arama hacmi değerlerinin çarpımı olarak hesaplanır
                  bu metriğin nasıl hesaplandığı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz

                • month
                  Tür: integer | null

                  verilerin sağlandığı ay

                • year
                  Tür: integer | null

                  verilerin sağlandığı yıl

            • se_type
              Tür: string | null

              arama motoru türü

            • target
              Tür: string | null

              POST dizisindeki hedef alan adı

          • 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
            veri yoksa değer null olur

          • location_code
            Tür: integer | null

            POST dizisindeki konum kodu
            veri yoksa değer null olur

          • 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
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "dataforseo.com",
      "cnn.com",
      "forbes.com"
    ],
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29",
    "item_types": [
      "organic",
      "paid"
    ]
  }
]'
{
  "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,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "target": null,
              "metrics": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Historical Bulk Traffic Estimation