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

Alt Alan Adları

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

Alt Alan Adları

​

target alanının alt alan adları ve her birinin arama ayak izi. limit, offset ve offset_token ile sayfalanır; ilk sayfalardan sonra tokenı kullanın. 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. Bir alan adının trafiği www dışında bir yerde yoğunlaşıyorsa kullanışlıdır — siteyi taşıyan bir dokümantasyon veya blog alt alan adı post_dataforseo_labs_google_domain_rank_overview_live içinde görünmez.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek 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)[]
    • filters
      Tür: array (object | null)[] | null

      sonuç filtreleme parametreleri dizisi
      isteğe bağlı alan
      aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre)
      koşullar arasında and, or mantıksal operatörünü ayarlamalısınız
      şu operatörler desteklenir:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in
      örnek:
      ["metrics.paid.count",">",0]

      [["metrics.paid.count",">",0],"and",["metrics.paid.etv",">","50"]]

      [["metrics.organic.count",">","10"],
      "and",
      [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
      filtreler hakkında daha fazla bilgi için Dataforseo Labs - Filters veya bu yardım merkezi kılavuzuna bakın

      Boş nesne
    • historical_serp_mode
      Tür: string | null

      veri toplama modu
      isteğe bağlı alan
      sonuçları filtrelemek için bu alanı kullanabilirsiniz;
      olası filtreleme türleri:
      live — belirtilen target değerinin şu anda sıralama sonuçlarına sahip olduğu SERP'ler için metrikleri döndürür;
      lost — belirtilen target değerinin daha önce sıralama sonuçlarına sahip olduğu ancak son kontrolde bu sonuçlara sahip olmadığı SERP'ler için metrikleri döndürür;
      all — her iki SERP türü için de metrikleri döndürür.
      varsayılan değer: live

    • ignore_synonyms
      Tür: boolean | null

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

    • include_clickstream_data
      Tür: boolean | null

      sonuçta tıklama akışına dayalı metriklerden veri dahil etme veya hariç tutma
      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
      bu parametre etkinleştirildiğinde istek için iki kat ücretlendirilirsiniz

      tıklama akışına dayalı metriklerin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

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

      sonuçları öğe türüne göre görüntüle
      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; yanıtta yer almayan arama sonucu türlerine göre sonuçları sıralayamaz ve filtreleyemezsiniz;

      olası değerler:
      ["organic", "paid", "featured_snippet", "local_pack"]
      varsayılan değer:
      ["organic", "paid"]

    • language_code
      Tür: string | null

      dil kodu
      isteğe bağlı alan
      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ı
      isteğe bağlı alan
      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

    • limit
      Tür: integer | null

      döndürülen maksimum anahtar kelime sayısı
      isteğe bağlı alan
      varsayılan değer: 100
      maksimum değer: 1000

    • location_code
      Tür: integer | null

      konum kodu
      isteğe bağlı alan
      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ı
      isteğe bağlı alan
      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

    • offset
      Tür: integer | null

      döndürülen anahtar kelimelerin sonuç dizisindeki offset
      isteğe bağlı alan
      varsayılan değer: 0
      10 değerini belirtirseniz, sonuç dizisindeki ilk on anahtar kelime atlanır ve veriler sonraki anahtar kelimeler için sağlanır

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

      sonuç sıralama kuralları
      isteğe bağlı alan
      sonuçları sıralamak için filters dizisindekiyle aynı değerleri kullanabilirsiniz
      olası sıralama türleri:
      asc — sonuçlar artan düzende sıralanır
      desc — sonuçlar azalan düzende sıralanır
      sıralama türünü belirtmek için virgül kullanmalısınız
      örnek:
      ["metrics.paid.etv,asc"]
      Not: tek bir istekte en fazla üç sıralama kuralı ayarlayabilirsiniz
      birden çok sıralama kuralını virgülle ayırmalısınız
      örnek:
      ["metrics.organic.etv,desc","metrics.paid.count,asc"]

      varsayılan kural:
      ["metrics.organic.count,desc"]
      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

    • 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_DataforseoLabsGoogleSubdomainsLiveResponseInfo
    • 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_DataforseoLabsGoogleSubdomainsLiveTaskInfo
        • 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

            alt alan adlarını ve ilgili verileri içerir

            • metrics
              Tür: object | null

              alt 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ı

            • se_type
              Tür: string | null

              arama motoru türü

            • subdomain
              Tür: string | null

              döndürülen alt 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

          • 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 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/subdomains/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/subdomains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ]
  }
]'

{
  "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,
              "subdomain": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Subdomains