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

OnPage API Özeti

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

DataForSEO

​

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

OnPage API Özeti

​

Bir taramanın durumu ve öne çıkan metrikleri, id ile. crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info ve page_metrics 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. Bir taramanın bittiğini anlamanın yolu da budur — buradaki başka herhangi bir uç noktayı okumadan önce crawl_progress finished olana kadar bunu yoklayın; aksi halde gerçek gibi görünen kısmi sonuçlar okursunuz. 💰 Upstream tarafında ücretsizdir: tamamlanmış bir taramayı sorgulamak hiçbir şeye mal olmaz, yalnızca taramanın kendisi ücretlidir.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.012.
  • 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.

Yol Parametreleri
  • id
    Tür: string
    gerekli

    görev tanımlayıcısı
    zorunlu alan
    bu kimliği Task POST uç noktasının yanıtında alabilirsiniz
    örnek:
    “07131248-1535-0216-1000-17384017ad04”

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

          • crawl_gateway_address
            Tür: string | null

            crawler IP adresi
            crawler'ın mevcut tarama oturumunu başlatmak için kullandığı IP adresini gösterir
            crawler'ımızın kullandığı IP'lerin tam listesini Genel Bakış bölümünde bulabilirsiniz

          • crawl_progress
            Tür: string | null

            tarama oturumunun durumu
            olası değerler: in_progress, finished

          • crawl_status
            Tür: object | null · Response36Afe1097B20_CrawlStatusInfo

            tarama oturumunun ayrıntıları

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

              taranacak maksimum sayfa sayısı bir görev ayarlarken belirttiğiniz max_crawl_pages sınırını gösterir

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

              taranan sayfa sayısı

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

              şu anda tarama kuyruğunda bulunan sayfa sayısı

          • crawl_stop_reason
            Tür: string | null

            taramanın durma nedeni
            tarama sürecinin durma nedeni hakkında bilgiler;
            olası değerler:
            limit_exceeded - max_crawl_pages içinde ayarlanan sınır aşıldı;
            empty_queue - kuyruktaki tüm URL'ler tarandı;
            force_stopped - tarama süreci On Page API Force Stop işlevi kullanılarak durduruldu;
            unexpected_exception - target taranırken dahili bir hata oluştu; daha fazla bilgi için desteğe başvurun

          • domain_info
            Tür: object | null · Response36Afe1097B20_DomainInfo

            alan adı genelinde bilgiler
            hedef alan adı ve tarama süreci hakkında sayfa içi bilgiler

            • canonicalization_status_code
              Tür: integer | null

              kanonikleştirilmiş sayfa tarafından döndürülen durum kodu
              crawler'ımız siteye IP üzerinden erişmeye çalıştığında sunucu davranışının kontrolü;
              çoğu durumda kanonikleştirilmiş sayfaların 301 veya 302 durum koduyla yanıt vermesi önerilir

            • checks
              Tür: object | null

              site kontrolleri
              siteyle ilgili diğer sayfa içi kontroller

              • propertyName
                Tür: boolean | null
            • cms
              Tür: string | null

              içerik yönetim sistemi
              sitede algılanan içerik yönetim sistemi
              generator meta etiketinin içeriği
              veriler, 200 yanıt kodu döndüren ilk rastgele sayfadan alınır
              crawler'ımız cms'yi tanımlayamazsa değer null olur

            • crawl_end
              Tür: string | null

              tarama bitiş zamanı
              taramanın bittiği tarih ve saat
              UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00"
              örnek:
              2019-11-15 12:57:46 +00:00
              Not: yalnızca "crawl_progress" değeri "finished" olduğunda bilgilendiricidir
              "crawl_progress" değeri in_progress ise değer null olur

            • crawl_start
              Tür: string | null

              tarama başlangıç zamanı
              sitenin taramaya gönderildiği tarih ve saat
              UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00"
              örnek:
              2019-11-15 12:57:46 +00:00

            • directory_browsing_status_code
              Tür: integer | null

              dizin tarafından döndürülen durum kodu
              hedef sitedeki dizin sayfası tarafından döndürülen durum kodu
              çoğu durumda dizinlerin 403 veya 401 durum koduyla yanıt vermesi önerilir

            • extended_crawl_status
              Tür: string | null

              tarama durumu ve hataları
              sitenin neden taranmadığını gösterir;
              aşağıdaki değerleri alabilir:
              no_errors — tarama hatası algılanmadı;
              site_unreachable — crawler'ımız siteye ulaşamadı ve bu nedenle durum kodunu alamadı;
              invalid_page_status_code — ilk taranan sayfanın durum kodu >= 400;
              forbidden_meta_tag — ilk taranan sayfa <meta robots="noindex"> etiketi içeriyor;
              forbidden_robots — robots.txt sayfanın taranmasını yasaklıyor;
              forbidden_http_header — sayfanın HTTP başlığı "X-Robots-Tag: noindex" içeriyor ;
              too_many_redirects — ilk taranan sayfada 10'dan fazla yönlendirme var;
              unknown — neden bilinmiyor

            • ip
              Tür: string | null

              alan adının IP adresi

            • main_domain
              Tür: string | null

              kök alan adı adı

            • name
              Tür: string | null

              alan adı

            • page_not_found_status_code
              Tür: integer | null

              var olmayan sayfa tarafından döndürülen durum kodu
              çoğu durumda sunucunun 404 yanıt kodu döndürmesi önerilir

            • server
              Tür: string | null

              sitenin sunucusu
              sitede algılanan sunucu sürümü
              server başlığının içeriği
              bilgiler, yanıt kodu 200 olan ilk sayfadan alınır

            • ssl_info
              Tür: object | null · Response36Afe1097B20_SslInfo

              SSL sertifikası bilgileri
              sitede algılanan Güvenli Yuva Katmanı protokolü hakkında bilgiler

              • certificate_expiration_date
                Tür: string | null

                SSL sertifikası son kullanma tarihi
                SSL sertifikasının sona erdiği tarih ve saat
                UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
                örnek:
                2019-11-15 12:57:46 +00:00

              • certificate_hash
                Tür: string | null

                SSL sertifikası hash değeri
                SSL sertifikasının hash işlevinin sürümü

              • certificate_issuer
                Tür: string | null

                SSL sertifika yetkilisi
                algılanan SSL sertifikasını veren kuruluş

              • certificate_subject
                Tür: string | null

                SSL sertifikası konusu
                ortak anahtarla ilişkili kuruluş

              • certificate_version
                Tür: integer | null

                SSL sertifikası sürümü
                bir SSL sertifikası tarafından kullanılan X.509 sürümünü belirtir

              • valid_certificate
                Tür: boolean | null

                SSL sertifikası geçerliliği
                bir web sitesinde algılanan SSL sertifikasının süresinin dolmadığını, askıya alınmadığını, iptal edilmediğini veya geçersiz olmadığını belirtir

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

              taranan toplam sayfa sayısı
              taranan toplam sayfa sayısı

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

              taranamayan toplam kaynak sayısı
              taranamayan toplam kaynak sayısı;
              kaynağın gerçek içerik türü crawler'ın beklediği içerik türüyle eşleşmediğinde kaynak taranamaz olarak kabul edilir

            • www_redirect_status_code
              Tür: integer | null

              yönlendirme durum kodu
              www'den www olmayana yönlendirme durum kodu
              çoğu durumda yönlendirmenin 301 durum kodu döndürmesi önerilir

          • page_metrics
            Tür: object | null · Response36Afe1097B20_PageMetrics

            sayfaya özgü bilgiler
            hedef web sitesindeki sayfaların metrik bilgileri

            • broken_links
              Tür: integer | null

              bozuk bağlantı sayısı
              hedef web sitesindeki tüm taranan sayfalarda bozuk bağlantı sayısı

            • broken_resources
              Tür: integer | null

              bozuk kaynak sayısı
              bozuk bağlantılara sahip görsellerin ve diğer kaynakların sayısı

            • checks
              Tür: object | null

              sayfaya özgü sayfa içi kontroller

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

                Signed 64-bit integers (long type).

            • duplicate_content
              Tür: integer | null

              yinelenen içeriğe sahip sayfa sayısı

            • duplicate_description
              Tür: integer | null

              yinelenen açıklamalara sahip sayfa sayısı

            • duplicate_title
              Tür: integer | null

              yinelenen başlıklara sahip sayfa sayısı

            • links_external
              Tür: integer | null

              harici bağlantı sayısı
              diğer web sitelerine işaret eden bağlantı sayısı

            • links_internal
              Tür: integer | null

              dahili bağlantı sayısı
              hedef web sitesi içindeki diğer sayfalara işaret eden bağlantı sayısı

            • links_relation_conflict
              Tür: integer | null

              hedef web sitesinde çakışma oluşturabilecek bağlantı sayısı
              örneğin, "links_relation_conflict": 2 ise hedef web sitesi aynı kaynağa en az bir rel="nofollow" öznitelikli dahili bağlantı ve en az bir dofollow bağlantı ile atıfta bulunuyor demektir

            • non_indexable
              Tür: integer | null

              dizinlenemeyen sayfa sayısı
              Google ve diğer arama motorları tarafından robots.txt, HTTP başlıkları veya meta etiket ayarlarıyla dizinlenmesi engellenen sayfa sayısı;
              dizinlenemeyen URL'lerin listesini bu uç nokta ile alabilirsiniz

            • onpage_score
              Tür: number | null

              web sitesinin 100 puanlık ölçekte ne kadar iyi optimize edildiğini gösterir
              bu alan, web sitesinin tespit edilen kritik sayfa içi sorunlar ve uyarılar dikkate alınarak ne kadar iyi optimize edildiğini gösterir;
              100, web sitesinde kritik sayfa içi sorun ve önemli uyarı olmadığı anlamına gelen en yüksek olası puanıdır;
              not: bu değerin taranan sayfa sayısına bağlı olduğunu unutmayın;
              metriğin nasıl hesaplandığı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz

            • redirect_loop
              Tür: integer | null

              başlangıcı ve bitişi aynı URL olan yönlendirme zincirlerinin sayısı
              hedef URL'nin özgün URL'ye geri yönlendirdiği yönlendirme zincirlerinin 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 get/v1/beta/dataforseo/on_page/summary/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}
OnPage API Summary