데이터셋 목록 조회 V2

POST api.hashscraper.com/api/get_schedule_results Content-Type: application/json; version=2

특정 스크래퍼에 만들어진 데이터셋 목록을 페이지 단위로 조회합니다.

한 페이지당 20건을 반환하며, 기본 정렬은 데이터셋 생성 시각(created_at) 기준입니다. sr_status로 진행 상태별 필터링이 가능합니다.

특정 데이터셋만 조회하려면 schedule_result_id를 함께 전달하세요. 이 경우 결과는 최대 한 건입니다.

조건에 맞는 데이터셋이 한 건도 없으면 성공 응답이 아닌 에러 응답을 반환합니다.

요청 파라미터

  • api_key: String
    해시스크래퍼 API 키API키 확인하기
    예시 YOUR_API_KEY
  • schedule_id: String
    조회할 스크래퍼의 ID.
    예시 YOUR_SCHEDULE_ID
  • page: optional Integer
    조회할 페이지 번호.
    기본값 1
  • sorting: optional String
    데이터셋 생성 시각 기준 정렬 방향.
    기본값 asc 허용값 asc, desc
  • schedule_result_id: optional Integer
    특정 데이터셋만 조회할 때 전달합니다. 다른 필터와 함께 사용할 수 있습니다.
  • sr_status: optional String
    수집 상태로 결과를 좁힐 때 전달합니다.
    허용값 ready, running, retry, finish, canceling

응답 필드

  • result: String
    요청 처리 결과.
    허용값 success, error
  • version: String
    API 버전.
    예시 v2
  • current_page: Integer
    현재 페이지 번호. 요청 시 전달한 page 값과 동일합니다.
  • total_page: Integer
    필터 적용 후 결과를 기준으로 한 전체 페이지 수.
  • dataset: Array<Object>
    데이터셋 배열.
    • schedule_result_id: Integer
      데이터셋 ID. 다른 API 호출 시 schedule_result_id로 전달합니다.
    • sr_status: String
      수집 진행 상태. 일반적으로 받게 되는 값은 ready(시작 대기), running(수집 중), retry(재시도 중), finish(완료), canceling(취소 진행 중)이며, 일부 legacy 데이터에서는 한국어 라벨이 반환될 수 있습니다.
    • created_at: String (ISO 8601)
      데이터셋 생성 시각 (ISO 8601, Asia/Seoul).
    • data_count: Integer
      이 데이터셋에 쌓인 결과 수. 캐시된 카운터 값으로, 방금 추가된 결과는 잠시 반영되지 않을 수 있습니다.
    • sum_point: Integer
      이 데이터셋 수집에 차감된 누적 크레딧.
    • param_info: Object
      이 데이터셋 수집 시점의 파라미터 스냅샷. 사용으로 지정된 param1~param5만 포함되며, 키 이름에 라벨이 함께 표기됩니다 (예: param1(검색어)). 스크래퍼에 라벨이 설정되지 않았으면 param1() 또는 param1(param1)처럼 라벨 자리가 비거나 placeholder로 남을 수 있습니다.
    • no_result: Boolean | null
      스크래퍼의 "결과 없음" 처리 설정 스냅샷. 스크래퍼 설정이 없거나 파싱이 실패하면 null일 수 있습니다.
    • union: Boolean | null
      스크래퍼의 유니온 결과 사용 여부 스냅샷. 동일하게 null일 수 있습니다.
  • elapsed_time: Float
    응답 생성에 걸린 시간(초 단위 숫자).
    예시 0.0234

에러 응답

  • schedule_id missing
    필수 파라미터 schedule_id가 누락되었습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "`schedule_id` parameter is required"
}
  • Schedule not found
    전달된 schedule_id로 스크래퍼를 찾을 수 없거나 접근 권한이 없습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "schedule(id: YOUR_SCHEDULE_ID) not found"
}
  • Schedule result not found
    전달된 schedule_result_id를 해당 스크래퍼에서 찾을 수 없습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "schedule_result(id: YOUR_SCHEDULE_RESULT_ID) of schedule(id: YOUR_SCHEDULE_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` or `desc`). sorting: ..."
}
  • Invalid sr_status
    sr_status 값이 허용된 5개(ready, running, retry, finish, canceling) 중 하나가 아닙니다.
    {
  "result": "error",
  "version": "v2",
  "message": "올바른 sr_status를 입력해주세요. sr_status: ..."
}
  • No dataset found
    조건에 맞는 데이터셋을 찾지 못한 경우 반환됩니다. 빈 결과가 아닌 에러 응답으로 옵니다.
    {
  "result": "error",
  "version": "v2",
  "message": "조건에 맞는 데이터셋을 찾을 수 없습니다. schedule_id: ... | page: ... | schedule_result_id: ... | sr_status: ..."
}

관련 가이드

요청 예시
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
옵션 파라미터
응답 예시 200 
{
  "result": "success",
  "version": "v2",
  "current_page": 1,
  "total_page": 3,
  "dataset": [
    {
      "schedule_result_id": 13229289,
      "sr_status": "finish",
      "created_at": "2026-04-26T10:32:19.000+09:00",
      "data_count": 152,
      "sum_point": 5,
      "param_info": {
        "param1(검색할 키워드)": "개발자",
        "param2(최대 수집 개수)": "10"
      },
      "no_result": false,
      "union": false
    },
    {
      "schedule_result_id": 13229301,
      "sr_status": "running",
      "created_at": "2026-04-27T09:11:02.000+09:00",
      "data_count": 84,
      "sum_point": 5,
      "param_info": {
        "param1(검색할 키워드)": "백엔드"
      },
      "no_result": false,
      "union": false
    }
  ],
  "elapsed_time": 0.0234
}