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

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

​

En fazla beş keywords için zaman içindeki ilgi, Google Trends eğrisi. keywords, type, location_code, language_code, datetime, items_count ve items döndürür. type web, news, images, youtube veya shopping seçer; date_from/date_to zaman aralığını belirler. 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. Trends göreli ilgi verir, mutlak hacim değil; sayımlar için post_dataforseo_keywords_gads_search_volume_live kullanın.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.0012.
  • 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 varsayılan olarak önceki yılın geçerli günü ve ayı kullanılır
      web türü için minimum değer: 2004-01-01
      diğer türler için minimum değer: 2008-01-01
      tarih biçimi: "yyyy-mm-dd"
      örnek:
      "2019-01-15"

    • 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:
      "2019-01-15"

    • keywords
      Tür: array string[]

      anahtar sözcükler
      zorunlu alan
      belirtebileceğiniz maksimum anahtar sözcük sayısı: 5

      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

    • location_code
      Tür: integer | null

      arama motoru konum kodu
      isteğe bağlı alan
      bu alanı kullanmazsanız genel sonuçlar alırsınız
      bu alanı kullanırsanız location_name 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/dataforseo_trends/locations
      verilerin, belirtilen location_code değerinin ait olduğu ülke için sağlanacağını unutmayın;
      örnek:
      2840

    • location_name
      Tür: string | null

      arama motoru konumunun tam adı
      isteğe bağlı alan
      bu alanı kullanmazsanız genel sonuçlar alırsınız
      bu alanı kullanırsanız location_code 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/dataforseo_trends/locations
      verilerin, belirtilen location_name değerinin ait olduğu ülke için sağlanacağını unutmayı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

    • time_range
      Tür: string | null

      ön ayarlı zaman aralıkları
      isteğe bağlı alan
      date_from veya date_to parametrelerini belirtirseniz, görev ayarlanırken bu alan yok sayılır
      tüm type parametreleri için olası değerler:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Tür: string | null

      öğe türü

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

          • datetime
            Tür: string | null

            sonucun alındığı tarih ve saat
            UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
            örnek:
            2019-11-15 12:57:46 +00:00

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

            anahtar kelime popülaritesini ve ilgili verileri içerir

            • Tür: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                • Tür: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                  • type
                    Ayırt edici
                    Tür: string | null

                    öğe türü

                  • averages
                    Tür: array (integer | null)[] | null
                  • data
                    Tür: array (object | null)[] | null

                    POST isteğinde belirttiğiniz parametrelerin aynısını içerir

                    • date_from
                      Tür: string | null

                      ilgili zaman aralığının başlangıç tarihi
                      UTC biçiminde: "yyyy-mm-dd"

                    • date_to
                      Tür: string | null

                      ilgili zaman aralığının bitiş tarihi
                      UTC biçiminde: "yyyy-mm-dd"

                    • timestamp
                      Tür: integer | null

                      Unix zaman biçiminde bir zaman noktası

                    • values
                      Tür: array (integer | null)[] | null

                      belirli bir zaman damgasında göreli anahtar kelime popülerlik oranı
                      verilen zaman aralığındaki anahtar kelime popülerlik oranını temsil eder
                      birden fazla anahtar kelime belirtirseniz değerler, belirtilen tüm anahtar kelimeler arasındaki en yüksek değere göre ortalanır
                      100 değeri terimin zirve popülerliğidir. 50 değeri terimin yarısı kadar popüler olduğu anlamına gelir. 0 puanı bu terim için yeterli veri olmadığını gösterir

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

                    POST dizisindeki anahtar kelimeler

                  • position
                    Tür: integer | null

                    öğenin hizalaması
                    şu değerleri alabilir: 1, 2, 3, 4 vb.

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

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

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

            POST dizisindeki anahtar kelimeler

          • 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

          • type
            Tür: string | null

            öğe türü

        • 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/dataforseo_trends/explore/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "iphone 14",
      "samsung s23"
    ],
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "data": "[Max Depth Exceeded]",
              "averages": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Setting Live ‘DataForSEO Trends Explore’ Tasks