v0.2.0-beta

OpenAPI 3.1.0

Sumber OnPage API

Felo API Support

MIT

Pelayan

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 OnPage API

Aset bukan halaman yang ditemui oleh crawl - imej, skrip, helaian gaya - berserta kod status dan saiznya. Dipaparkan mengikut halaman dengan search_after_token. Membaca crawl yang telah selesai, jadi ia memerlukan id daripada post_dataforseo_on_page_submit dan memulangkan crawl_progress serta crawl_status yang mengandungi max_crawl_pages, pages_in_queue dan pages_crawled - semak nilai tersebut sebelum mempercayai hasil yang kecil, kerana crawl yang masih berjalan sememangnya mempunyai lebih sedikit perkara untuk dilaporkan. Untuk aset yang langsung tidak dapat dicapai oleh perangkak, gunakan post_dataforseo_on_page_uncrawlable_resources. 💰 Percuma di pihak upstream: membuat pertanyaan pada crawl yang telah selesai tidak dikenakan kos, hanya crawl itu sendiri.

Rujukan harga

Pemeteran: Kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0.012.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

application/json

Jenis: array (object | null)[]
- filters
  Jenis: array (object | null)[] | null
  
  array parameter penapisan hasil
  medan pilihan
  anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
  anda harus menetapkan operator logik and, or antara syarat
  operator berikut disokong:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  anda boleh menggunakan operator % dengan like dan not_like untuk memadankan sebarang rentetan dengan sifar atau lebih aksara
  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]]]
  
  Senarai penuh penapis yang mungkin tersedia di pautan ini.
  
  Objek kosong
- id
  Jenis: string
  
  ID tugas
  medan wajib
  anda boleh mendapatkan ID ini dalam respons endpoint Task POST
  contoh:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Jenis: integer | null
  
  bilangan maksimum sumber yang dipulangkan
  medan pilihan
  nilai lalai: 100
  nilai maksimum: 1000
- offset
  Jenis: integer | null
  
  offset dalam array hasil sumber yang dipulangkan
  medan pilihan
  nilai lalai: 0
  nilai maksimum: 2000000
  jika anda menentukan nilai 10, sepuluh sumber pertama dalam array hasil akan dilangkau dan data akan diberikan untuk sumber seterusnya
- order_by
  Jenis: array string[] | null
  
  peraturan susunan hasil
  medan pilihan
  anda boleh menggunakan nilai yang sama seperti dalam array filters untuk menyusun hasil
  jenis susunan yang mungkin:
  asc - hasil akan disusun dalam susunan menaik
  desc - hasil akan disusun dalam susunan menurun
  anda harus menggunakan koma untuk menyediakan jenis susunan
  contoh:
  ["size,desc"]
  ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan susunan dalam satu permintaan
  anda harus menggunakan koma untuk memisahkan beberapa peraturan susunan
  contoh:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Jenis: array string[] | null
  
  tapis sumber mengikut halaman berkaitan
  medan pilihan
  anda boleh menggunakan medan ini untuk mendapatkan sumber daripada halaman yang sepadan dengan parameter yang ditentukan
  anda boleh menggunakan penapis yang sama seperti yang tersedia untuk endpoint pages
  anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
  anda harus menetapkan operator logik and, or antara syarat
  operator berikut disokong:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  anda boleh menggunakan operator % dengan like dan not_like untuk memadankan sebarang rentetan dengan sifar atau lebih aksara
  contoh:
  ["checks.no_image_title","=",true]
- search_after_token
  Jenis: string | null
  
  token untuk permintaan seterusnya
  medan pilihan
  disediakan dalam medan yang sama bagi respons setiap permintaan;
  gunakan parameter ini untuk mengelakkan tamat masa semasa cuba memperoleh lebih daripada 20,000 hasil dalam satu permintaan;
  dengan menetapkan nilai search_after_token unik daripada tatasusunan respons, anda akan mendapat hasil seterusnya bagi tugas asal;
  nilai search_after_token adalah unik bagi setiap tugas seterusnya;
  Nota: jika search_after_token ditetapkan dalam permintaan, semua parameter lain harus sama dengan permintaan sebelumnya
- tag
  Jenis: string | null
  
  pengecam tugas yang ditentukan pengguna
  medan pilihan
  had aksara ialah 255
  anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
  anda akan menemui nilai tag yang ditentukan dalam objek data respons
- url
  Jenis: string | null
  
  URL halaman
  medan pilihan
  tentukan medan ini jika anda ingin mendapatkan sumber untuk halaman tertentu
  ambil perhatian bahawa untuk mendapatkan meta sumber daripada URL tertentu, anda harus menentukan URL dalam medan ini;
  jika anda tidak menentukan url semasa menetapkan tugas, meta sumber dalam hasil akan dipulangkan berdasarkan data daripada halaman tempat perangkak kami pertama kali melihat sumber tersebut

Respons

200
Jenis: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

Laluan URL

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

tatasusunan hasil

crawl_progress
Jenis: string | null

status sesi crawl
nilai yang mungkin: in_progress, finished

crawl_status
Jenis: object | null · Response36Afe1097B20_CrawlStatusInfo

butiran sesi crawl

max_crawl_pages
Jenis: integer | null Format: int64

bilangan maksimum halaman untuk dirayau menunjukkan had max_crawl_pages yang anda tetapkan semasa mencipta tugas

pages_crawled
Jenis: integer | null Format: int64

bilangan halaman yang dirayau

pages_in_queue
Jenis: integer | null Format: int64

bilangan halaman yang sedang berada dalam baris gilir perayauan

current_offset
Jenis: integer | null

Integer numbers.

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

tatasusunan items

cache_control
Jenis: object | null · Response36Afe1097B20_CacheControl

arahan untuk caching

cachable
Jenis: boolean | null

menunjukkan sama ada halaman boleh dicache

ttl
Jenis: integer | null

masa untuk hidup; tempoh pelayar menyimpan sumber dalam cache

checks
Jenis: object | null

semakan laman web; semakan pada halaman berkaitan halaman

propertyName
Jenis: boolean | null
content_encoding
Jenis: string | null

jenis pengekodan

encoded_size
Jenis: integer | null

saiz halaman selepas pengekodan; menunjukkan saiz halaman yang dikodkan, diukur dalam bait

fetch_time
Jenis: string | null

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

last_modified
Jenis: object | null · Response36Afe1097B20_LastModified

mengandungi data tentang perubahan berkaitan sumber; jika tiada data, nilainya ialah null

header
Jenis: string | null

tarikh dan masa pengepala kali terakhir diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" contoh: 2019-11-15 12:57:46 +00:00 jika tiada data, nilainya akan null

meta_tag
Jenis: string | null

tarikh dan masa tag meta kali terakhir diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" contoh: 2019-11-15 12:57:46 +00:00 jika tiada data, nilainya akan null

sitemap
Jenis: string | null

tarikh dan masa peta laman kali terakhir diubah dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00" contoh: 2019-11-15 12:57:46 +00:00 jika tiada data, nilainya akan null

location
Jenis: string | null

pengepala Location; menunjukkan URL untuk mengubah hala halaman

media_type
Jenis: string | null

jenis media yang digunakan untuk memaparkan halaman

resource_errors
Jenis: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

ralat dan amaran sumber

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

ralat sumber

column
Jenis: integer | null

lajur tempat ralat ditemui

line
Jenis: integer | null

baris tempat ralat ditemui

message
Jenis: string | null

mesej teks ralat. Senarai penuh kemungkinan ralat HTML boleh didapati di sini

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini; Nota: kami amat mengesyorkan agar anda mereka bentuk sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan

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

amaran sumber

column
Jenis: integer | null

lajur tempat ralat ditemui

line
Jenis: integer | null

baris tempat ralat ditemui

message
Jenis: string | null

mesej teks ralat. Senarai penuh kemungkinan ralat HTML boleh didapati di sini

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini; Nota: kami amat mengesyorkan agar anda mereka bentuk sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan

resource_type
Jenis: string | null

jenis elemen

server
Jenis: string | null

versi pelayan

size
Jenis: integer | null

saiz sumber; menunjukkan saiz halaman tertentu, diukur dalam bait

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini; Nota: kami amat mengesyorkan agar anda mereka bentuk sistem yang diperlukan untuk mengendalikan keadaan pengecualian atau ralat berkaitan

total_transfer_size
Jenis: integer | null Format: int64

saiz halaman termampat; menunjukkan saiz termampat halaman tertentu

url
Jenis: string | null

URL halaman

items_count
Jenis: integer | null Format: int64

bilangan item dalam tatasusunan hasil

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

jumlah item berkaitan yang di-crawl

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

versi semasa API
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin 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
  }
]'

Tunjukkan 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 berjaya

Sumber OnPage API

PengesahanRequired

DataForSEO

Sumber OnPage API

Rujukan harga