v0.2.0-beta

OpenAPI 3.1.0

Ringkasan OnPage API

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

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

DataForSEO Operasi

get/v1/beta/dataforseo/on_page/summary/{id}

Ringkasan OnPage API

Status dan metrik utama satu crawl, berdasarkan id. Mengembalikan crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info, dan page_metrics. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini juga cara mengetahui crawl telah selesai - lakukan polling hingga crawl_progress bernilai finished sebelum membaca endpoint lain di sini, atau anda akan membaca hasil parsial yang tampak seperti hasil sungguhan. 💰 Gratis di sisi upstream: menanyakan crawl yang sudah selesai tidak dikenakan biaya, hanya crawl itu sendiri.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.012.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Jalur

id
Tipe: string
wajib

pengenal tugas
field wajib
Anda dapat memperoleh ID ini di respons endpoint Task POST
contoh:
“07131248-1535-0216-1000-17384017ad04”

Respons

200
Tipe: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array (object | null)[] | null

array tugas

Tipe: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

path
Tipe: array (string | null)[] | null

Jalur URL

result
Tipe: array (object | null)[] | null

array hasil

crawl_gateway_address
Tipe: string | null

alamat IP perayap
menampilkan alamat IP yang digunakan perayap untuk memulai sesi crawl saat ini
Anda dapat menemukan daftar lengkap IP yang digunakan perayap kami di bagian Ikhtisar

crawl_progress
Tipe: string | null

status sesi crawl
nilai yang mungkin: in_progress, finished

crawl_status
Tipe: object | null · Response36Afe1097B20_CrawlStatusInfo

detail sesi crawl

max_crawl_pages
Tipe: integer | null Format: int64

jumlah halaman maksimum untuk dirayapi menunjukkan batas max_crawl_pages yang Anda tentukan saat membuat tugas

pages_crawled
Tipe: integer | null Format: int64

jumlah halaman yang dirayapi

pages_in_queue
Tipe: integer | null Format: int64

jumlah halaman yang saat ini berada dalam antrean perayapan

crawl_stop_reason
Tipe: string | null

alasan perayapan berhenti
informasi tentang alasan proses crawl berhenti;
nilai yang mungkin:
limit_exceeded - batas yang ditetapkan di max_crawl_pages terlampaui;
empty_queue - semua URL dalam antrean telah di-crawl;
force_stopped - proses crawl dihentikan menggunakan fungsi On Page API Force Stop;
unexpected_exception - kesalahan internal terjadi saat crawl target, hubungi dukungan untuk info selengkapnya

domain_info
Tipe: object | null · Response36Afe1097B20_DomainInfo

info seluruh domain
informasi on-page tentang domain target dan proses crawl

canonicalization_status_code
Tipe: integer | null

kode status yang dikembalikan halaman terkanonisasi
pemeriksaan perilaku server saat perayap kami mencoba mengakses situs web melalui IP;
dalam sebagian besar kasus, halaman terkanonisasi disarankan merespons dengan kode status 301 atau 302

checks
Tipe: object | null

pemeriksaan situs web
pemeriksaan on-page lain yang terkait dengan situs web

propertyName
Tipe: boolean | null
cms
Tipe: string | null

sistem manajemen konten
sistem manajemen konten yang diidentifikasi di situs web
konten tag meta generator
data diambil dari halaman acak pertama yang mengembalikan kode respons 200
jika perayap kami tidak dapat mengidentifikasi cms, nilainya adalah null

crawl_end
Tipe: string | null

waktu perayapan berakhir
tanggal dan waktu saat perayapan selesai
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00
Catatan: hanya informatif jika "crawl_progress" adalah "finished"
jika "crawl_progress" adalah in_progress, nilainya akan menjadi null

crawl_start
Tipe: string | null

waktu perayapan dimulai
tanggal dan waktu saat situs web dikirim untuk dirayapi
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

directory_browsing_status_code
Tipe: integer | null

kode status yang dikembalikan direktori
kode status yang dikembalikan halaman direktori di situs web target
dalam sebagian besar kasus, direktori disarankan merespons dengan kode status 403 atau 401

extended_crawl_status
Tipe: string | null

status dan kesalahan perayapan
menunjukkan alasan situs web tidak dirayapi;
dapat bernilai berikut:
no_errors - tidak ada kesalahan perayapan yang terdeteksi;
site_unreachable - perayap kami tidak dapat menjangkau situs web sehingga tidak dapat memperoleh kode status;
invalid_page_status_code - kode status halaman pertama yang dirayapi >= 400;
forbidden_meta_tag - halaman pertama yang dirayapi berisi tag <meta robots="noindex">;
forbidden_robots - robots.txt melarang perayapan halaman;
forbidden_http_header - header HTTP halaman berisi "X-Robots-Tag: noindex" ;
too_many_redirects - halaman pertama yang dirayapi memiliki lebih dari 10 pengalihan;
unknown - alasannya tidak diketahui

ip
Tipe: string | null

alamat ip domain

main_domain
Tipe: string | null

nama domain akar

name
Tipe: string | null

nama domain

page_not_found_status_code
Tipe: integer | null

kode status yang dikembalikan halaman yang tidak ada
dalam sebagian besar kasus, server disarankan mengembalikan kode respons 404

server
Tipe: string | null

server situs web
versi server yang terdeteksi di situs web
konten header server
informasi diambil dari halaman pertama yang kode responsnya 200

ssl_info
Tipe: object | null · Response36Afe1097B20_SslInfo

info sertifikat ssl
informasi tentang protokol Secure Sockets Layer yang terdeteksi di situs web

certificate_expiration_date
Tipe: string | null

tanggal kedaluwarsa sertifikat ssl
tanggal dan waktu saat sertifikat ssl kedaluwarsa
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

certificate_hash
Tipe: string | null

hash sertifikat ssl
versi fungsi hash sertifikat ssl

certificate_issuer
Tipe: string | null

otoritas sertifikat ssl
entitas yang menerbitkan sertifikat ssl yang terdeteksi

certificate_subject
Tipe: string | null

subjek sertifikat ssl
entitas yang terkait dengan kunci publik

certificate_version
Tipe: integer | null

versi sertifikat ssl
menunjukkan versi X.509 yang digunakan oleh sertifikat ssl

valid_certificate
Tipe: boolean | null

validitas sertifikat ssl
menunjukkan apakah sertifikat ssl yang terdeteksi di situs web valid, yaitu tidak kedaluwarsa, ditangguhkan, dicabut, atau tidak valid

total_pages
Tipe: integer | null Format: int64

total halaman yang dirayapi
jumlah total halaman yang dirayapi

total_uncrawlable_resources
Tipe: integer | null Format: int64

total sumber daya yang tidak dapat dirayapi
jumlah total sumber daya yang tidak dapat dirayapi;
sumber daya dianggap tidak dapat dirayapi ketika tipe konten aktual sumber daya tidak cocok dengan tipe konten yang diharapkan perayap

www_redirect_status_code
Tipe: integer | null

kode status pengalihan
kode status pengalihan www ke non-www
dalam sebagian besar kasus, pengalihan disarankan mengembalikan kode status 301

page_metrics
Tipe: object | null · Response36Afe1097B20_PageMetrics

info khusus halaman
informasi metrik tentang halaman situs web target

broken_links
Tipe: integer | null

jumlah tautan rusak
jumlah tautan rusak di semua halaman yang di-crawl di situs web target

broken_resources
Tipe: integer | null

jumlah sumber daya rusak
jumlah gambar dan sumber daya lain dengan tautan rusak

checks
Tipe: object | null

pemeriksaan on-page khusus halaman

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

duplicate_content
Tipe: integer | null

jumlah halaman dengan konten duplikat

duplicate_description
Tipe: integer | null

jumlah halaman dengan deskripsi duplikat

duplicate_title
Tipe: integer | null

jumlah halaman dengan judul duplikat

links_external
Tipe: integer | null

jumlah tautan eksternal
jumlah tautan yang mengarah ke situs web lain

links_internal
Tipe: integer | null

jumlah tautan internal
jumlah tautan yang mengarah ke halaman lain di dalam situs web target

links_relation_conflict
Tipe: integer | null

jumlah tautan di situs web target yang mungkin berkonflik
sebagai contoh, jika "links_relation_conflict": 2, situs web target merujuk sumber yang sama dengan setidaknya satu tautan internal yang memiliki atribut rel="nofollow" dan setidaknya satu tautan dofollow

non_indexable
Tipe: integer | null

jumlah halaman yang tidak dapat diindeks
jumlah halaman yang diblokir dari pengindeksan oleh Google dan mesin pencari lain melalui robots.txt, header HTTP, atau pengaturan tag meta;
Anda dapat menerima daftar URL yang tidak dapat diindeks menggunakan endpoint ini

onpage_score
Tipe: number | null

menunjukkan seberapa optimal situs web pada skala 100
field ini menunjukkan seberapa optimal situs web dengan mempertimbangkan masalah on-page kritis dan peringatan yang terdeteksi;
100 adalah skor tertinggi yang mungkin, yang berarti situs web tidak memiliki masalah on-page kritis dan peringatan penting;
perhatikan bahwa nilai ini bergantung pada jumlah halaman yang di-crawl;
pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

redirect_loop
Tipe: integer | null

jumlah rantai pengalihan yang dimulai dan berakhir di URL yang sama
jumlah rantai pengalihan di mana URL tujuan mengalihkan kembali ke URL asli

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

application/json

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'

Tampilkan Skema

{
  "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
          }
        }
      ]
    }
  ]
}

Operasi berhasil

Ringkasan OnPage API

AutentikasiRequired

DataForSEO

Ringkasan OnPage API

Referensi harga