데이터셋 결과 조회 V2

• api_key: String
  해시스크래퍼 API 키API키 확인하기

  예시 YOUR_API_KEY
• schedule_result_id: Integer
  조회할 데이터셋의 ID. collect 응답으로 받은 값을 그대로 전달합니다.

  예시 YOUR_SCHEDULE_RESULT_ID
• page: optional Integer
  조회할 페이지 번호. 커서 방식(next_id)과 함께 사용하지 마세요. 동시 전달 시 cursor 필터 적용 후 page가 적용되어 의도치 않은 결과가 나올 수 있습니다.

  기본값 1
• sorting: optional String
  id 기준 정렬 방향.

  기본값 asc 허용값 asc, desc
• next_id: optional Integer
  응답의 max_id 값을 그대로 다음 요청에 전달.
• since: optional String
  지정한 시각(이 시각 포함) 이후에 생성된 데이터를 조회합니다. %Y-%m-%d %H:%M:%S 형식, 한국 시간대 기준.

  예시 2026-04-27 00:00:00

• result: String
  요청 처리 결과.

  허용값 success, error
• version: String
  API 버전.

  예시 v2
• data_count: Integer
  이 응답에 포함된 항목 수.
• current_page: Integer
  현재 페이지 번호. 요청 시 전달한 page 값과 동일합니다.
• total_page: Integer
  전체 페이지 수. next_id·since 필터가 적용된 경우 필터 후 결과 기준이며, 전체 데이터셋 기준이 아닙니다.
• min_id: Integer
  응답 항목 중 최소 id 값.
• max_id: Integer
  응답 항목 중 최대 id 값. 다음 페이지 조회 시 next_id로 전달하세요.
• data: Array<Object>
  수집 결과 배열.

  • id: Integer
    결과 레코드의 고유 ID.
  • created_at: String (ISO 8601)
    수집 시각 (ISO 8601, Asia/Seoul).
  • updated_at: String (ISO 8601)
    최종 갱신 시각 (ISO 8601, Asia/Seoul). 수집 결과는 보통 수정되지 않아 created_at과 동일합니다.
  • <dynamic fields>: Any
    스크래퍼마다 다른 동적 필드. 키 이름은 해당 스크래퍼의 결과 컬럼 설정에 따라 결정됩니다.
• elapsed_time: Float
  응답 생성에 걸린 시간(초 단위 숫자).

  예시 0.0234

에러 응답

• schedule_result_id missing
  필수 파라미터 schedule_result_id가 누락되었습니다.

  {
    "result": "error",
    "version": "v2",
    "message": "`schedule_result_id` parameter is required"
  }

• Schedule result not found
  전달된 schedule_result_id로 데이터셋을 찾을 수 없거나 접근 권한이 없습니다.

  {
    "result": "error",
    "version": "v2",
    "message": "schedule_result(id: YOUR_SCHEDULE_RESULT_ID) not found"
  }

• Invalid page
  page 값이 정수 형식이 아닙니다.

  {
    "result": "error",
    "version": "v2",
    "message": "올바른 page 값을 넣어주세요. page: ..."
  }

• Invalid sorting
  sorting 값이 asc 또는 desc가 아닙니다.

  {
    "result": "error",
    "version": "v2",
    "message": "올바른 sorting 값을 입력해주세요.(asc, desc) sorting: ..."
  }

• Invalid next_id
  next_id 값이 정수 형식이 아닙니다.

  {
    "result": "error",
    "version": "v2",
    "message": "정수 타입의 next_id 값을 입력해주세요. next_id: ..."
  }

• Invalid since
  since 값의 포맷이 올바르지 않거나 파싱할 수 없습니다.

  {
    "result": "error",
    "version": "v2",
    "message": "since 형식이 잘못되었습니다. since: ..."
  }

관련 가이드

• 수집
• 수집 상태
• 데이터셋
• 데이터 V3
• 봇 데이터 전체 V2
• 봇 데이터 전체 V3