데이터셋 결과 조회 V3

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

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

  예시 YOUR_SCHEDULE_RESULT_ID
• 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 버전.

  예시 v3
• total_data_count: Integer
  이 데이터셋의 전체 결과 수. 캐시된 카운터 값으로, 방금 추가된 결과는 잠시 반영되지 않을 수 있습니다.
• data_count: Integer
  이 응답에 포함된 항목 수.
• 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: String
  응답 생성에 걸린 시간(초 단위 문자열).

  예시 0.0178s

에러 응답

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

  {
    "result": "error",
    "version": "v3",
    "message": "Required parameters(schedule_result_id) not found"
  }

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

  {
    "result": "error",
    "version": "v3",
    "message": "ScheduleResult(id: YOUR_SCHEDULE_RESULT_ID) not found"
  }

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

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `sorting` parameter: ..."
  }

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

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `next_id` parameter: ..."
  }

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

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `since` parameter: ..."
  }

관련 가이드

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