데이터셋 데이터 조회 V4

• Authorization: Header
  해시스크래퍼 API 키. Bearer <api_key> 형식으로 전달합니다.

  예시 Bearer YOUR_API_KEY
• schedule_result_id: Integer (path)
  조회할 데이터셋 ID. 수집 응답의 schedule_result_id를 그대로 전달합니다.

  예시 239758028
• sorting: optional String
  결과 ID 기준 정렬 방향. 페이지네이션 도중에 변경하지 마세요. cursor의 적용 방향이 함께 뒤집힙니다.

  기본값 asc 허용값 asc, desc
• cursor: optional Integer
  응답의 next_cursor 값을 그대로 다음 요청에 전달. 현재 sorting 방향에 맞춰 적용됩니다(asc면 id > cursor, desc면 id < cursor).
• since: optional String
  지정한 시각(이 시각 포함) 이후에 생성된 결과만 조회합니다. %Y-%m-%d %H:%M:%S 형식, 한국 시간대 기준.

  예시 2026-05-06 00:00:00
• limit: optional Integer
  한 페이지당 최대 결과 수.

  기본값 100 허용값 1 ~ 1000

• result: String
  요청 처리 결과.

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

  예시 v4
• request_id: String
  요청 추적용 ID.

  예시 req_5a8c1f1c-...
• elapsed_sec: Float
  응답 생성에 걸린 시간(초 단위 Float).

  예시 0.0178
• count: Integer
  이 응답에 포함된 결과 수.
• next_cursor: Integer | null
  다음 페이지 조회 시 cursor로 전달할 값. null이면 마지막 페이지입니다.
• 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
    크롤링 봇마다 다른 동적 필드. 키 이름은 해당 크롤링 봇의 결과 컬럼 설정에 따라 결정됩니다. 값이 null일 수 있으며(워커가 채우지 못한 컬럼), 시간 컬럼의 표기는 워커별로 다르며 top-level created_at처럼 ISO 8601(+09:00 TZ)을 보장하지 않습니다(예: "2026-05-21 10:34:12").

에러 응답

• MISSING_API_KEY
  Authorization 헤더가 없거나 형식이 올바르지 않습니다. Authorization: Bearer <api_key> 형태로 전달하세요. (HTTP 401)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "MISSING_API_KEY",
    "message": "API key is missing.",
    "elapsed_sec": 0.0008,
    "details": { "hint": "Send `Authorization: Bearer <api_key>` header." }
  }

• INVALID_API_KEY
  전달된 API 키와 일치하는 사용자가 없습니다. (HTTP 401)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "INVALID_API_KEY",
    "message": "API key is invalid.",
    "elapsed_sec": 0.0011
  }

• SCHEDULE_RESULT_NOT_FOUND
  전달된 ID로 데이터셋을 찾을 수 없거나 접근 권한이 없습니다. (HTTP 404)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "SCHEDULE_RESULT_NOT_FOUND",
    "message": "ScheduleResult not found.",
    "elapsed_sec": 0.0021,
    "details": { "resource": "schedule_result", "id": "999999" }
  }

• INVALID_PARAM (sorting)
  sorting 값이 asc 또는 desc가 아닙니다. (HTTP 400)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "INVALID_PARAM",
    "message": "Invalid sorting parameter.",
    "elapsed_sec": 0.0014,
    "details": { "param_name": "sorting", "allowed": ["asc","desc"] }
  }

• INVALID_PARAM (since)
  since 값의 포맷이 올바르지 않거나 파싱할 수 없습니다. (HTTP 400)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "INVALID_PARAM",
    "message": "Invalid since parameter.",
    "elapsed_sec": 0.0014,
    "details": { "param_name": "since", "value": "not-a-date" }
  }

관련 가이드

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