Felo API PlatformFelo API Platform
DataForSEO 전체 엔드포인트
v0.2.0-beta
OpenAPI 3.1.0

OnPage API 워터폴

서버:https://openapi.felo.ai
클라이언트 라이브러리

DataForSEO

​

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

OnPage API 워터폴

​

크롤링된 하나의 url에 대한 로드 타임라인으로, 무엇을 어떤 순서로 요청했고 각각 얼마나 걸렸는지 보여줍니다. 완료된 크롤링을 읽으므로 post_dataforseo_on_page_submit에서 받은 id가 필요하며, crawl_progress와 max_crawl_pages, pages_in_queue, pages_crawled 값을 담은 crawl_status를 반환합니다. 결과가 적을 때는 이 값을 먼저 확인하세요. 아직 실행 중인 크롤링은 보고할 내용이 적을 뿐입니다. 느린 페이지를 설명할 때 사용하고, 점수가 매겨진 성능 감사가 필요하면 post_dataforseo_on_page_lighthouse_live_json을 사용하세요. 💰 업스트림 무료: 완료된 크롤링 조회에는 비용이 들지 않으며, 크롤링 자체에만 비용이 발생합니다.

가격 참고

  • 과금 기준: 응답에 보고된 비용.
  • 참고 요청 추정치: USD 0.012.
  • 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

본문
application/json
  • 유형: array (object | null)[]
    • id
      유형: string

      작업 ID
      필수 필드
      이 ID는 Task POST 엔드포인트의 응답에서 얻을 수 있습니다
      예:
      "07131248-1535-0216-1000-17384017ad04"

    • tag
      유형: string | null

      사용자 정의 작업 식별자
      선택 필드
      최대 255자
      이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
      tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다

    • url
      유형: string

      페이지 URL
      필수 필드
      타이밍을 받을 페이지를 지정합니다

응답
  • 200
    유형: object | null · Response36Afe1097B20_OnPageWaterfallResponseInfo
    • cost
      유형: number | null 형식: double

      전체 작업 비용, USD

    • status_code
      유형: integer | null

      일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

    • status_message
      유형: string | null

      일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

    • tasks
      유형: array (object | null)[] | null

      작업 배열

      • 유형: object | null · Response36Afe1097B20_OnPageWaterfallTaskInfo
        • 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

              현재 크롤링 대기열에 있는 페이지 수

          • items
            유형: array (object | null)[] | null

            항목 배열

            • connection_time
              유형: integer | null

              서버 연결 시간
              서버와의 연결이 설정될 때까지 걸리는 시간(밀리초)

            • dom_complete
              유형: integer | null

              리소스 로드 시간
              페이지와 모든 하위 리소스가 다운로드될 때까지 걸리는 시간(밀리초)

            • download_time
              유형: integer | null

              브라우저가 응답을 받는 데 걸리는 시간(밀리초)

            • duration_time
              유형: integer | null

              브라우저가 서버로부터 완전한 응답을 받을 때까지 걸리는 총 시간(밀리초)

            • fetch_end
              유형: integer | null

              HTML 리소스 다운로드 완료 시간
              브라우저가 페이지 다운로드를 완료하는 데 필요한 시간

            • fetch_start
              유형: integer | null

              HTML 리소스 다운로드 시작 시간
              브라우저가 페이지 다운로드를 시작하는 데 필요한 시간

            • page_url
              유형: string | null

              페이지 URL

            • request_sent_time
              유형: integer | null

              서버로 요청을 보내는 시간
              서버로의 요청이 전송될 때까지 걸리는 시간(밀리초)

            • resources
              유형: array (object | null)[] | null

              리소스별 타이밍
              페이지에서 발견된 각 리소스의 타이밍을 담은 별도 배열을 포함합니다

              • duration_time
                유형: integer | null

                브라우저가 서버로부터 완전한 응답을 받을 때까지 걸리는 총 시간(밀리초)

              • fetch_end
                유형: integer | null

                HTML 리소스 다운로드 완료 시간
                브라우저가 페이지 다운로드를 완료하는 데 필요한 시간

              • fetch_start
                유형: integer | null

                HTML 리소스 다운로드 시작 시간
                브라우저가 페이지 다운로드를 시작하는 데 필요한 시간

              • initiator
                유형: string | null

                리소스 시작자

              • is_render_blocking
                유형: boolean | null

                리소스가 렌더링을 차단하는지 나타냅니다

              • location
                유형: object | null · Response36Afe1097B20_OnPageResourceLocationInfo

                문서에서 리소스의 위치
                문서 HTML 내에서 특정 리소스의 위치를 정의하는 매개변수

                • line
                  유형: integer | null

                  줄 번호
                  리소스가 위치한 줄 번호

                • offset_left
                  유형: integer | null

                  줄 내 위치
                  리소스 앞의 줄 문자 수;
                  때때로 열이라고도 합니다
                  참고: 1부터 계산하므로 리소스 왼쪽에 문자가 없으면 값은 1입니다

                • offset_top
                  유형: integer | null

                  문서 내 위치
                  리소스와 HTML 문서 시작 사이의 총 문자 수

              • resource_type
                유형: string | null
              • url
                유형: string | null

                리소스 URL

            • time_to_interactive
              유형: integer | null

              TTI(Time To Interactive) 지표
              사용자가 페이지와 상호작용할 수 있을 때까지 걸리는 시간(밀리초)

            • time_to_secure_connection
              유형: integer | null

              보안 연결 설정 시간
              서버와의 보안 연결이 설정될 때까지 걸리는 시간(밀리초)

            • waiting_time
              유형: integer | null

              첫 바이트까지의 시간 (TTFB)(밀리초)

          • 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
Request Example for post/v1/beta/dataforseo/on_page/waterfall
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/waterfall \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "08101204-0696-0216-0000-644a7b21a48a",
    "url": "https://dataforseo.com/tag/broken-links"
  }
]'
{
  "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
          },
          "items_count": null,
          "items": [
            {
              "page_url": null,
              "time_to_interactive": null,
              "dom_complete": null,
              "connection_time": null,
              "time_to_secure_connection": null,
              "request_sent_time": null,
              "waiting_time": null,
              "download_time": null,
              "duration_time": null,
              "fetch_start": null,
              "fetch_end": null,
              "resources": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}
OnPage API Waterfall

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.