v0.2.0-beta

OpenAPI 3.1.0

OnPage API リソース

Felo API Support

MIT

サーバー

https://openapi.felo.ai

クライアントライブラリ

Shell Curl

DataForSEO

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

DataForSEO 操作

post/v1/beta/dataforseo/on_page/resources

OnPage API リソース

クロールで見つかったページ以外のアセット（画像、スクリプト、スタイルシート）と、そのステータスコードおよびサイズです。ページは search_after_token でページングします。完了したクロールを読み取るため、post_dataforseo_on_page_submit が返す id が必要です。crawl_progress と、max_crawl_pages・pages_in_queue・pages_crawled を含む crawl_status を返します。少ない結果を信じる前にこれらを確認してください。実行中のクロールは報告できる内容が少ないだけです。クローラーがまったく到達できなかったアセットについては post_dataforseo_on_page_uncrawlable_resources を使用してください。💰 アップストリームは無料：完了したクロールの照会には費用がかからず、費用がかかるのはクロール自体だけです。

料金の参考情報

計測方法：報告されたレスポンスコスト。
参考リクエスト見積もり：0.012 USD。
参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。

参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

リクエストボディ

application/json

型: array (object | null)[]
- filters
  型: array (object | null)[] | null
  
  結果フィルターパラメーターの配列
  任意フィールド
  複数のフィルターを同時に追加できます（最大 8 個）
  条件の間には論理演算子 and、or を設定してください
  次の演算子がサポートされています：
  regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like
  like と not_like で % 演算子を使用すると、0 文字以上の任意の文字列に一致させられます
  例：
  ["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]]]
  
  利用可能なフィルターの完全なリストはこのリンクから確認できます。
  
  空のオブジェクト
- id
  型: string
  
  タスクの ID
  必須フィールド
  この ID は、Task POST エンドポイントのレスポンスで取得できます
  例：
  "07131248-1535-0216-1000-17384017ad04"
- limit
  型: integer | null
  
  返されるリソースの最大数
  任意フィールド
  デフォルト値：100
  最大値：1000
- offset
  型: integer | null
  
  返されるリソースの結果配列内のオフセット
  任意フィールド
  デフォルト値：0
  最大値：2000000
  10 を指定すると、結果配列の最初の 10 リソースが省略され、後続のリソースのデータが返されます
- order_by
  型: array string[] | null
  
  結果の並び替えルール
  任意フィールド
  filters 配列と同じ値を使用して結果を並び替えられます
  指定可能な並び替えの種類：
  asc - 結果を昇順で並び替えます
  desc - 結果を降順で並び替えます
  並び替えの種類はカンマで設定します
  例：
  ["size,desc"]
  1 回のリクエストで設定できる並び替えルールは 3 つまでです
  複数の並び替えルールはカンマで区切ります
  例：
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  型: array string[] | null
  
  関連するページでリソースを絞り込む
  任意フィールド
  このフィールドを使用すると、定義したパラメーターに一致するページからリソースを取得できます
  ここでは、Pages エンドポイントで使用できるものと同じフィルターを適用できます
  複数のフィルターを同時に追加できます（最大 8 個）
  条件の間には論理演算子 and、or を設定してください
  次の演算子がサポートされています：
  regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like
  like と not_like で % 演算子を使用すると、0 文字以上の任意の文字列に一致させられます
  例：
  ["checks.no_image_title","=",true]
- search_after_token
  型: string | null
  
  後続のリクエスト用トークン
  任意フィールド
  各リクエストのレスポンスの対応するフィールドで提供されます
  このパラメータを使用すると、1 回のリクエストで 20,000 件を超える結果を取得する際のタイムアウトを回避できます
  レスポンス配列内の一意の search_after_token 値を指定すると、最初のタスクの後続の結果を取得できます
  search_after_token の値は後続のタスクごとに一意です
  注意: リクエストで search_after_token を指定する場合、他のすべてのパラメータは前のリクエストと同一である必要があります
- tag
  型: string | null
  
  ユーザー定義のタスク識別子
  任意フィールド
  文字数上限は 255 です
  このパラメーターを使ってタスクを識別し、結果と照合できます
  指定した tag の値は、レスポンスの data オブジェクトに含まれます
- url
  型: string | null
  
  ページ URL
  任意フィールド
  特定のページのリソースを取得する場合は、このフィールドを指定します
  特定の URL からリソースの meta を取得するには、このフィールドでその URL を指定する必要があることに注意してください；
  タスクの設定時に url を指定しない場合、結果内のリソースの meta は、クローラーが最初にそのリソースを検出したページのデータに基づいて返されます

レスポンス

200
型: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
cost
型: number | null 形式: double

タスクの総コスト（USD）

status_code
型: integer | null

一般的なステータスコードレスポンスコードの完全な一覧はこちらです

status_message
型: string | null

一般的な情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

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

タスクの配列

型: object | null · Response36Afe1097B20_OnPageResourcesTaskInfo
cost
型: number | null 形式: double

タスクの総コスト（USD）

data
型: object | null

POST リクエストで指定したものと同じパラメーターを含みます

propertyName
型: object | null
id
型: string | null

タスク識別子当社システム内で UUID 形式の一意のタスク識別子

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

URL パス

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

結果の配列

crawl_progress
型: string | null

クロールセッションのステータス
可能な値：in_progress、finished

crawl_status
型: object | null · Response36Afe1097B20_CrawlStatusInfo

クロールセッションの詳細

max_crawl_pages
型: integer | null 形式: int64

クロールするページ数の上限タスク設定時に指定した max_crawl_pages の制限を示します

pages_crawled
型: integer | null 形式: int64

クロール済みのページ数

pages_in_queue
型: integer | null 形式: int64

現在クロールキューにあるページ数

current_offset
型: integer | null

Integer numbers.

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

項目の配列

cache_control
型: object | null · Response36Afe1097B20_CacheControl

キャッシュに関する説明

cachable
型: boolean | null

ページがキャッシュ可能かどうかを示します

ttl
型: integer | null

存続時間。ブラウザがリソースをキャッシュする時間の長さ

checks
型: object | null

ウェブサイトチェック：ページに関連するページ内チェック項目

propertyName
型: boolean | null
content_encoding
型: string | null

エンコードの種類

encoded_size
型: integer | null

エンコード後のページサイズ。エンコードされたページのサイズをバイト単位で示します

fetch_time
型: string | null

リソースを取得した日時。UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”、例: 2019-11-15 12:57:46 +00:00

last_modified
型: object | null · Response36Afe1097B20_LastModified

リソースに関連する変更に関するデータが含まれます。データがない場合、値は null になります

header
型: string | null

ヘッダーが最後に変更された日時 UTC 形式：「yyyy-mm-dd hh-mm-ss +00:00」例： 2019-11-15 12:57:46 +00:00 データがない場合、値は null になります

meta_tag
型: string | null

meta タグが最後に変更された日時 UTC 形式：「yyyy-mm-dd hh-mm-ss +00:00」例： 2019-11-15 12:57:46 +00:00 データがない場合、値は null になります

sitemap
型: string | null

サイトマップが最後に変更された日時 UTC 形式：「yyyy-mm-dd hh-mm-ss +00:00」例： 2019-11-15 12:57:46 +00:00 データがない場合、値は null になります

location
型: string | null

Location ヘッダー。ページのリダイレクト先 URL を示します

media_type
型: string | null

ページの表示に使用されるメディアの種類

resource_errors
型: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

リソースのエラーと警告

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

リソースのエラー

column
型: integer | null

エラーが見つかった列

line
型: integer | null

エラーが見つかった行

message
型: string | null

エラーのテキストメッセージ：HTML エラーの完全なリストはこちらで確認できます

status_code
型: integer | null

一般的なステータスコード。レスポンスコードの完全な一覧はこちらです。注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します

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

リソースの警告

column
型: integer | null

エラーが見つかった列

line
型: integer | null

エラーが見つかった行

message
型: string | null

エラーのテキストメッセージ：HTML エラーの完全なリストはこちらで確認できます

status_code
型: integer | null

一般的なステータスコード。レスポンスコードの完全な一覧はこちらです。注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します

resource_type
型: string | null

要素の種類

server
型: string | null

サーバーのバージョン

size
型: integer | null

リソースサイズ。指定したページのサイズをバイト単位で示します

status_code
型: integer | null

一般的なステータスコード。レスポンスコードの完全な一覧はこちらです。注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します

total_transfer_size
型: integer | null 形式: int64

圧縮後のページサイズ。指定したページの圧縮後サイズを示します

url
型: string | null

ページ URL

items_count
型: integer | null 形式: int64

結果配列内の項目数

search_after_token
型: string | null
total_items_count
型: integer | null 形式: int64

クロールされた関連項目の総数

result_count
型: integer | null 形式: int64

result 配列内の要素数

status_code
型: integer | null

タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです

status_message
型: string | null

タスクの情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

time
型: string | null

実行時間（秒）

tasks_count
型: integer | null 形式: int64

tasks 配列内のタスク数

tasks_error
型: integer | null 形式: int64

エラーで返された tasks 配列内のタスク数

time
型: string | null

合計実行時間（秒）

version
型: string | null

API の現在のバージョン
application/json
400

リクエストを処理できませんでした。リクエストパラメータを確認してください。
401

有効な Felo API キーが必要です。
402

請求要件が満たされていないため、リクエストを続行できません。
403

このアカウントにはこの操作を行う権限がありません。
429

リクエストまたは支出の上限に達しました。
502

サービスがリクエストを完了できませんでした。
503

API または請求サービスが一時的に利用できません。
504

リクエストの処理中にサービスがタイムアウトしました。
default

エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

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
  }
]'

スキーマを表示

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

操作成功

ヘルプが必要ですか？

API・請求・アカウントのご質問はサポートへ。
Discord で Felo の開発者と交流できます。
更新履歴をご覧ください。
ボリューム価格や購買についてのご相談は営業窓口へ。
LLM での構築をお考えですか？llms.txt をご覧ください。

OnPage API リソース

認証Required

DataForSEO

OnPage API リソース

料金の参考情報

ヘルプが必要ですか？