봇 데이터 전체 조회 V3

POST api.hashscraper.com/api/get_results_of_schedule Content-Type: application/json; version=3

특정 스크래퍼에서 수집된 모든 데이터를 페이지 단위로 조회합니다.

한 번에 최대 100건을 반환하며, 응답의 next_cursor 값을 다음 요청의 next_id로 전달해 다음 페이지를 이어서 조회합니다.

반환되는 컬럼은 스크래퍼마다 다르며, 해당 스크래퍼의 결과 컬럼 설정에 따라 결정됩니다.

since 파라미터로 특정 시점 이후의 데이터만 조회할 수 있으며, 모든 타임스탬프는 한국 시간대(Asia/Seoul) 기준입니다.

요청 파라미터

  • api_key: String
    해시스크래퍼 API 키API키 확인하기
    예시 YOUR_API_KEY
  • schedule_id: String
    조회 대상 스크래퍼의 ID.
    예시 YOUR_SCHEDULE_ID
  • sorting: optional String
    수집 시각 기준 정렬 방향.
    기본값 asc 허용값 asc, desc
  • next_id: optional Integer
    응답의 next_cursor 값을 그대로 다음 요청에 전달.
  • since: optional String
    지정한 시각(이 시각 포함) 이후에 생성된 데이터를 조회합니다. %Y-%m-%d %H:%M:%S 형식, 한국 시간대 기준.
    예시 2026-04-24 00:00:00

응답 필드

  • result: String
    요청 처리 결과.
    허용값 success, error
  • version: String
    API 버전.
    예시 v3
  • data_count: Integer
    이 응답에 포함된 항목 수.
  • min_id: Integer
    응답 항목 중 최소 id 값. 통계 용도이며 페이지네이션에는 사용하지 마세요.
  • max_id: Integer
    응답 항목 중 최대 id 값. 통계 용도이며 페이지네이션에는 사용하지 마세요.
  • next_cursor: Integer | null
    다음 페이지 조회 시 next_id로 전달할 값. null이면 마지막 페이지입니다.
  • data: Array<Object>
    수집 결과 배열.
    • id: Integer
      결과 레코드의 고유 ID.
    • schedule_result_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_id missing
    필수 파라미터 schedule_id가 누락되었습니다.
    {
      "result": "error",
      "version": "v3",
      "message": "Required parameters(schedule_id) not found"
    }
  • Schedule not found
    전달된 schedule_id로 스크래퍼를 찾을 수 없거나 접근 권한이 없습니다.
    {
      "result": "error",
      "version": "v3",
      "message": "Schedule(id: YOUR_SCHEDULE_ID) not found"
    }
  • Invalid sorting
    sorting 값이 asc 또는 desc가 아닙니다.
    {
      "result": "error",
      "version": "v3",
      "message": "Invalid sorting parameter: ..."
    }
  • Invalid since
    since 값의 포맷이 올바르지 않거나 파싱할 수 없습니다.
    {
      "result": "error",
      "version": "v3",
      "message": "Invalid since parameter: ..."
    }

관련 가이드

요청 예시
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
옵션 파라미터
응답 예시 200
{
  "result": "success",
  "version": "v3",
  "data_count": 3,
  "min_id": 26283699,
  "max_id": 26284152,
  "next_cursor": 26284152,
  "data": [
    {
      "id": 26283699,
      "schedule_result_id": 16115,
      "created_at": "2023-10-18T16:20:19.000+09:00",
      "updated_at": "2023-10-18T16:20:19.000+09:00",
      "제목": "함께할 개발자 모집 (C#)",
      "회사명": "에딤스 주식회사",
      "회사 주소": "부산 사상구",
      "경력": "신입·경력",
      "학력": "초대졸↑",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    },
    {
      "id": 26283700,
      "schedule_result_id": 16115,
      "created_at": "2023-10-18T16:20:19.000+09:00",
      "updated_at": "2023-10-18T16:20:19.000+09:00",
      "제목": "백엔드 개발자",
      "회사명": "(주)텍스트웨이",
      "회사 주소": "서울전체",
      "경력": "경력 3~7년",
      "학력": "학력무관",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    },
    {
      "id": 26284152,
      "schedule_result_id": 16115,
      "created_at": "2023-10-18T16:52:49.000+09:00",
      "updated_at": "2023-10-18T16:52:49.000+09:00",
      "제목": "함께할 개발자 모집 (C#)",
      "회사명": "에딤스 주식회사",
      "회사 주소": "부산 사상구",
      "경력": "신입·경력",
      "학력": "초대졸↑",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    }
  ],
  "elapsed_time": "0.0178s"
}