v0.2.0-beta

OpenAPI 3.1.0

Sumber Daya 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

post/v1/beta/dataforseo/on_page/resources

Sumber Daya OnPage API

Aset non-halaman yang ditemukan crawl - gambar, skrip, stylesheet - beserta kode status dan ukurannya. Dipaginasi dengan search_after_token. Membaca crawl yang sudah selesai, jadi memerlukan id dari post_dataforseo_on_page_submit dan mengembalikan crawl_progress plus crawl_status berisi max_crawl_pages, pages_in_queue, dan pages_crawled - periksa nilai tersebut sebelum memercayai hasil yang sedikit, karena crawl yang masih berjalan memang punya lebih sedikit hal untuk dilaporkan. Untuk aset yang sama sekali tidak dapat dijangkau perayap, gunakan post_dataforseo_on_page_uncrawlable_resources. 💰 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.

Isi

application/json

Tipe: array (object | null)[]
- filters
  Tipe: array (object | null)[] | null
  
  array parameter filter hasil
  field opsional
  Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
  Anda harus menetapkan operator logika and, or di antara kondisi
  operator berikut didukung:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
  contoh:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  Daftar lengkap filter yang mungkin tersedia di tautan ini.
  
  Objek kosong
- id
  Tipe: string
  
  ID tugas
  field wajib
  Anda dapat memperoleh ID ini di respons endpoint Task POST
  contoh:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Tipe: integer | null
  
  jumlah maksimum sumber daya yang dikembalikan
  field opsional
  nilai default: 100
  nilai maksimum: 1000
- offset
  Tipe: integer | null
  
  offset dalam array hasil sumber daya yang dikembalikan
  field opsional
  nilai default: 0
  nilai maksimum: 2000000
  jika Anda menentukan nilai 10, sepuluh sumber daya pertama dalam array hasil akan dilewati dan data akan diberikan untuk sumber daya berikutnya
- order_by
  Tipe: array string[] | null
  
  aturan pengurutan hasil
  field opsional
  Anda dapat menggunakan nilai yang sama seperti di array filters untuk mengurutkan hasil
  jenis pengurutan yang mungkin:
  asc - hasil akan diurutkan dalam urutan menaik
  desc - hasil akan diurutkan dalam urutan menurun
  Anda harus menggunakan koma untuk menyiapkan jenis pengurutan
  contoh:
  ["size,desc"]
  perhatikan bahwa Anda tidak dapat menetapkan lebih dari tiga aturan pengurutan dalam satu permintaan
  Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
  contoh:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Tipe: array string[] | null
  
  filter sumber daya berdasarkan halaman yang relevan
  field opsional
  Anda dapat menggunakan field ini untuk memperoleh sumber daya dari halaman yang cocok dengan parameter yang ditentukan
  Anda dapat menerapkan filter yang sama seperti yang tersedia untuk endpoint pages
  Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
  Anda harus menetapkan operator logika and, or di antara kondisi
  operator berikut didukung:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
  contoh:
  ["checks.no_image_title","=",true]
- search_after_token
  Tipe: string | null
  
  token untuk permintaan berikutnya
  field opsional
  disediakan di field yang identik pada respons setiap permintaan;
  gunakan parameter ini untuk menghindari timeout saat mencoba memperoleh lebih dari 20,000 hasil dalam satu permintaan;
  dengan menentukan nilai search_after_token unik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal;
  nilai search_after_token unik untuk setiap tugas berikutnya;
  Catatan: jika search_after_token ditentukan dalam permintaan, semua parameter lain harus identik dengan permintaan sebelumnya
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  field opsional
  batas karakter adalah 255
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons
- url
  Tipe: string | null
  
  URL halaman
  field opsional
  tentukan field ini jika Anda ingin mendapatkan sumber daya untuk halaman tertentu
  perhatikan bahwa untuk memperoleh meta sumber daya dari URL tertentu, Anda harus menentukan URL di field ini;
  jika Anda tidak menentukan url saat menetapkan tugas, meta sumber daya dalam hasil akan dikembalikan berdasarkan data dari halaman tempat perayap kami pertama kali melihat sumber daya tersebut

Respons

200
Tipe: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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_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

current_offset
Tipe: integer | null

Integer numbers.

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

array items

cache_control
Tipe: object | null · Response36Afe1097B20_CacheControl

instruksi untuk caching

cachable
Tipe: boolean | null

menunjukkan apakah halaman dapat di-cache

ttl
Tipe: integer | null

time to live; jumlah waktu browser menyimpan sumber daya dalam cache

checks
Tipe: object | null

pemeriksaan situs web; pemeriksaan on-page terkait halaman

propertyName
Tipe: boolean | null
content_encoding
Tipe: string | null

jenis pengodean

encoded_size
Tipe: integer | null

ukuran halaman setelah pengodean; menunjukkan ukuran halaman yang dikodekan, diukur dalam byte

fetch_time
Tipe: string | null

tanggal dan waktu sumber daya diambil; dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”; contoh: 2019-11-15 12:57:46 +00:00

last_modified
Tipe: object | null · Response36Afe1097B20_LastModified

berisi data tentang perubahan terkait sumber daya; jika tidak ada data, nilainya akan null

header
Tipe: string | null

tanggal dan waktu terakhir header diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" misalnya: 2019-11-15 12:57:46 +00:00 jika tidak ada data, nilainya akan null

meta_tag
Tipe: string | null

tanggal dan waktu terakhir tag meta diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" misalnya: 2019-11-15 12:57:46 +00:00 jika tidak ada data, nilainya akan null

sitemap
Tipe: string | null

tanggal dan waktu terakhir sitemap diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" misalnya: 2019-11-15 12:57:46 +00:00 jika tidak ada data, nilainya akan null

location
Tipe: string | null

header Location; menunjukkan URL untuk mengalihkan halaman

media_type
Tipe: string | null

jenis media yang digunakan untuk menampilkan halaman

resource_errors
Tipe: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

error dan peringatan sumber daya

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

kesalahan sumber daya

column
Tipe: integer | null

kolom tempat kesalahan ditemukan

line
Tipe: integer | null

baris tempat kesalahan ditemukan

message
Tipe: string | null

pesan teks kesalahan. Daftar lengkap kemungkinan kesalahan HTML dapat ditemukan di sini

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini; Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi terkait pengecualian atau error

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

peringatan sumber daya

column
Tipe: integer | null

kolom tempat kesalahan ditemukan

line
Tipe: integer | null

baris tempat kesalahan ditemukan

message
Tipe: string | null

pesan teks kesalahan. Daftar lengkap kemungkinan kesalahan HTML dapat ditemukan di sini

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini; Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi terkait pengecualian atau error

resource_type
Tipe: string | null

jenis elemen

server
Tipe: string | null

versi server

size
Tipe: integer | null

ukuran sumber daya; menunjukkan ukuran halaman tertentu, diukur dalam byte

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini; Catatan: kami sangat menyarankan merancang sistem yang diperlukan untuk menangani kondisi terkait pengecualian atau error

total_transfer_size
Tipe: integer | null Format: int64

ukuran halaman terkompresi; menunjukkan ukuran terkompresi halaman tertentu

url
Tipe: string | null

URL halaman

items_count
Tipe: integer | null Format: int64

jumlah item dalam array hasil

search_after_token
Tipe: string | null
total_items_count
Tipe: integer | null Format: int64

total item relevan yang di-crawl

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

post/v1/beta/dataforseo/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Sumber Daya OnPage API

AutentikasiRequired

DataForSEO

Sumber Daya OnPage API

Referensi harga