봇 데이터 전체 조회 V3
특정 스크래퍼에서 수집된 모든 데이터를 페이지 단위로 조회합니다.
한 번에 최대 100건을 반환하며, 응답의 next_cursor 값을 다음 요청의 next_id로 전달해 다음 페이지를 이어서 조회합니다.
반환되는 컬럼은 스크래퍼마다 다르며, 해당 스크래퍼의 결과 컬럼 설정에 따라 결정됩니다.
since 파라미터로 특정 시점 이후의 데이터만 조회할 수 있으며, 모든 타임스탬프는 한국 시간대(Asia/Seoul) 기준입니다.
요청 파라미터
-
api_key: String해시스크래퍼 API 키API키 확인하기
-
schedule_id: String조회 대상 스크래퍼의 ID.
-
sorting: optional String수집 시각 기준 정렬 방향.
-
next_id: optional Integer응답의
next_cursor값을 그대로 다음 요청에 전달. -
since: optional String지정한 시각(이 시각 포함) 이후에 생성된 데이터를 조회합니다.
%Y-%m-%d %H:%M:%S형식, 한국 시간대 기준.
응답 필드
-
result: String요청 처리 결과.
-
version: StringAPI 버전.
-
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응답 생성에 걸린 시간(초 단위 문자열).
에러 응답
-
schedule_id missing
{ "result": "error", "version": "v3", "message": "Required parameters(schedule_id) not found" } -
Schedule not found
{ "result": "error", "version": "v3", "message": "Schedule(id: YOUR_SCHEDULE_ID) not found" } -
Invalid sorting
{ "result": "error", "version": "v3", "message": "Invalid sorting parameter: ..." } -
Invalid since
{ "result": "error", "version": "v3", "message": "Invalid since parameter: ..." }
관련 가이드
요청 예시
옵션 파라미터
응답 예시 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"
}