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

Geçmiş sıralama özeti

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

Geçmiş sıralama özeti

​

Bir alan adının mevcut geçmişin her noktasındaki sıralama özeti. 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. Önce get_dataforseo_labs_google_available_history kontrol edin — var olan tarihleri adlandırır ve bunların dışındaki bir tarih istemek hata yerine boş sonuç döndürür. Güncel anlık görüntü post_dataforseo_labs_google_domain_rank_overview_live.

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

      verileri daha önce edinilen veri kümeleriyle ilişkilendir
      isteğe bağlı alan
      varsayılan değer: true
      bu parametreyi kullanırsanız sistemimiz şimdi edindiğiniz verileri daha önce edinilen veri kümeleriyle ilişkilendirir
      bu parametre veritabanımızdaki değişikliklerden kaynaklanabilecek tutarsızlıkları azaltmayı amaçlar
      correlate değerini her zaman true olarak ayarlamanızı öneririz

    • date_from
      Tür: string | null

      zaman aralığının başlangıç tarihi
      isteğe bağlı alan
      bu alanı belirtmezseniz veriler önceki 6 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 ana anahtar kelimelere dayalı veriler döndürülür, çok benzeyen tüm anahtar kelimelere ait veriler hariç tutulur;
      varsayılan değer: false

    • include_clickstream_data
      Tür: boolean | null

      sonuçta tıklama akışına dayalı metriklerden verileri dahil et veya hariç tut
      isteğe bağlı alan
      parametre true olarak ayarlanırsa yanıtta tıklama akışı verilerini içeren clickstream_etv, clickstream_gender_distribution ve clickstream_age_distribution alanlarını alırsınız;
      varsayılan değer: false;

      Not: geçmiş tıklama akışı verileri 2024/05 (Mayıs 2024) itibarıyla kullanılabilir;
      bu parametre etkinleştirildiğinde istek için iki kat ücret alınır;
      tıklama akışına dayalı metriklerin nasıl hesaplandığı hakkında daha fazla bilgiyi bu Yardım Merkezi makalesinde bulabilirsiniz

    • language_code
      Tür: string | null

      dil kodu
      language_name belirtmezseniz zorunlu alan
      Not: language_name veya language_code değerlerinden biri belirtilmelidir
      kullanılabilir konumların listesini language_code ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      örnek:
      en

    • language_name
      Tür: string

      dilin tam adı
      language_code belirtmezseniz zorunlu alan
      Not: language_name veya language_code değerlerinden biri belirtilmelidir
      kullanılabilir konumların listesini language_name ile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      örnek:
      English

    • location_code
      Tür: integer

      konum kodu
      location_name belirtmezseniz zorunlu alan
      Not: location_name veya location_code değerlerinden biri belirtilmelidir
      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
      örnek:
      2840

    • location_name
      Tür: string

      konumun tam adı
      location_code belirtmezseniz zorunlu alan
      Not: location_name veya location_code değerlerinden biri belirtilmelidir
      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
      ö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

    • target
      Tür: string

      alan adı
      zorunlu alan
      hedef web sitesinin alan adı
      alan adı https:// ve www. olmadan belirtilmelidir

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

            geçmiş sıralama ve trafik verilerini içerir

            • metrics
              Tür: object | null

              belirtilen alan adıyla ilgili sıralama verileri

              • propertyName
                Tür: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Tür: object | null

                  clickstream tabanlı metriklerin yaşa göre dağılımı
                  bu alan için sonuç almak üzere include_clickstream_data parametresi true olarak ayarlanmalıdır
                  metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

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

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Tür: number | null Biçim: double

                  clickstream verilerine dayalı tahmini trafik hacmi
                  alan adının sıralandığı tüm anahtar kelimelerin tıklama oranı ve clickstream arama hacmi değerlerinin çarpımı olarak hesaplanır
                  bu alan için sonuç almak üzere include_clickstream_data parametresi true olarak ayarlanmalıdır
                  metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

                • clickstream_gender_distribution
                  Tür: object | null

                  tahmini clickstream tabanlı metriklerin cinsiyete göre dağılımı
                  bu alan için sonuç almak üzere include_clickstream_data parametresi true olarak ayarlanmalıdır
                  metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

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

                    Signed 64-bit integers (long type).

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

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

                • estimated_paid_traffic_cost
                  Tür: number | null

                  organik arama trafiğini ücretliye dönüştürmenin tahmini maliyeti
                  alan adının veya alt alan adının sıralandığı kategorideki tüm anahtar kelimeler için reklam yürütmenin tahmini aylık maliyetini (USD) temsil eder
                  metrik, organik etv ve ücretli cpc değerlerinin çarpımı olarak hesaplanır ve Google Arama'da PPC reklamcılığı yoluyla tahmini aylık organik trafik hacmini yönlendirmenin maliyetini gösterir
                  metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

                • etv
                  Tür: number | null

                  tahmini trafik hacmi
                  alan adına veya alt alan adına yönelik tahmini organik aylık trafik
                  alan adının veya alt alan adının sıralandığı kategorideki tüm anahtar kelimelerin CTR (tıklama oranı) ve arama hacmi değerlerinin çarpımı olarak hesaplanır
                  metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

                • is_down
                  Tür: integer | null

                  rank düştü
                  belirtilen hedefin kaç sıralama öğesinin düştüğünü gösterir

                • is_lost
                  Tür: integer | null

                  kaybedilen sıralama öğeleri
                  belirtilen hedefin daha önce SERP'lerde gösterilen ancak son kontrolde bulunamayan sıralama öğelerinin sayısını gösterir

                • is_new
                  Tür: integer | null

                  yeni sıralama öğelerinin sayısı
                  belirtilen hedef için kaç yeni sıralama öğesinin bulunduğunu gösterir

                • is_up
                  Tür: integer | null

                  rank yükseldi
                  belirtilen hedefin kaç sıralama öğesinin yükseldiğini gösterir

                • pos_1
                  Tür: integer | null

                  alan adının veya alt alan adının #1 sırada yer aldığı organik SERP sayısı

                • pos_11_20
                  Tür: integer | null

                  alan adının veya alt alan adının #11-20 aralığında sıralandığı organik SERP sayısı

                • pos_2_3
                  Tür: integer | null

                  alan adının veya alt alan adının #2-3 aralığında sıralandığı organik SERP sayısı

                • pos_21_30
                  Tür: integer | null

                  alan adının veya alt alan adının #21-30 aralığında sıralandığı organik SERP sayısı

                • pos_31_40
                  Tür: integer | null

                  alan adının veya alt alan adının #31-40 aralığında sıralandığı organik SERP sayısı

                • pos_4_10
                  Tür: integer | null

                  alan adının veya alt alan adının #4-10 aralığında sıralandığı organik SERP sayısı

                • pos_41_50
                  Tür: integer | null

                  alan adının veya alt alan adının #41-50 aralığında sıralandığı organik SERP sayısı

                • pos_51_60
                  Tür: integer | null

                  alan adının veya alt alan adının #51-60 aralığında sıralandığı organik SERP sayısı

                • pos_61_70
                  Tür: integer | null

                  alan adının veya alt alan adının #61-70 aralığında sıralandığı organik SERP sayısı

                • pos_71_80
                  Tür: integer | null

                  alan adının veya alt alan adının #71-80 aralığında sıralandığı organik SERP sayısı

                • pos_81_90
                  Tür: integer | null

                  alan adının veya alt alan adının #81-90 aralığında sıralandığı organik SERP sayısı

                • pos_91_100
                  Tür: integer | null

                  alan adının veya alt alan adının #91-100 aralığında sıralandığı organik SERP sayısı

            • month
              Tür: integer | null

              verilerin sağlandığı ay

            • se_type
              Tür: string | null

              arama motoru türü

            • year
              Tür: integer | null

              verilerin sağlandığı yıl

          • 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

          • location_code
            Tür: integer | null

            POST dizisindeki konum kodu

          • se_type
            Tür: string | null

            arama motoru türü

          • target
            Tür: string | null

            POST dizisindeki hedef alan adı

          • 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_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Historical Rank Overview